---
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/assets-accrual`
- URL: `https://sandbox.pismolabs.io/assets-accrual/v1/issuer/{issuer_id}/assets/{asset_id}/quotas`
- Auth: HTTP bearer

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
- `asset_id` string, required

## Query parameters

- `page` integer, required
- `perPage` integer, required

## Headers

- `x-cid` string

## Response `200`

OK

- AssetQuotasResponse
  - `current_page` number: Current page
  - `per_page` integer: Number of items per page, default is 10.
  - `pages` integer: Total number of pages, default is 1.
  - `total_items` number: 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 (UTC) asset registered on Pismo platform
    - `customer_type` 'natural' | 'legal': Customer type - `natural` or `legal`. A `natural` customer is an individual, a `legal` customer is a corporation or other legal entitiy type.
    - `document_number` string: A government document number, such as a social security number (US). Must be numeric with 11-14 digits.
    - `deposit_number` integer: Deposit number

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not found
- `500`: Internal server error

---

[API](https://skmtc.dev/pismo/apis/banking-assets.md) - [All operations](https://skmtc.dev/pismo/apis/banking-assets/llms.txt) - [OpenAPI document](https://skmtc.dev/pismo/apis/banking-assets/revisions/d140d7254f7d?raw)