CreateMintRequestRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/immutable/main/json-schema/immutable-create-mint-request-request-schema.json",
  "title": "CreateMintRequestRequest",
  "x-generated": "2026-10-21",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/immutable-nfts-api-openapi.yml#/components/schemas/CreateMintRequestRequest",
  "type": "object",
  "properties": {
    "assets": {
      "type": "array",
      "maxItems": 100,
      "minItems": 1,
      "description": "List of nft to be minted",
      "items": {
        "$ref": "#/$defs/MintAsset"
      }
    }
  },
  "required": [
    "assets"
  ],
  "$defs": {
    "MintAsset": {
      "type": "object",
      "properties": {
        "reference_id": {
          "type": "string",
          "description": "The id of this asset in the system that originates the mint request"
        },
        "owner_address": {
          "type": "string",
          "description": "The address of the receiver"
        },
        "token_id": {
          "type": [
            "string",
            "null"
          ],
          "description": "An optional `uint256` token id as string. Required for ERC1155 collections."
        },
        "amount": {
          "type": [
            "string",
            "null"
          ],
          "description": "Optional mount of tokens to mint. Required for ERC1155 collections. ERC712 collections can omit this field or set it to 1",
          "minLength": 1
        },
        "metadata": {
          "$ref": "#/$defs/NFTMetadataRequest"
        }
      },
      "required": [
        "reference_id",
        "owner_address"
      ]
    },
    "NFTMetadataAttribute": {
      "type": "object",
      "properties": {
        "display_type": {
          "description": "Display type for this attribute",
          "type": [
            "string",
            "null"
          ],
          "enum": [
            "number",
            "boost_percentage",
            "boost_number",
            "date"
          ]
        },
        "trait_type": {
          "description": "The metadata trait type",
          "type": "string"
        },
        "value": {
          "oneOf": [
            {
              "type": "string"
            },
            {
              "type": "number"
            },
            {
              "type": "boolean"
            }
          ],
          "description": "The metadata trait value"
        }
      },
      "required": [
        "trait_type",
        "value"
      ]
    },
    "NFTMetadataRequest": {
      "type": "object",
      "description": "The NFT metadata. Total size of this object should not exceed 16 KiB",
      "properties": {
        "name": {
          "type": [
            "string",
            "null"
          ],
          "description": "The name of the NFT"
        },
        "description": {
          "type": [
            "string",
            "null"
          ],
          "description": "The description of the NFT"
        },
        "image": {
          "type": [
            "string",
            "null"
          ],
          "description": "The image url of the NFT"
        },
        "external_url": {
          "type": [
            "string",
            "null"
          ],
          "description": "The external link of the NFT"
        },
        "animation_url": {
          "type": [
            "string",
            "null"
          ],
          "description": "The animation url of the NFT"
        },
        "youtube_url": {
          "type": [
            "string",
            "null"
          ],
          "description": "The youtube link of the NFT"
        },
        "attributes": {
          "type": [
            "array",
            "null"
          ],
          "description": "List of Metadata attributes",
          "items": {
            "$ref": "#/$defs/NFTMetadataAttribute"
          }
        }
      }
    }
  }
}