---
title: "Get a counterparty"
method: GET
path: "/api/v1/counterparties/{id}"
tags: ["Counterparties"]
---

# Get a counterparty

`GET /api/v1/counterparties/{id}`

## Request

- Base URL: `https://www.vestiarion.xyz`
- URL: `https://www.vestiarion.xyz/api/v1/counterparties/{id}`
- Auth: HTTP bearer

One counterparty, with up to 20 recent compliance screenings, newest first. An id this workspace does not hold, including another workspace's, answers `404`.

## Path parameters

- `id` string, required

## Response `200`

OK

- GetCounterpartyResponse
  - `data` object, required: A counterparty, with its recent screening history.
    - `id` string, required
    - `name` string, required
    - `role` 'vendor' | 'client' | 'contractor', required
    - `address` string, nullable, required
    - `chain` string, nullable, required
    - `jurisdiction` string, nullable, required
    - `riskLevel` 'unscreened' | 'clear' | 'medium' | 'high', required
    - `riskNotes` string, nullable, required
    - `baselinePaymentLimit` number, nullable, required: The business's baseline payment limit for this counterparty.
    - `paymentLimit` number, nullable, required: The current payment limit, derived from the risk tier.
    - `lastScreenedAt` string, nullable, required
    - `performanceScore` number, nullable, required: No history is different from a zero score and remains null.
    - `performanceInputs` object, nullable, required
    - `createdAt` string, required
    - `screeningHistory` object[], required: Up to 20 recent screenings, newest first.
      - `id` string, required
      - `riskLevel` string, required
      - `source` string, required
      - `notes` string, nullable, required
      - `rawScore` number, nullable, required
      - `matchedEntityId` string, nullable, required
      - `screeningMode` 'live' | 'simulate', required
      - `status` 'complete' | 'failed', required
      - `createdAt` string, required

## Other responses

- `401`: unauthorized
- `403`: forbidden
- `404`: not_found
- `500`: internal

---

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