Retrieve a settlement

Pedido

Retrieve a single settlement by its ID.

Required scope: settlement:read

Segurança

accountId and apiKey

Caminho

idstring, (uuid)obrigatório

The unique identifier of the settlement to retrieve.

curl -i -X GET \
  'https://api.test.easypay.pt/2.0/settlement/{id}' \
  -H 'AccountId: 2b0f63e2-9fb5-4e52-aca0-b4bf0339bbe6' \
  -H 'ApiKey: eae4aa59-8e5b-4ec2-887d-b02768481a92'

Respostas

Successful response with a settlement

Corpoapplication/json

idstring, (uuid)obrigatório

Unique identifier for the settlement.

Exemplo:"f6a7b8c9-d0e1-2345-fabc-456789012306"

created_atstring, (date-time)obrigatório

Timestamp when the settlement was created. Always present.

Exemplo:"2026-02-05T09:30:00Z"

updated_atstring or null, (date-time)obrigatório

Timestamp when the settlement was last updated, or null when it has never been updated.

Exemplo:"2025-10-01T00:00:00Z"

namestringobrigatório

Human-readable name of the settlement (its batch reference).

Exemplo:"1006"

descriptionstringobrigatório

Human-readable description of the settlement.

Exemplo:"EASYPAY-1977225-42185-161-998590696"

statusstringobrigatório

Current status of the settlement.

Enum:"IN_TRANSIT""SUCCEEDED""FAILED"

Exemplo:"IN_TRANSIT"

total_amountobject(Money)obrigatório

Total amount of the settlement

number_of_itemsintegerobrigatório

Number of transactions included in the settlement.

Exemplo:2

destinationobjectobrigatório

Where the settled funds are sent.

Response

{
  "id": "e5f6a7b8-c9d0-1234-efab-345678901205",
  "created_at": "2026-02-01T11:00:00Z",
  "updated_at": null,
  "name": "1005",
  "description": "EASYPAY-5-8895-1005-CIN002",
  "status": "SUCCEEDED",
  "total_amount": {
    "currency": "EUR",
    "amount": "320.75"
  },
  "number_of_items": 7,
  "destination": {
    "type": "IBAN",
    "details": { … }
  }
}