Person.GetLists

Summary

Returns the lists that a user has filled out.

Signatures

Web Service Method Signature: ListPagedResults GetLists(string apiKey, string site, string slug, int pageSize, int pageNumber)
REST Signature: /rest/person/{slug}/lists?apiKey={apiKey}&site={site}&pageSize={pageSize}&pageNumber={pageNumber}

Return Value

The lists that the user has filled out.

Arguments

apiKey

Your API key. For more information see here.

site

The site the API should be executed against, e.g. www.ditto.net.

slug

The slug of the user to retrieve the filled out lists for.

pageSize (Optional)

The size of the page of data to return.

If this argument is omitted, it defaults to 10.

The minimum allowed value is 1 and the maximum is 50.

pageNumber (Optional)

The page number of the results to return.

If this argument is omitted or set to less than 1, it defaults to 1.

REST Example

http://api.ditto.net/rest/person/Mike/lists?apiKey=xxxx&site=www.ditto.net&pageSize=3

Response Example

<ListPagedResults xmlns="http://www.ditto.net" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
	<PageNumber>1</PageNumber>
	<PageSize>10</PageSize>
	<Results>
		<List>
			<Category>Movies</Category>
			<CreateDate>2007-11-11T00:00:00</CreateDate>
			<DittoUrl>http://www.ditto.net/Lists/AllTimeMovies</DittoUrl>
			<Id>2</Id>
			<OwnerPersonId>10</OwnerPersonId>
			<Slug>AllTimeMovies</Slug>
			<Title>All-Time Favourite Movies</Title>
		</List>
	</Results>
	<TotalResultCount>1</TotalResultCount>
</ListPagedResults>