Documentation

First request

Retrieve coherent fictional people from the public API with one request. No API key is required.

https://persona-dev.onrender.com/people

Make a request

Send a GET request to the public endpoint. This example fixes the seed and reference date so the result can be replayed.

BASH

curl 'https://persona-dev.onrender.com/people?count=1&seed=guide-v2&asOf=2026-09-28'

Read the response

The response contains a results array and a meta object. Names, birth dates and locations are structured. This excerpt matches the request above with the data versions shown in meta; it may change after an update.

JSON

{
  "results": [
    {
      "id": "per_b79c5a19b88f5f1ff40446c1",
      "gender": "male",
      "name": { "first": "Edwin", "last": "Fernández", "full": "Edwin Fernández" },
      "nationality": "PR",
      "dob": { "date": "1992-12-29", "age": 33, "ageGroup": "adult" },
      "location": { "city": "Caguas", "country": { "code": "PR", "name": "Puerto Rico" } },
      "email": "e.fernandez.3yx00@example.test",
      "phone": "+17875550116",
      "picture": { "thumbnail": "https://persona-portraits.osirisbalonga.workers.dev/portraits/v1/thumbnail/p_1166.webp" }
    }
  ],
  "meta": { "count": 1, "asOf": "2026-09-28", "seed": "guide-v2", "dataVersion": "geo-2026-09-26.1", "catalogVersion": "v1", "schemaVersion": "2" }
}

Replay the result

Provide both seed and asOf explicitly. The same filters then yield the same people while the data, catalog and algorithm versions remain unchanged.

count accepts 1 to 100 people and defaults to 1.
seed is a nonblank string of up to 128 characters.
asOf uses YYYY-MM-DD; without it, the API uses the current UTC date.

Try /people