Attention: This site does not support the current version of your web browser. To get the best possible experience using our website we recommend that you upgrade to a newer version or install another browser



The Persons resource provides the interface to create a person, including the name, gender or facts of the person.

Data Formats


If you make a GET request, specify the desired data format using the Accept header.


If you POST something, specify the data format using the Content-Type header.


Name Type Description
Authorization header The authorization carrying the OAuth 2.0 access token. See OAuth 2.0 Bearer Tokens.
X-Reason header Header giving the reason for creating a person.
access_token query The ID of the OAuth 2 access token used for identification and authorization of the user (and agent) making the request.
pids query A comma separated list of person ids.


GET - Read a list of persons. Invalid ids will be returned in Warning headers. The maximum number of ids to read is currently 500, but is subject to change.

Status Codes
200 Upon a successful read.
301 If a requested person has been merged into another person.
400 If the request was unable to be understood by the application.
404 If a requested person is not found.
410 If a requested person has been deleted.
429 If the request was throttled.

POST - Create a person.

Status Codes
201 The creation of the person was successful. Expect a location header specifying the link to the created person.
429 If the request was throttled.

Example Requests

Create Person How to create a person.
Read Persons How to read multiple persons.

Select a language