Pave Bank

List Holds

Lender or BorrowerViewer Access

Lists holds on pledges under your agreements. Retired holds are not returned.

GET
/v1/collateral/holds

Authorization

AuthorizationRequiredBearer <token>

Enter your token in the format: Bearer {token}

In: header

Query Parameters

pledge_idstring

Filter by pledge ID

external_idstring

Filter by the external reference set on lock

statusstring

Filter by hold status

Value in: "locked" | "dispute_window" | "enforced" | "released" | "cancelled" | "failed"
page_sizeinteger

Number of results per page. Defaults to 20, maximum 50.

Format: int64
page_tokenstring

Token from a previous response's next_page_token to fetch the next page

Response Body

Success response

dataRequiredarray<object>
next_page_tokenRequiredstring

Empty when there are no more results

total_countinteger
Format: int64
curl -X GET "https://developer-api-staging.pavebank.dev/v1/collateral/holds?pledge_id=string&external_id=string&status=locked&page_size=0&page_token=string" \
  -H "Authorization: Bearer <token>"
{
  "data": [
    {
      "id": "string",
      "lender_legal_entity_id": "string",
      "pledge_id": "string",
      "asset": "string",
      "instrument_type": "string",
      "units": "string",
      "status": "locked",
      "dispute_deadline": "2019-08-24T14:15:22Z",
      "fee_amount": "string",
      "fee_asset": "string",
      "created_at": "2019-08-24T14:15:22Z",
      "updated_at": "2019-08-24T14:15:22Z"
    }
  ],
  "next_page_token": "string",
  "total_count": 0
}