---
title: "List asset quotas"
method: GET
path: "/v1/issuer/{issuer_id}/assets/{asset_id}/quotas"
tags: ["Quotas"]
---

# List asset quotas

`GET /v1/issuer/{issuer_id}/assets/{asset_id}/quotas`

## Request

- Base URL: `https://sandbox.pismolabs.io/passport`
- URL: `https://sandbox.pismolabs.io/passport/v1/issuer/{issuer_id}/assets/{asset_id}/quotas`
- Auth: none declared

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.

## Path parameters

- `issuer_id` string, required
- `assetId` string, required

## Query parameters

- `page` integer
- `perPage` integer

## Headers

- `x-cid` string

## Response `200`

OK

- AssetQuotasResponse
  - `current_page` integer: Current page number
  - `per_page` integer: Maximum number of items per page
  - `pages` integer: Number of pages
  - `total_items` integer: Total number of items
  - `items` object[]
    - `asset_id` string: Asset ID. This ID is client-generated. It must be between 1 and 128 characters long and consist of only the characters [a-z,A-Z,0-9,-,:].
    - `quota_id` string: Quota ID
    - `issuer_id` string: Issuer ID. For more information, see [issuer identification number](https://www.investopedia.com/terms/i/issuer-identification-number-iin.asp)
    - `units` integer: Number of asset units
    - `redeemed_units` number: Number of redeemed units
    - `created_at` string, date-time: Datetime program calendar strategy was created. Format = YYYY-MM-DDTHH:MM:SS:MM.
    - `customer_type` 'NATURAL' | 'LEGAL': Applicable only to Brazil. Customer type: `NATURAL` is an individual. `LEGAL` is a corporation or other legal entity type. **Required** when providing the `has_asset_registration` object.
    - `document_number` string: Cardholder government document number. This can be from any document that identifies the cardholder such as a Tax ID, State ID, or driver's license.
    - `deposit_number` integer: Deposit number

## Other responses

- `400`: Bad request
- `401`: Access token is missing or invalid
- `404`: Not Found
- `500`: Internal server error

---

[API](https://skmtc.dev/pismo/apis/platform-authentication.md) - [All operations](https://skmtc.dev/pismo/apis/platform-authentication/llms.txt) - [OpenAPI document](https://skmtc.dev/pismo/apis/platform-authentication/revisions/935b62e16de4?raw)