Fetch Settlement

GET 
/settlements/:id

Fetch Settlement

Request

Path Parameters

id uuidrequired

ID of the settlement to fetch

Responses

200

Successful operation

application/json

Schema

Schema

id uuid
recipient_type string

Possible values: [Entity, Platform, Beneficiary]

recipient_id uuid
currency Currency (string)

ISO-4217 three-letter currency code.

amount integer

Full settlement amount before subtracting the settlement (bank transfer) fee

fee integer

settlement (bank transfer) fee for the settlement. Includes VAT.

tax integer

VAT

reference string

Settlement bank transfer sequence number. This value is not available yet and will be provided in future updates.

settlement_count int32

Number of transactions included in the settlement

invoice_url uri

Settlement invoice PDF file URL.

csv_list_url uri

Settlement transaction CSV list.

pdf_list_url uri

Settlement transaction PDF list. This is not always available

created_at timestamp

Example (from schema)

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "recipient_type": "Entity",
  "recipient_id": "c5c57597-0d06-4583-9da5-c755c4943ede",
  "currency": "SAR",
  "amount": 24209,
  "fee": 46,
  "tax": 6,
  "reference": null,
  "settlement_count": 1,
  "invoice_url": "https://example.com/invoice.pdf",
  "csv_list_url": "https://example.com/list.csv",
  "pdf_list_url": "https://example.com/list.pdf",
  "created_at": "Date and time when the settlement was created."
}

401

Invalid authorization credentials

application/json

Schema

Schema

type string

Possible values: [authentication_error]

message string

Possible values: [Invalid authorization credentials]

errors object

Example (from schema)

{
  "type": "authentication_error",
  "message": "Invalid authorization credentials",
  "errors": null
}

403

Invalid authorization credentials

application/json

Schema

Schema

type string

Possible values: [api_error]

message string

Possible values: [User not authorized]

errors object

Example (from schema)

{
  "type": "api_error",
  "message": "User not authorized",
  "errors": null
}

404

Invalid authorization credentials

application/json

Schema

Schema

type string

Possible values: [record_not_found]

message string
errors object

Example (from schema)

{
  "type": "record_not_found",
  "message": "The <object type> record you were looking for was not found.",
  "errors": null
}

Loading...