---
title: "Changes to Find agreement by ID"
method: GET
path: "/v1/agreement/{agreementExternalId}"
---

# Changes to Find agreement by ID

`GET /v1/agreement/{agreementExternalId}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 35 revisions.

- **2023-06-14** `6db167531dc6`: 2 info
- **2023-05-16** `778012a6f93d`: 1 info
- **2023-05-10** `de3413436a22`: 1 warning
- **2023-01-25** `c30436fa346d`: 1 info

## Changes

- **2023-06-14** `6db167531dc6`: 2 info
  - added the optional property `cancelled_by_user_email` to the response with the `200` status
  - added the optional property `cancelled_date` to the response with the `200` status
- **2023-05-16** `778012a6f93d`: 1 info
  - removed the `EXPIRED` enum value from the `status` response property for the response status `200`
- **2023-05-10** `de3413436a22`: 1 warning
  - added the new `INACTIVE` enum value to the `status` response property for the response status `200`
- **2023-01-25** `c30436fa346d`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/government-digital-service/apis/ledger-api/docs/v1/agreement/:agreementExternalId/get.md) - [API](https://skmtc.dev/government-digital-service/apis/ledger-api.md) - [Page](https://skmtc.dev/government-digital-service/apis/ledger-api/changes/v1/agreement/:agreementExternalId/get)