---
title: "Get a Collection"
method: GET
path: "/v1/ip/collections/{collectionId}"
tags: ["IP Story Protocol"]
---

# Get a Collection

`GET /v1/ip/collections/{collectionId}`

Get a collection by its id deployed on the Story chain

**API scope required**: `collections.read`

## Path parameters

- `collectionId` string, required

## Headers

- `X-API-KEY` string, required

## Response `200`

SPG Collection found

- CollectionResponseDto
  - `id` string, required — The id of the collection
  - `actionId` string, required — The action id of the collection
  - `metadata` object, required — Story Protocol collection metadata response
    - `name` string — The name of the collection
    - `symbol` string — The symbol of the collection
    - `description` string — The description of the contract
    - `image` string, uri — A URI pointing to a resource with mime type image/* that represents the contract, typically displayed as a profile picture
    - `banner_image` string, uri — A URI pointing to a resource with mime type image/* that represents the contract, displayed as a banner image
    - `featured_image` string, uri — A URI pointing to a resource with mime type image/* that represents the featured image for the contract
    - `external_link` string, uri — The external link of the contract
    - `contractUri` string, uri — The contract URI of the collection
  - `onChain` object, required
    - `chain` string — The chain of the collection
    - `contractAddress` string — The address of the collection on the chain
    - `explorerLink` string, uri — The explorer link of the collection

---

[API](https://skmtc.net/crossmint/apis/onramp.md) · [All operations](https://skmtc.net/crossmint/apis/onramp/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/crossmint/onramp/versions/e2143d192130/schema)