v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB
Quotas

List asset quotas

Retrieves asset quotas by asset ID. A quota is the number of asset shares. One asset can consist of a single share or multiple shares.

get/v1/issuer/{issuer_id}/assets/{asset_id}/quotas

Path parameters

issuer_idstring required

Issuer ID. For more information, refer to issuer identification number

assetIdstring required

Image asset ID. This is the image_asset_id field returned from the Get eligible token requestors endpoint.

Query parameters

pageinteger
Example:3

Page number

perPageinteger
Example:10

Maximum number of items per page

Headers

x-cidstring

The Correlation IDentifier field is used to link related API requests and events. The x-cid can help the Pismo engineering team track everything related to a call. You can find the x-cid field in the response header from an API endpoint call.

If this field isn't passed, one is automatically generated.

Response

OK

current_pageinteger

Current page number

per_pageinteger

Maximum number of items per page

pagesinteger

Number of pages

total_itemsinteger

Total number of items

Example response

{
  "current_page": 1,
  "per_page": 15,
  "pages": 10,
  "total_items": 100,
  "items": [
    {
      "asset_id": "6ea8094b-73ba-4737-93ad-370c27c54813",
      "quota_id": "c2d581cb-5c9c-40ab-8783-724feb372132",
      "issuer_id": "98400-0-0d",
      "units": 20,
      "redeemed_units": 10,
      "created_at": "2024-09-12T16:46:16.43663522",
      "customer_type": "NATURAL",
      "document_number": "7777888hh",
      "deposit_number": 567339022
    }
  ]
}