List Collections

Retrieves collections with filtering and pagination. Requires at least one filter parameter. Supports filtering by creator, symbol, referrer, chainId, gameOwner, or gameId.

GET /collections
Retrieves collections with filtering and pagination. Requires at least one filter parameter. Supports filtering by creator, symbol, referrer, chainId, gameOwner, or gameId.

Query Parameters

creator string optional query
Filter by creator wallet address
symbol string optional query
Filter by collection symbol
referrer string optional query
Filter by referrer ID
chainId integer optional query
Filter by blockchain chain ID
gameOwner string optional query
Filter by game owner wallet address
gameId string optional query
Filter by game ID
page integer optional query
Page number for pagination
limit integer optional query
Number of items per page

Responses

200 Collections retrieved successfully
application/json
success boolean
total integer
Total number of collections matching filters
page integer
Current page number
limit integer
Items per page
collections object[]
Array of collection data
Array of:
uuid string
Unique collection identifier
predictedAddress string
Predicted deployment address
creator string
Creator wallet address
gameOwner string
Game owner wallet address
gameId string | null
Game identifier
chainId integer
Blockchain chain ID
creatorSignature string
Authorization signature
name string
Collection name
symbol string
Collection symbol
baseURI string
Base URI for metadata
maxSupply string
Maximum token supply
mintPrice string
Price per mint in ETH
startTime string
Mint start timestamp
endTime string
Mint end timestamp
tokenStandard string
NFT token standard
Enum: ERC721, ERC1155
maxPerWallet string
Maximum tokens per wallet
isWhitelistEnabled boolean
Whitelist status
image string
Collection image URL
description string
Collection description
external_url string
External collection URL
animation_url string
Multimedia attachment URL
attributes object[]
Collection attributes
Array of:
trait_type string
value string
createdAt string
Creation timestamp
whitelistMerkleRoot string | null
Whitelist Merkle root
referrer string | null
Referrer ID
400 Bad Request - Must provide at least one filter 
curl -X GET 'https://createkit.b3.fun/collections'
const response = await fetch('https://createkit.b3.fun/collections', {
  method: 'GET'
});

const data = await response.json();
console.log(data);
import requests

response = requests.get('https://createkit.b3.fun/collections')
print(response.json())
200 Response 
{
  "success": true,
  "total": 123,
  "page": 123,
  "limit": 123,
  "collections": [
    {
      "uuid": "<string>",
      "predictedAddress": "<string>",
      "creator": "<string>",
      "gameOwner": "<string>",
      "gameId": "<string>",
      "chainId": 123,
      "creatorSignature": "<string>",
      "name": "<string>",
      "symbol": "<string>",
      "baseURI": "<string>",
      "maxSupply": "<string>",
      "mintPrice": "<string>",
      "startTime": "<string>",
      "endTime": "<string>",
      "tokenStandard": "ERC721",
      "maxPerWallet": "<string>",
      "isWhitelistEnabled": true,
      "image": "<string>",
      "description": "<string>",
      "external_url": "<string>",
      "animation_url": "<string>",
      "attributes": [
        {
          "trait_type": "<string>",
          "value": "<string>"
        }
      ],
      "createdAt": "<string>",
      "whitelistMerkleRoot": "<string>",
      "referrer": "<string>"
    }
  ]
}
GET /collections
Previous Examples
Next Create NFT Collection
Ask a question... ⌘I