Skip to main content
GET
/
v1
/
issuers
/
{id}
/
events
Issuer Event History
curl --request GET \
  --url https://api.truthlocks.com/v1/issuers/{id}/events \
  --header 'X-API-Key: <api-key>'
{
  "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
}
Returns a timeline of all lifecycle events for a specific issuer, including trust changes, key rotations, suspensions, and governance actions.

​
Parameters

​
id
string
required
The UUID of the issuer
​
limit
integer
Maximum number of events to return (default: 50)
​
offset
integer
Offset for pagination

​
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
}

Authorizations

​
X-API-Key
string
header
required

API key for machine-to-machine authentication

Path Parameters

​
id
string<uuid>
required

Response

200 - application/json

Event list

​
items
object[]