---
title: "Find agreement by ID"
method: GET
path: "/v1/agreement/{agreementExternalId}"
tags: ["Agreements"]
---

# Find agreement by ID

`GET /v1/agreement/{agreementExternalId}`

## Path parameters

- `agreementExternalId` string, required

## Query parameters

- `account_id` string
- `service_id` string
- `override_account_or_service_id_restriction` boolean

## Headers

- `X-Consistent` boolean

## Response `200`

OK

- Agreement
  - `cancelled_by_user_email` string
  - `cancelled_date` string, date-time
  - `created_date` string, date-time
  - `description` string
  - `external_id` string
  - `live` boolean
  - `payment_instrument` PaymentInstrument
    - `agreement_external_id` string
    - `card_details` CardDetails
      - `billing_address` Address
        - `city` string
        - `country` string
        - `county` string
        - `line1` string
        - `line2` string
        - `postcode` string
      - `card_brand` string
      - `card_type` 'CREDIT' | 'DEBIT'
      - `cardholder_name` string
      - `expiry_date` string
      - `first_digits_card_number` string
      - `last_digits_card_number` string
    - `created_date` string, date-time
    - `external_id` string
    - `type` 'CARD'
  - `reference` string
  - `service_id` string
  - `status` 'CREATED' | 'ACTIVE' | 'INACTIVE' | 'CANCELLED'
  - `user_identifier` string

## Other responses

- `404` — Not found
- `422` — Invalid parameters. One of service_id or account_id fields is required unless override_account_or_service_id_restriction=true

---

[API](https://skmtc.net/government-digital-service/apis/ledger-api.md) · [All operations](https://skmtc.net/government-digital-service/apis/ledger-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/government-digital-service/ledger-api/revisions/10ffeffca918/schema)