Skip to main content
GET
/
v1
/
ip
/
collections
Get All Collections
curl --request GET \
  --url https://staging.crossmint.com/api/v1/ip/collections \
  --header 'X-API-KEY: <x-api-key>'
[
  {
    "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
    "actionId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
    "metadata": {
      "name": "My Collection",
      "symbol": "MYCOL",
      "description": "My Collection Description",
      "image": "https://example.com/image.png"
    },
    "onChain": {
      "chain": "story-testnet",
      "contractAddress": "0x123"
    }
  }
]
This API is still under development. Contact support for early access.

Headers

​
X-API-KEY
string
required

API key required for authentication

Query Parameters

​
page
string
default:1
​
perPage
string
default:10

Response

200 - application/json

Collections found

​
id
string
required

The id of the collection

Example:

"d290f1ee-6c54-4b01-90e6-d701748f0851"

​
actionId
string
required

The action id of the collection

Example:

"d290f1ee-6c54-4b01-90e6-d701748f0851"

​
metadata
object
required

Story Protocol collection metadata response

Example:
{
  "name": "My Collection",
  "symbol": "MYCOL",
  "description": "My Collection Description",
  "image": "https://example.com/image.png"
}
​
onChain
object
required
Example:
[
  {
    "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
    "actionId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
    "metadata": {
      "name": "My Collection",
      "symbol": "MYCOL",
      "description": "My Collection Description",
      "image": "https://example.com/image.png"
    },
    "onChain": {
      "chain": "story-testnet",
      "contractAddress": "0x123"
    }
  }
]