Sign in
Relationship Intelligence

Get commitment history

Returns the append-only transition history for one commitment.

get/v1/relationships/{relationshipId}/commitments/{commitmentId}/events

Request

  • Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /v1/relationships/{relationshipId}/commitments/{commitmentId}/events
  • Auth: HTTP bearer

Path parameters

relationshipIdstring uuid required

Relationship id.

commitmentIdstring uuid required

Commitment id.

Response

Commitment events.

Example response

{
  "events": [
    {
      "action": "Send the security packet.",
      "actorRef": "a8dfa9b6-a7b2-46ea-982c-622a914c00e5",
      "actorType": "user",
      "beneficiaryParticipantRef": "customer:acme",
      "blocker": "Waiting on legal.",
      "commitmentId": "26cdbdc9-d0fc-4f8c-8660-2f0d62cfef51",
      "counterpartyParticipantRef": "jordan@example.com",
      "dueAt": "2026-08-07T17:00:00Z",
      "duePhrase": "by Friday",
      "dueTimezone": "America/New_York",
      "eventId": "8b8dfa9b-a7b2-46ea-982c-622a914c00e5",
      "evidenceRefs": [
        "relationship-observation:6b8dfa9b-a7b2-46ea-982c-622a914c00e5"
      ],
      "kind": "accepted",
      "occurredAt": "2026-08-01T14:00:00Z",
      "ownerParticipantRef": "alex@example.com",
      "reason": "Counterparty accepted in writing.",
      "sourceEventId": "user-accept:commitment-1",
      "sourceObservationId": "6b8dfa9b-a7b2-46ea-982c-622a914c00e5",
      "supersedesCommitmentId": "a13cf25b-d195-45f3-a665-3a38ba575392"
    }
  ]
}

Changes

No operation changes recorded.