> ## Documentation Index
> Fetch the complete documentation index at: https://docs.b3.fun/llms.txt
> Use this file to discover all available pages before exploring further.

# 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 `

List Collections

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

## Servers

- ` https://createkit.b3.fun ` — Production server

## Parameters

### ` creator ` (query, optional)

Filter by creator wallet address

- ` value `: type ` string `

  - pattern: ` "^0x[a-fA-F0-9]{40}$" `

### ` symbol ` (query, optional)

Filter by collection symbol

- ` value `: type ` string `

### ` referrer ` (query, optional)

Filter by referrer ID

- ` value `: type ` string `

  - pattern: ` "^[a-z0-9]+$" `

### ` chainId ` (query, optional)

Filter by blockchain chain ID

- ` value `: type ` integer `

### ` gameOwner ` (query, optional)

Filter by game owner wallet address

- ` value `: type ` string `

  - pattern: ` "^0x[a-fA-F0-9]{40}$" `

### ` gameId ` (query, optional)

Filter by game ID

- ` value `: type ` string `

### ` page ` (query, optional)

Page number for pagination

- ` value `: type ` integer `

  - default: ` 1 `

  - minimum: ` 1 `

### ` limit ` (query, optional)

Number of items per page

- ` value `: type ` integer `

  - default: ` 10 `

  - minimum: ` 1 `

  - maximum: ` 100 `

## Responses

### ` 200 ` — Collections retrieved successfully

Content type: ` application/json `

- ` value `: type ` object `

  - ` success `: type ` boolean `

    - example: ` true `

  - ` total `: type ` integer ` — Total number of collections matching filters

  - ` page `: type ` integer ` — Current page number

  - ` limit `: type ` integer ` — Items per page

  - ` collections `: type ` array ` — Array of collection data

    - ` array item `: type ` object ` — Complete NFT collection data

      - ` uuid `: type ` string ` — Unique collection identifier

      - ` predictedAddress `: type ` string ` — Predicted deployment address

        - pattern: ` "^0x[a-fA-F0-9]{40}$" `

      - ` creator `: type ` string ` — Creator wallet address

        - pattern: ` "^0x[a-fA-F0-9]{40}$" `

      - ` gameOwner `: type ` string ` — Game owner wallet address

        - pattern: ` "^0x[a-fA-F0-9]{40}$" `

      - ` gameId `: type ` string `; nullable — Game identifier

      - ` chainId `: type ` integer ` — Blockchain chain ID

      - ` creatorSignature `: type ` string ` — Authorization signature

      - ` name `: type ` string ` — Collection name

      - ` symbol `: type ` string ` — Collection symbol

      - ` baseURI `: type ` string ` — Base URI for metadata

      - ` maxSupply `: type ` string ` — Maximum token supply

      - ` mintPrice `: type ` string ` — Price per mint in ETH

      - ` startTime `: type ` string ` — Mint start timestamp

      - ` endTime `: type ` string ` — Mint end timestamp

      - ` tokenStandard `: type ` string ` — NFT token standard

        - enum: ` ["ERC721","ERC1155"] `

      - ` maxPerWallet `: type ` string ` — Maximum tokens per wallet

      - ` isWhitelistEnabled `: type ` boolean ` — Whitelist status

      - ` image `: type ` string ` — Collection image URL

      - ` description `: type ` string ` — Collection description

      - ` external_url `: type ` string ` — External collection URL

      - ` animation_url `: type ` string ` — Multimedia attachment URL

      - ` attributes `: type ` array ` — Collection attributes

        - ` array item `: type ` object `

          - ` trait_type `: type ` string `

          - ` value `: type ` string `

      - ` createdAt `: type ` string ` — Creation timestamp

      - ` whitelistMerkleRoot `: type ` string `; nullable — Whitelist Merkle root

      - ` referrer `: type ` string `; nullable — Referrer ID

### ` 400 ` — Bad Request - Must provide at least one filter

Content type: ` application/json `

- ` value `: type ` object `

  - Required fields: ` success `, ` error `

  - ` success `: type ` boolean `

    - example: ` false `

  - ` error `: type ` string ` — Error message describing what went wrong

## Request examples

### cURL

```curl
curl -X GET 'https://createkit.b3.fun/collections'
```

### JavaScript

```javascript
const response = await fetch('https://createkit.b3.fun/collections', {
  method: 'GET'
});

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

### Python

```python
import requests

response = requests.get('https://createkit.b3.fun/collections')
print(response.json())
```