Agent (JSON)

Retrieve one agent by its numerical identifier. The result is JSON, which can be used directly in applications.

GET /(int: id).json

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.json

Example request:

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

Example response:

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 260

{
    "age": 34,
    "country_name": "Canada",
    "country_tld": "ca",
    "date_of_birth": "1981-10-25",
    "id": 6352373083,
    "id_str": "ilV-COu",
    "income": 60095,
    "internet": true,
    "language": "French",
    "religion": "Catholic",
    "sex": "Male"
}