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.

source_currency string

Source (original) currency of transactions included in this settlement.

invoicing_currency string

Currency used for invoicing.

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

invoicing_fee integer

settlement fee in invoicing currency.

invoicing_tax integer

VAT in invoicing currency.

invoicing_ex_rate float

Exchange rate used to convert from invoicing_fee to fee.

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",
  "source_currency": "string",
  "invoicing_currency": "string",
  "amount": 24209,
  "fee": 46,
  "tax": 6,
  "invoicing_fee": 46,
  "invoicing_tax": 6,
  "invoicing_ex_rate": 1,
  "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

One of the record referenced in the request was not found

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...