People & IdentityList identity mappings

List identity mappings

Bulk identity mappings (identity value → canonical person id) for the location. Use watermark pagination: pass the previous page's next_since as since to fetch the next page. Re-pulls are harmless (upsert stream).

curl -X GET "https://mythic-analytics.gulp.workers.dev/client/v1/data/identities?location_id=acme-retail&since=2024-12-25T10%3A00%3A00Z&limit=1000" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "success": true,
  "data": [
    {
      "updated_at": "2024-12-25T10:00:00Z"
    }
  ],
  "rows": 1000,
  "next_since": "2024-12-25T10:00:00Z"
}
GET
/identities
GET
Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token
Bearer Tokenstring
Required

Agency key as bearer token. Format: Bearer ak_.... Must name a location via the location_id query parameter or X-Location-Id header. Scoped keys (mcp_) are accepted too and need people:read. See Using an mcp_ key over HTTP.

Agency key as bearer token. Format: Bearer ak_.... Must name a location via the location_id query parameter or X-Location-Id header. Scoped keys (mcp_) are accepted too and need people:read. See Using an mcp_ key over HTTP.
Bearer Token
Bearer Tokenstring
Required

Location secret key as bearer token. Format: Bearer sk_.... Resolves its own location — no location_id needed.

Location secret key as bearer token. Format: Bearer sk_.... Resolves its own location — no location_id needed.
query
location_idstring

Required for agency (ak_) keys. Ignored for secret (sk_) keys, which resolve their own location. May also be supplied via the X-Location-Id header.

query
sincestring

Watermark. Return only mappings updated after this timestamp. Pass the previous page's next_since.

Format: date-time
query
limitinteger

Maximum mappings per page. Default 1000, min 1, max 5000.

Min: 1 • Max: 5000
Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. Agency key as bearer token. Format: Bearer ak_.... Must name a location via the location_id query parameter or X-Location-Id header. Scoped keys (mcp_) are accepted too and need people:read. See Using an mcp_ key over HTTP.

header
Authorizationstring
Required

Bearer token. Location secret key as bearer token. Format: Bearer sk_.... Resolves its own location — no location_id needed.

Query Parameters

location_idstring

Required for agency (ak_) keys. Ignored for secret (sk_) keys, which resolve their own location. May also be supplied via the X-Location-Id header.

Example:
acme-retail
sincestring

Watermark. Return only mappings updated after this timestamp. Pass the previous page's next_since.

limitinteger

Maximum mappings per page. Default 1000, min 1, max 5000.

Responses

successboolean
dataarray
rowsinteger
next_sincestring

Watermark for the next page. null when the page is empty.