Skip to main content
GET
/
v1
/
attestations
List Attestations
curl --request GET \
  --url https://api.truthlocks.com/v1/attestations \
  --header 'X-API-Key: <api-key>'
{
  "items": [
    {
      "id": "660e8400-e29b-41d4-a716-446655440001",
      "issuer_id": "550e8400-e29b-41d4-a716-446655440000",
      "kid": "ed-key-1",
      "status": "VALID",
      "payload": {
        "subject": "user:12345",
        "claim": "verified_email",
        "value": "user@example.com"
      },
      "log_index": 42,
      "created_at": "2026-01-13T12:00:00Z"
    }
  ],
  "next_cursor": "eyJsYXN0X2lkIjoiNjYwZTg0MDAuLi4ifQ=="
}
Returns attestations for the authenticated tenant with pagination. Filter by issuer_id or use cursor-based pagination for large result sets.

​
Parameters

​
issuer_id
uuid
Filter by issuer ID
​
pack_id
uuid
Filter by verification pack ID. Returns only attestations linked to the specified pack.
​
limit
integer
Number of results to return (max 100)
​
cursor
string
Pagination cursor from previous response

​
Responses

{
  "items": [
    {
      "id": "660e8400-e29b-41d4-a716-446655440001",
      "issuer_id": "550e8400-e29b-41d4-a716-446655440000",
      "kid": "ed-key-1",
      "status": "VALID",
      "payload": {
        "subject": "user:12345",
        "claim": "verified_email",
        "value": "user@example.com"
      },
      "log_index": 42,
      "created_at": "2026-01-13T12:00:00Z"
    }
  ],
  "next_cursor": "eyJsYXN0X2lkIjoiNjYwZTg0MDAuLi4ifQ=="
}

Authorizations

​
X-API-Key
string
header
required

API key for machine-to-machine authentication

Query Parameters

​
issuer_id
string<uuid>
​
limit
integer
default:50
Required range: x <= 100
​
cursor
string

Response

200 - application/json

List of attestations

​
items
object[]
​
next_cursor
string