Fictura
Data export
GET/api/v1/persons

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

limit
number · 1 to 1000

Rows per page. Defaults to 100; at most 1,000. Anything else answers 400 invalid_limit.

cursor
string

The next_cursor from the previous page. Leave it off for the first page. A bad one answers 400 invalid_cursor.

cURL
curl "https://api.fictura.co/api/v1/persons" \
  -H "Authorization: Bearer fk_data_..."
200 — application/json
{
  "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.

FieldMeaning
master_user_idThe person. Matches master_user_id on every event.
identifier_type, identifier_valueOne identifier the person is known by: device_id, account_id or revenuecat_id.
attributesThe person's attributes, including the server-set $platform, $app_version and $country.
created_atWhen the person was created.
identified_atWhen 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.