Documentation

GET /people

Generate one or more fictional profiles. Filters are sent in the query string; no request body or authentication is needed.

Endpoint

The API accepts GET and HEAD. Browsers can make these requests from any origin without credentials.

HTTP

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

Targeted example

Here the person is French and lives in Brazzaville. The city belongs to the residence country.

BASH

curl 'https://persona-dev.onrender.com/people?nationality=FR&residenceCountry=CG&city=Brazzaville&ageGroup=adult,senior&count=1&seed=demo&asOf=2026-09-28'

How filters interact

continent limits nationality, not residence.
If only nationality or residenceCountry is provided, it is used for both.
A nationality outside the requested continent returns 400.
age and appearance are not accepted parameters.

Try /people