v1

latestOpenAPI 3.0.0UNLICENSED2026-07-26178479713.7 KB
settlements

aid_settlements_list

List settlements

scopes:

  • admin:billing
  • read:billing
  • admin:reports
  • read:reports
  • admin:settlements
  • read:settlements
get/accounts/{aid}/settlements

Path parameters

aidstring ^[PT]{1}\d{8}$ required

An id that uniquely identifies the account.

Query parameters

limitinteger

A limit on the number of objects to be returned. Limit can range between 1 and 1000 items, and the default is 10 items.

starting_after_idstring

cursor for use in pagination. starting_after_id is an object ID that defines your place in the list, included in the last_evaluated_key.

For instance, if you make a list request and receive 100 objects, ending with obj_foo and settled_at=2021-02-02, your subsequent call can include starting_after_id=obj_foo&starting_after_date=2021-02-02 in order to fetch the next page of the list.

Note that you need to use the created_at as value for starting_after_date if used in combination with item_created_at.gte or item_created_at.lte

Must be used together with starting_after_date

starting_after_datestring

cursor for use in pagination. starting_after_date is the settled_at or created_at from the last_evaluated_key that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo and settled_at=2021-02-02, your subsequent call can include starting_after_id=obj_foo&starting_after_date=2021-02-02 in order to fetch the next page of the list.

Must be used together with starting_after_id

created_at.gtestring date

Settlement created after, the settled_at value

created_at.ltestring date

Settlement created before a date, the settled_at value

item_created_at.gtestring date

Filter by Settlement created_at value, cannot be combined with created_at.gte query parameter

item_created_at.ltestring date

Filter by Settlement created_at value, cannot be combined with created_at.lte query parameter

payment_providerstring[]

The payment provider

payout_destination_idstring

The seller id to filter on

searchstring

Will try to match the search to settlement_id.

Response

Settlements List

Example response

{
  "items": [
    {
      "attachments": [
        {
          "content_type": "application/xml",
          "created_by": "payex"
        }
      ],
      "amounts": [
        {
          "currency": "NOK"
        }
      ]
    }
  ]
}