---
title: "Get a counterparty's trail"
method: GET
path: "/counterparties/{id}/trail"
tags: ["Counterparties"]
---

# Get a counterparty's trail

`GET /counterparties/{id}/trail`

## Request

- Base URL: `https://api.catena.com/v1`
- URL: `https://api.catena.com/v1/counterparties/{id}/trail`
- Auth: HTTP bearer

The recorded history of a counterparty: its creation, payment-details requests and submissions, rails added or removed, name and email edits, and payment-details requests an email edit canceled. Oldest first.

## Path parameters

- `id` string, required

## Response `200`

Trail events, oldest first

- object
  - `events` object[], required
    - `id` string, required
    - `type` 'created' | 'rail_added' | 'details_requested' | 'details_submitted' | 'rail_removed' | 'identity_updated' | 'details_request_canceled', required
    - `at` string, date-time, required
    - `actorName` string
    - `railType` 'bank' | 'wallet'
    - `fields` string[]

## Changes

- **2026-10-09** `577eb909867d`: 2 warning, 1 info
  - added the new `details_request_canceled` enum value to the `events/items/type` response property for the response status `200`
  - added the new `identity_updated` enum value to the `events/items/type` response property for the response status `200`
  - added the optional property `events/items/fields` to the response with the `200` status
- **2026-09-22** `d609938f3232`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/catena/apis/catena-api/changes/counterparties/:id/trail/get.md)

---

[API](https://skmtc.dev/catena/apis/catena-api.md) · [All operations](https://skmtc.dev/catena/apis/catena-api/llms.txt) · [OpenAPI document](https://skmtc.dev/catena/apis/catena-api/revisions/852257e39bf8?raw)