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

# Find agreement events by agreement ID

`GET /v1/agreement/{agreementExternalId}/event`

## Request

- Base URL: `http://ledger_url`
- URL: `http://ledger_url/v1/agreement/{agreementExternalId}/event`
- Auth: none declared

## Path parameters

- `agreementExternalId` string, required

## Query parameters

- `service_id` string

## Response `200`

OK

- AgreementEventsResponse
  - `events` Event[]
    - `data` object
    - `event_type` string
    - `live` boolean
    - `resource_external_id` string
    - `resource_type` string
    - `service_id` string
    - `timestamp` string, date-time

## Other responses

- `404`: Not found

## Changes

- **2023-03-09** `0d4682a21a87`: 1 info
  - endpoint added

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

---

[API](https://skmtc.dev/government-digital-service/apis/ledger-api.md) - [All operations](https://skmtc.dev/government-digital-service/apis/ledger-api/llms.txt) - [OpenAPI document](https://skmtc.dev/government-digital-service/apis/ledger-api/revisions/450e568b5b08?raw)