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

Skip main navigation

Persons

Description

The Persons resource provides the interface to create a person (including the name, gender and facts of the person) and get a list of persons.

Operations

GET - Read a list of persons. Invalid ids will be returned in Warning headers. The maximum number of persons that can be read is 200.

Produces - Specify a returned data format using the Accept header.
Parameters
Name Type Description
pids query A comma separated list of no more than 200 person ids. Required.
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.

Produces - Specify a returned data format using the Accept header.
Consumes - Specify the incoming data format using the Content-Type header.
Parameters
Name Type Description
X-Reason header The optional reason for creating the person.
body request-body The person to be created.
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.
Change Language
Feedback

Sending...

Feedback was sent.

Can't send feedback. Retry in 5 seconds.