API Doc

API Methods

auth.getMobileSession

Create a web service session for a user. Used for authenticating a user when the password can be inputted by the user. Only suitable for standalone mobile devices. See the authentication how-to for more.

Params

username (Required) : The last.fm username.
authToken (Required) : A 32-byte ASCII hexadecimal MD5 hash of the last.fm username and the user's password hash. i.e. md5(username + md5(password)), where '+' represents a concatenation.
api_key (Required) : A Last.fm API key.
api_sig (Required) : A Last.fm method signature. See authentication for more information.

Auth

This service does not require authentication.

Sample Response

<lfm status="ok">
	<session>
		<name>MyLastFMUsername</name>
		<key>d580d57f32848f5dcf574d1ce18d78b2</key>
		<subscriber>0</subscriber>
	</session>
</lfm>

Errors

  • 4 : Invalid authentication token. Please check username/password supplied
  • 2 : Invalid service -This service does not exist
  • 3 : Invalid Method - No method with that name in this package
  • 4 : Authentication Failed - You do not have permissions to access the service
  • 5 : Invalid format - This service doesn't exist in that format
  • 6 : Invalid parameters - Your request is missing a required parameter
  • 7 : Invalid resource specified
  • 9 : Invalid session key - Please re-authenticate
  • 10 : Invalid API key - You must be granted a valid key by last.fm
  • 11 : Service Offline - This service is temporarily offline. Try again later.
  • 12 : Subscription Error - The user needs to be subscribed in order to do that
  • 13 : Invalid method signature supplied
  • 18 : This user has no free radio plays left. Subscription required.