---
title: "List asset profiles"
method: GET
path: "/v1/issuance/asset-profiles"
tags: ["Asset Profiles"]
---

# List asset profiles

`GET /v1/issuance/asset-profiles`

Lists asset profiles for the authenticated organization and project.

## Query parameters

- `page` integer — Page number (1-based).
- `pageSize` integer — Items per page (max 100).
- `includeArchived` boolean — Include archived asset profiles in results.
- `category` 'generic' | 'stablecoin' | 'tokenized_security' — Filter by asset category.
- `tokenIds` string — Restrict results to these token ids as a comma-separated list (max 100). Lets a client hydrate exactly the tokens on the page it is rendering.

## Headers

- `x-project-id` string — Selects the active project for this request. Required for session/dashboard callers. Ignored when authenticating with an API key, whose scope is fixed to the key's project.

## Response `200`

Asset profiles list

- object — Standard success response envelope.
  - `data` object, required — Paginated list of asset profiles.
    - `assetProfiles` object[], required — Asset profiles.
      - `id` string, required — Asset profile identifier.
      - `organizationId` string, required — Organization identifier.
      - `projectId` string, required — Project identifier.
      - `tokenId` string, required — Identifier of the issued token this profile describes.
      - `assetCategory` 'generic' | 'stablecoin' | 'tokenized_security', required — Broad product/regulatory grouping for an issued asset.
      - `assetType` string, required — Concrete asset type within the category.
      - `assetTypeVersion` integer, required — Version of the asset type registry contract this profile was validated against.
      - `issuanceMetadata` object, required — Canonical, private master metadata for the asset. SDP-owned namespaces (asset, compliance, chain) plus a namespaced custom bucket (customer, integration). The optional `visibility.public` array holds the issuance_metadata dot-paths the issuer chose to expose publicly; when omitted, the asset type's registry default is used. Only asset.* and chain.decimals paths can ever be projected publicly — compliance and custom fields are private by default and can never be exposed, even if listed in visibility.public. The optional `settings` namespace holds the selected advanced (Token-2022) settings; `version` is server-stamped and each selected key is validated against the asset type's capability.
        - `asset` object
        - `compliance` object
        - `chain` object
        - `custom` object
          - `customer` object
          - `integration` object
        - `visibility` object
          - `public` string[]
        - `settings` object
          - `version` integer
          - `selected` object, required
      - `publicMetadata` object, required — Safe public subset of the issuance metadata, derived via the asset type's projection rules. Served by the public token metadata URI.
      - `status` 'active' | 'archived', required — Asset profile status.
      - `createdBy` string, nullable, required — User who created the profile. Null when created via API key.
      - `createdAt` string, date-time, required — Creation timestamp.
      - `updatedAt` string, date-time, required — Last update timestamp.
    - `total` integer, required — Total asset profiles matching the query.
    - `page` integer, required — Current page number.
    - `pageSize` integer, required — Items per page.
  - `meta` object, required — Response metadata.
    - `requestId` string, required — Request identifier for tracing.
    - `timestamp` string, date-time, required — ISO 8601 timestamp.

## Other responses

- `400` — Error
- `401` — Error
- `403` — Error
- `500` — Error

---

[API](https://skmtc.net/solana/apis/solana-developer-platform-api.md) · [All operations](https://skmtc.net/solana/apis/solana-developer-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/solana/solana-developer-platform-api/revisions/672b1916ba61/schema)