/api/v1/personsPersons API
Every person in an app with their identifiers and attributes, paged with a cursor, for joining events to people in your warehouse.
Same key as the Events API: Authorization: Bearer fk_data_… with the events:read scope.
Rows per page. Defaults to 100; at most 1,000. Anything else answers 400 invalid_limit.
The next_cursor from the previous page. Leave it off for the first page. A bad one answers 400 invalid_cursor.
curl "https://api.fictura.co/api/v1/persons" \
-H "Authorization: Bearer fk_data_..."{
"ok": true,
"persons": [
{
"master_user_id": "0f1e2d3c-4b5a-6978-8695-a4b3c2d1e0f9",
"identifier_type": "device_id",
"identifier_value": "ios-2c1d…",
"attributes": { "plan": "pro", "$platform": "ios" },
"created_at": "2026-08-02T17:40:11.000000Z",
"identified_at": "2026-08-02T17:40:11.000000Z"
},
{
"master_user_id": "0f1e2d3c-4b5a-6978-8695-a4b3c2d1e0f9",
"identifier_type": "account_id",
"identifier_value": "8f14e45f",
"attributes": { "plan": "pro", "$platform": "ios" },
"created_at": "2026-08-02T17:40:11.000000Z",
"identified_at": "2026-08-02T17:41:02.000000Z"
}
],
"next_cursor": null,
"has_more": false
}One row per identifier, ordered by when each identifier was first seen. master_user_id is the key events point at: identifiers that belong to the same person share it, so group by it to get one person.
| Field | Meaning |
|---|---|
master_user_id | The person. Matches master_user_id on every event. |
identifier_type, identifier_value | One identifier the person is known by: device_id, account_id or revenuecat_id. |
attributes | The person's attributes, including the server-set $platform, $app_version and $country. |
created_at | When the person was created. |
identified_at | When this identifier was first seen. |
Fields may be added; ignore keys you do not know. A deleted person simply stops appearing: there is no tombstone row.
Newer backends only
On a Fictura backend that predates this API, GET /api/v1/persons answers 404.