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

# Retrieve one full agreement by agreement number

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

## Request

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

Fetches the current ACTIVE agreement for a business agreement number, including template element definitions with values from agreement details.

## Path parameters

- `agreementNumber` integer, required

## Response `200`

Successful retrieval

- AgreementFullResponse
  - `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` AgreementDetailFullResponse[], required
    - `id` integer, nullable
    - `key` string, required
    - `value` string, nullable
    - `type` 'STRING' | 'INTEGER' | 'BOOLEAN' | 'DATE', required
    - `format` 'AMOUNT' | 'DATE' | 'DATE_TIME' | 'EMAIL' | 'LONG_TEXT' | 'PHONE_NUMBER' | 'SHORT_TEXT' | 'URL', required
    - `required` boolean, required
    - `overrideAllowed` boolean, required
    - `defaultValue` string, nullable
    - `resolvedValue` 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)