+44 20 881 67284

34,531,341 Royalty Free Stock Photos

How to use the Fotolia API

Method: user/subaccount/getPurchasedContents

Get the list of all contents purchased by a given subaccount. returns an array

Authentication

This method does not require authentication.

HTTP method

This method is called with HTTP method GET.

Arguments

Argument Type Valid Values Default Value Detail
subaccount_id int Valid Values required sub account ID to get
page int Valid Values 1 page number to fetch
nb_per_page int Valid Values 10 number of items per page

Returned Values

Element (path) Name Type Description
/ nb_results string
/ nb_page_result string
/ results array
/results/[n] url string download url of the content
/results/[n] content_id int Content id
/results/[n] state int State of the download (0 = not downloaded yet, 1 = downloaded, 2 = cancelled')
/results/[n] creation string Purchase date (format: YYYY-MM-DD HH:II:SS)
/results/[n] expire string expiration date of the download link (format:YYYY-MM-DD HH:II:SS)
/results/[n] downloaded string Date of download if downloaded (format:YYYY-MM-DD HH:II:SS)
/results/[n] price string Price of the content for the license and size chosen
/results/[n] license string License Code (XS, S, M ....)

Example Query

GET http://API_KEY@api.fotolia.com/Rest/1/user/subaccount/getPurchasedContents?subaccount_id=200701446

Example Response

{
	"nb_result":"1",
	"nb_page_result":1,
	"results":[
		{
			"url":"http:\/\/download.fotolia.com\/DownloadContent\/1\/g1Ut2WTt7srEpGv2tMogWlZU0X09tXIP",
			"content_id":5834887,
			"state":1,
			"creation":"2008-05-01 16:45:12.702733",
			"expire":"2008-05-04 16:45:12.702733",
			"downloaded":"2008-05-01 16:45:13.017882",
			"price":1,
			"license":"XS"
		}
	]
}

Error Codes

001: Service currently unavailable
The requested service is temporarily unavailable.
002: Failed to parse request
The request could not be parsed.
010: Missing API Key
The API key passed is missing.
011: Invalid API Key
The API key passed is not valid or has expired.
031: Invalid Method
This method does not exist in the method list.
032: Method not Available
This method is not available for this API Key.
7002: Unknown Subbaccount ID
This Subbaccount has already been deleted, or is not your list of subaccounts.