Skip to main content

Identities & resolutions

Two read-only views of who your visitors are:

  • Identities are the raw identity resolutions recorded for one customer's conversations.
  • Resolutions are the billing ledger of resolution events, across every customer your key can reach.

Resolution uses the delivr.ai identity graph. See Identity resolution for what is resolved and when.

Request examples omit the Authorization: Bearer gtmc_... header for brevity; every request needs it.

When billing was off for a resolution (it was recorded as unbilled), its resolvedPersonId is returned as a 12-character hash starting with # (for example #4be1a07c93d2) and the identity payload is null. resolvedCompany is always returned as recorded.

List identities​

GET /api/v1/customers/42/identities?limit=20&include_payload=false HTTP/1.1
Host: app.gtmclarity.ai
{
"data": [
{
"id": 77,
"conversationId": 118,
"resolvedPersonId": "p_5d1c8e2a",
"resolvedCompany": "Acme Corp",
"createdAt": "2026-10-14T15:06:30.000Z"
}
],
"has_more": false
}
ParameterTypeNotes
limitinteger1 to 100, default 20
starting_afterintegerAn identity id
include_payloadtrue or falseDefault false. When true, each item also has payload, the raw enrichment record, which can contain personal data
FieldTypeNotes
idinteger
conversationIdinteger
resolvedPersonIdstring or null
resolvedCompanystring or null
createdAtdate-time
payloadanyOnly present with include_payload=true

Newest first. Returns 404 until the customer's provisioningStatus is ready. Responses: 200, 400, 401, 403, 404, 429.

The resolution object​

{
"id": 3051,
"conversationId": 118,
"customerId": 42,
"resolvedPersonId": "p_5d1c8e2a",
"resolvedCompany": "Acme Corp",
"billedAt": "2026-10-14T15:06:31.000Z",
"billedCents": 10,
"reversedAt": null,
"createdAt": "2026-10-14T15:06:30.000Z"
}
FieldTypeNotes
idintegerLedger event id
conversationIdinteger
customerIdinteger
resolvedPersonIdstring or null
resolvedCompanystring or null
billedAtdate-time or nullnull when not billed
billedCentsinteger or null
reversedAtdate-time or nullSet when the charge was reversed
createdAtdate-time

List resolutions​

GET /api/v1/resolutions?customer_id=42&billed=true&created_after=2026-10-01T00:00:00Z HTTP/1.1
Host: app.gtmclarity.ai
ParameterTypeNotes
limitinteger1 to 100, default 20
starting_afterintegerA resolution id
customer_idintegerOnly this customer
created_afterdate-timeOnly events created after this time
billedtrue or falseWhether billedAt is set

Returns { "data": [resolution, ...], "has_more": false }, newest first. A customer-scoped key only ever sees its own customer; asking it for another customer_id returns an empty list. Responses: 200, 400, 401, 403, 429.

Retrieve a resolution​

GET /api/v1/resolutions/3051 HTTP/1.1
Host: app.gtmclarity.ai

Returns the resolution object. Responses: 200, 401, 403, 404, 429.