Skip to main content

Get Authorization Holds

GET 

/authorization-holds

(In Development)

Authorization holds API allows balance blocking for transfer operations. This allows for ensuring balance is available when a transfer is ordered and avoids balance not enough failures.

Retrieve list of active authorization holds only.

Request

Query Parameters

    customerId stringrequired

    Filter by Customer ID

    accountId string

    Filter by Account ID

    limit integer

    Possible values: <= 50

    Limit number of results

    offset integer

    Offset results by the specified number

Responses

OK

Schema

    authorizationHolds

    object[]

  • Array [

  • id string

    Authorization hold id.

    customerId stringrequired

    Customer Id.

    accountId string

    Customer account id.

    amount int64required

    Amount to block.

    currencyCode Currency (string)required

    Possible values: >= 3 characters and <= 3 characters

    Currency alphabetic code as specified by ISO 4217

    createdOn date-time

    Represents RFC 3339, section 5.6 date-time.

    expiresOn date-time

    Represents RFC 3339, section 5.6 date-time.

    status string

    Possible values: [ACTIVE, EXPIRED, USED, RELEASED]

    Status of the authorization hold.

  • ]

  • meta

    object

    Contains paging information regarding the returned records, when response is paginated.

    The input for paginated query contains two parameters:

    • limit - This is the requested number of records to return. Defaults to 10 and maximum is 50.
    • offset - This is the requested starting position of the response, where 0 is the first record. Default = 0.

    Note! The total number of records is not returned, to prevent queries spanning on all records. If numberOfRecords<limit, this means no further pages are available. On request of offset beyond the last record, the returned numberOfRecords is 0.

    The number of previous pages can be calculated by dividing offset to limit.

    numberOfRecords integer

    This is the number of records returned in the lookup. Always numberOfRecords is smaller than or equal to limit.

    limit integer

    This is the requested number of records to be returned per page.

    offset integer

    This is the requested starting position of the response, where 0 is the first record.

    page integer

    This is the page of records on which the lookup starts. The starting page is 1.

Loading...