Get earmark (Pismo account ID)

Get an earmark by its ID.

get/cash-management/v1/earmarks/{earmarkId}

Request

Base URL
https://sandbox.pismolabs.io
URL
https://sandbox.pismolabs.io/cash-management/v1/earmarks/{earmarkId}
Auth
HTTP bearer

Path parameters

earmarkIdstring required

Earmark ID generated by Create earmark.

Response

earmark_idstring

Earmark ID. Used as the primary key for query and update operations. It has the same value as the tracking ID, if one is provided. Generated by Create Earmark.

account_idinteger

Account ID generated by Create Corporate Account.<br> minimum: 1

external_account_idstring

External ID of the account on which the earmark is created. Should be the same external_account_id that was used to log in. Should be the same external_account_id used in Create Corporate Account.

descriptionstring

Earmark description

amountnumber float

Earmark amount<br> minimum: 0.01 maximum: 18446744073709551617

balancenumber

Earmark balance. Initially equal to the earmarked amount and decreases as the reserved funds are used up or decreased in a decrease operation. It can also increase if an increase operation is performed.<br> minimum: 0 maximum: 18446744073709551617

release_datetimestring date-time

RFC 3339 date/time for earmark release. Used to schedule a cash-out (usually a payment) at the specified release date and time. At release_datetime, an automatic process releases the earmarked funds and settles the cash-out. If no release_datetime is set, the earmarked amount is held indefinitely until the customer cancels the earmark.

Example response

{
  "earmark_id": "da85b309-a7f7-4316-b2ad-f069f0838058",
  "account_id": 102701621,
  "external_account_id": "b993ba96-b3e8-4ef7-9cf7-7eee5ddafdab",
  "amount": 50,
  "balance": 123.45,
  "release_datetime": "2022-02-10T15:00:00Z",
  "internal_operations": [
    {
      "tracking_id": "0a50c88a-ade8-4bcc-a639-9a0b0f11e244",
      "business_date": "2023-03-09",
      "type": "HOLD_FUNDS",
      "processing_code": "219248",
      "amount": 50,
      "validation_rules": {
        "ACCOUNT_STATUS": {
          "override": false
        },
        "LEDGER": {
          "force": false
        },
        "FLEX_CONTROLS": {
          "override": true
        },
        "RATES": {
          "override": true
        }
      },
      "created_at": "2022-02-10T15:00:00Z"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.