Skip to main content
POST
/
v1
/
batch-mint
curl --request POST \
  --url https://api.pixellabsai.app/v1/batch-mint \
  --header 'Authorization: Bearer pixel_live_abc123def456' \
  --header 'Content-Type: application/json' \
  --data '{
    "collectionId": "col_9h8i7j6k5l4m",
    "items": [
      {
        "generationId": "gen_8f7b2c9a1e3d",
        "name": "Cyberpunk Samurai #001",
        "description": "Elite warrior with glowing katana",
        "attributes": [
          {"trait_type": "Weapon", "value": "Katana"},
          {"trait_type": "Rarity", "value": "Legendary"}
        ]
      },
      {
        "generationId": "gen_9g8h3i4j5k6l",
        "name": "Cyberpunk Samurai #002",
        "description": "Stealth assassin with dual blades",
        "attributes": [
          {"trait_type": "Weapon", "value": "Dual Blades"},
          {"trait_type": "Rarity", "value": "Epic"}
        ]
      }
    ]
  }'

{
  "batchId": "batch_3n4o5p6q7r8s",
  "collectionId": "col_9h8i7j6k5l4m",
  "totalItems": 2,
  "transactionSignature": "4LYug3DW98e08UYKJTEqbE6kHfTrA94UZSVuKpsgBToL6WFSv9NQwacJNEkW9xoLkFbWRuSz0DpqKEYjDKjCRnc",
  "status": "completed",
  "items": [
    {
      "nftAddress": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
      "metadataAddress": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "name": "Cyberpunk Samurai #001"
    },
    {
      "nftAddress": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
      "metadataAddress": "FPjGWee6BvgqTTreN3qO2yzybapC9H5xFHHlZwyUEu2w",
      "name": "Cyberpunk Samurai #002"
    }
  ],
  "createdAt": "2026-03-16T14:32:15Z"
}

​
Authorization

​
Authorization
string
required
Bearer token. Format: Bearer <token>

​
Body Parameters

​
collectionId
string
required
Collection ID to mint NFTs into. Format: col_<12 chars>
​
items
array
required
Array of NFT items to mint. Max 100 items per batch.
​
items[].generationId
string
required
Generation ID for this NFT item.
​
items[].name
string
required
NFT name. Max 32 characters.
​
items[].description
string
NFT description. Max 200 characters.
​
items[].attributes
array
Array of trait objects with trait_type and value properties.

​
Response

​
batchId
string
Unique batch identifier. Format: batch_<12 chars>
​
collectionId
string
Collection ID used for minting
​
totalItems
number
Total number of items in the batch
​
transactionSignature
string
Solana transaction signature (base58)
​
status
string
Batch status. Values: pending, processing, completed, failed
​
items
array
Array of minted NFT details with addresses and metadata
​
createdAt
string
ISO 8601 timestamp of batch creation
curl --request POST \
  --url https://api.pixellabsai.app/v1/batch-mint \
  --header 'Authorization: Bearer pixel_live_abc123def456' \
  --header 'Content-Type: application/json' \
  --data '{
    "collectionId": "col_9h8i7j6k5l4m",
    "items": [
      {
        "generationId": "gen_8f7b2c9a1e3d",
        "name": "Cyberpunk Samurai #001",
        "description": "Elite warrior with glowing katana",
        "attributes": [
          {"trait_type": "Weapon", "value": "Katana"},
          {"trait_type": "Rarity", "value": "Legendary"}
        ]
      },
      {
        "generationId": "gen_9g8h3i4j5k6l",
        "name": "Cyberpunk Samurai #002",
        "description": "Stealth assassin with dual blades",
        "attributes": [
          {"trait_type": "Weapon", "value": "Dual Blades"},
          {"trait_type": "Rarity", "value": "Epic"}
        ]
      }
    ]
  }'

{
  "batchId": "batch_3n4o5p6q7r8s",
  "collectionId": "col_9h8i7j6k5l4m",
  "totalItems": 2,
  "transactionSignature": "4LYug3DW98e08UYKJTEqbE6kHfTrA94UZSVuKpsgBToL6WFSv9NQwacJNEkW9xoLkFbWRuSz0DpqKEYjDKjCRnc",
  "status": "completed",
  "items": [
    {
      "nftAddress": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
      "metadataAddress": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "name": "Cyberpunk Samurai #001"
    },
    {
      "nftAddress": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
      "metadataAddress": "FPjGWee6BvgqTTreN3qO2yzybapC9H5xFHHlZwyUEu2w",
      "name": "Cyberpunk Samurai #002"
    }
  ],
  "createdAt": "2026-03-16T14:32:15Z"
}