Agent (TXT)

Retrieve one agent by its numerical identifier. The result is plain text.

GET /(int: id).txt

Query Parameters:  

• id – an integer > 0 and ≤ the world population

Request Headers:  

• Authorization – optional OAuth token to authenticate

Status Codes:

• 200 OK – no error
• 404 Not Found – there’s no agent with that id

Try it:

In this example, get agent number 6352373083.

http://pplapi.com/6352373083.txt

Example request:

GET /6352373083.txt HTTP/1.1
Host: pplapi.com

Example response:

HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
Content-Length: 289

Agent #6,352,373,083 is a 34 year old Male
who currently lives in Canada. This agent
was born 1981-10-25, speaks French, and has
Internet access. The agent's religion is
Catholic.  This agent's yearly income is
$60095 USD. This Agent can be referred to
with the Alpha Identifier ilV-COu.