---
title: "Retrieve agreement versions by agreement number"
method: GET
path: "/v1/agreements/{agreementNumber}/versions"
tags: ["Agreements"]
---

# Retrieve agreement versions by agreement number

`GET /v1/agreements/{agreementNumber}/versions`

## Request

- Base URL: `https://api.entur.io/agreements`
- URL: `https://api.entur.io/agreements/v1/agreements/{agreementNumber}/versions`
- Auth: one of:
  - HTTP bearer
  - API key in header `et-client-name`

Fetches all agreements sharing the same business agreement number, optionally filtered by status.

## Path parameters

- `agreementNumber` integer, required

## Query parameters

- `status` string[]

## Response `200`

Successful retrieval

- AgreementResponse[]
  - `id` integer, required
  - `agreementNumber` integer, required
  - `name` string, required
  - `notes` string, required
  - `status` 'ACTIVE' | 'DRAFT' | 'REVISING' | 'REVISED' | 'APPROVAL' | 'APPROVED' | 'REJECTED' | 'DEPRECATED' | 'TERMINATED' | 'PENDING', required
  - `validFrom` string, date-time, nullable
  - `validTo` string, date-time, nullable
  - `createdAt` string, date-time, required
  - `changedAt` string, date-time, required
  - `parties` PartyResponse[], required: List of parties involved in the agreement
    - `id` integer, required
    - `organisationId` integer, required
    - `role` 'OWNER' | 'OPERATOR' | 'SELLER' | 'RECIPIENT' | 'PARTICIPANT' | 'CREATOR', required
    - `approvalRequired` boolean, required
    - `approvedAt` string, date-time, nullable
    - `rejectedAt` string, date-time, nullable
  - `templateId` integer, required
  - `sourceAgreementId` integer, nullable: Internal ID of another agreement: the source agreement this agreement was migrated from. Null if not migrated.
  - `details` AgreementDetailResponse[], required
    - `id` integer, nullable
    - `key` string, required
    - `value` string, nullable
  - `processingStatus` 'NEW' | 'PROCESSING' | 'PROCESSED' | 'FAILED' | 'ROLLBACK_FAILED', required
  - `processedAt` string, date-time, nullable
  - `commandParameters` object, required: Per-command parameters grouped by command configuration id
  - `eventParameters` object, required: Per-event parameters grouped by event configuration id

## Other responses

- `400`: Invalid input supplied, bad request
- `401`: Unauthenticated access
- `403`: Forbidden access
- `404`: Resource not found

---

[API](https://skmtc.dev/entur/apis/agreements-beta-internal.md) - [All operations](https://skmtc.dev/entur/apis/agreements-beta-internal/llms.txt) - [OpenAPI document](https://skmtc.dev/entur/apis/agreements-beta-internal/revisions/8e6113364773?raw)