List Issuer Events

GEThttps://sandbox-api.truthlocks.com/v1/issuers/{id}/eventsAuth required

Returns a timeline of all lifecycle events for a specific issuer, including trust changes, key rotations, suspensions, and governance actions.

Path Parameters

idstringrequired

The UUID of the issuer

Defaults to 550e8400-e29b-41d4-a716-446655440000

Query Parameters

limitinteger

Maximum number of events to return (default: 50)

Defaults to 50

offsetinteger

Offset for pagination

Defaults to 0

Responses

{
  "events": [
    {
      "id": "evt_a1b2c3d4",
      "type": "ISSUER_TRUSTED",
      "actor": "user:admin@example.com",
      "timestamp": "2026-02-18T19:00:00Z",
      "details": {
        "previous_status": "pending",
        "new_status": "trusted"
      }
    },
    {
      "id": "evt_e5f6g7h8",
      "type": "KEY_REGISTERED",
      "actor": "api_key:tl_live_***",
      "timestamp": "2026-02-18T18:30:00Z",
      "details": {
        "kid": "ed-key-1",
        "alg": "Ed25519"
      }
    }
  ],
  "total": 2,
  "limit": 50,
  "offset": 0
}

GET/v1/issuers/{id}/events

Language

CredentialsHEADER

Authorization

cURL Request

Examples ▾

curl --request GET \
  --url https://sandbox-api.truthlocks.com/v1/issuers/550e8400-e29b-41d4-a716-446655440000/events \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --data '{}'

Response

Click Try It! to send a real request, or view sample responses: