catalogapi-com · Schema
ItemDetailsResponse
Detailed information for a specific catalog item
CompanyAPIRewardsGiftCardsGlobal
Properties
| Name | Type | Description |
|---|---|---|
| catalog_item | object | |
| matched_entities | array | Details for categories, tags, and brands referenced by this item's IDs. Only included when matched_entities=true query parameter is passed. |
| success | boolean | Indicates successful retrieval |
| timestamp | string | When this data was retrieved |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/catalogapi-com/json-schema/catalogapi-com-item-details-response-schema.json",
"title": "ItemDetailsResponse",
"description": "Detailed information for a specific catalog item",
"x-generated": "2026-10-30",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/catalogapi-com-openapi.yml#/components/schemas/ItemDetailsResponse",
"properties": {
"catalog_item": {
"$ref": "#/$defs/CatalogItem"
},
"matched_entities": {
"description": "Details for categories, tags, and brands referenced by this item's IDs. Only included when matched_entities=true query parameter is passed.",
"items": {
"properties": {
"discount_percent": {
"description": "Discount percentage if this is a tag",
"type": [
"string",
"null"
]
},
"id": {
"description": "The ID of the entity",
"type": "integer"
},
"name": {
"description": "Name of the entity",
"type": "string"
},
"type": {
"description": "The entity type",
"enum": [
"tag",
"brand",
"category"
],
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"success": {
"description": "Indicates successful retrieval",
"type": "boolean"
},
"timestamp": {
"description": "When this data was retrieved",
"format": "datetime",
"type": "string"
}
},
"required": [
"success",
"timestamp",
"catalog_item"
],
"type": "object",
"$defs": {
"CatalogItem": {
"description": "A single catalog item with all its details",
"properties": {
"category_ids": {
"description": "Array of category IDs this item belongs to",
"items": {
"type": "integer"
},
"type": "array"
},
"shipping_estimate": {
"description": "Estimated shipping cost",
"format": "decimal",
"type": "string"
},
"price_high": {
"description": "Highest price across all variations of this product",
"format": "decimal",
"type": [
"string",
"null"
]
},
"is_primary": {
"description": "Whether this is a primary item",
"type": "boolean"
},
"original_points": {
"description": "Original points value before discounts",
"type": "integer"
},
"price": {
"description": "Current item price",
"format": "decimal",
"type": "string"
},
"item_type_id": {
"description": "Item type identifier",
"type": "integer"
},
"points_low": {
"description": "Lowest points value across all variations of this product",
"type": [
"integer",
"null"
]
},
"rank": {
"description": "Display rank/order",
"type": "integer"
},
"description": {
"description": "Detailed description of the item",
"type": "string"
},
"catalog_item_id": {
"description": "Unique identifier for this catalog item",
"type": "integer"
},
"face_currency": {
"description": "Currency of the face value",
"type": [
"string",
"null"
]
},
"supplier_reference_id": {
"description": "Supplier's reference ID",
"type": "string"
},
"images": {
"description": "Array of product images",
"items": {
"$ref": "#/$defs/CatalogItemImage"
},
"type": "array"
},
"name": {
"description": "Display name of the item",
"type": "string"
},
"product_id": {
"description": "Product identifier UUID",
"type": [
"string",
"null"
]
},
"retail_price": {
"description": "Retail price",
"format": "decimal",
"type": "string"
},
"fulfillment_type": {
"description": "How this item is fulfilled",
"type": "string"
},
"price_low": {
"description": "Lowest price across all variations of this product",
"format": "decimal",
"type": [
"string",
"null"
]
},
"is_available": {
"description": "Whether the item is available",
"type": "boolean"
},
"is_explicit": {
"description": "Whether the item contains explicit content",
"type": "boolean"
},
"is_limited_stock": {
"description": "Whether the item has limited stock",
"type": "boolean"
},
"brand_id": {
"description": "Brand identifier",
"type": "integer"
},
"availability": {
"description": "Availability status description",
"type": "string"
},
"original_price": {
"description": "Original item price before discounts",
"format": "decimal",
"type": "string"
},
"face_value": {
"description": "Face value of the item (e.g., gift card value)",
"format": "decimal",
"type": [
"string",
"null"
]
},
"model": {
"description": "Model number",
"type": "string"
},
"product_options": {
"additionalProperties": {
"items": {
"properties": {
"order": {
"description": "Display order for this option",
"type": "string"
},
"slug": {
"description": "Option identifier (e.g., 'color', 'size')",
"type": "string"
},
"translations": {
"description": "Translations for option name and value",
"items": {
"properties": {
"language": {
"type": "string"
},
"option_name": {
"type": "string"
},
"value_name": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"value": {
"description": "Option value (e.g., 'blue', 'large')",
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"description": "Available options for all variations of this product, keyed by catalog_item_id",
"type": "object"
},
"points_high": {
"description": "Highest points value across all variations of this product",
"type": [
"integer",
"null"
]
},
"supplier_id": {
"description": "Supplier identifier",
"type": "integer"
},
"product_name": {
"description": "An alternate name describing an item that is a variation",
"type": [
"string",
"null"
]
},
"required_fields": {
"description": "Fields required for ordering this item (loaded from the index during cart verify)",
"properties": {
"address_1": {
"description": "Whether address line 1 is required",
"type": "boolean"
},
"address_2": {
"description": "Whether address line 2 is required",
"type": "boolean"
},
"address_3": {
"description": "Whether address line 3 is required",
"type": "boolean"
},
"address_4": {
"description": "Whether address line 4 is required",
"type": "boolean"
},
"city": {
"description": "Whether city is required",
"type": "boolean"
},
"country": {
"description": "Whether country is required",
"type": "boolean"
},
"email": {
"description": "Whether email is required",
"type": "boolean"
},
"given_name": {
"description": "Whether given name is required",
"type": "boolean"
},
"phone_number": {
"description": "Whether phone number is required",
"type": "boolean"
},
"postal_code": {
"description": "Whether postal code is required",
"type": "boolean"
},
"state_or_region": {
"description": "Whether state/region is required",
"type": "boolean"
},
"surname": {
"description": "Whether surname is required",
"type": "boolean"
}
},
"type": "object"
},
"is_taxable": {
"description": "Whether the item is taxable",
"type": "boolean"
},
"brand": {
"description": "Brand name",
"type": "string"
},
"tag_ids": {
"description": "Array of tag IDs associated with this item",
"items": {
"type": "integer"
},
"type": "array"
},
"points": {
"description": "Current points value for this item",
"type": "integer"
}
},
"required": [
"catalog_item_id",
"product_id",
"name",
"description",
"brand",
"brand_id",
"model",
"category_ids",
"tag_ids",
"item_type_id",
"supplier_id",
"supplier_reference_id",
"availability",
"is_available",
"is_primary",
"is_limited_stock",
"is_taxable",
"is_explicit",
"fulfillment_type",
"price",
"points",
"original_price",
"original_points",
"retail_price",
"shipping_estimate",
"images",
"product_options",
"rank",
"required_fields"
],
"title": "CatalogItem",
"type": "object"
},
"CatalogItemImage": {
"description": "Product image with multiple size variations",
"properties": {
"alt": {
"description": "Alt text for accessibility",
"type": "string"
},
"is_primary": {
"description": "Whether this is the primary image for the product",
"type": "boolean"
},
"order": {
"description": "Display order for this image",
"type": "integer"
},
"urls": {
"description": "URLs for different image sizes and ratios",
"properties": {
"image_150_1_1": {
"description": "150px square (1:1 ratio)",
"type": "string"
},
"image_150_3_2": {
"description": "150px width (3:2 ratio)",
"type": "string"
},
"image_300_1_1": {
"description": "300px square (1:1 ratio)",
"type": "string"
},
"image_300_3_2": {
"description": "300px width (3:2 ratio)",
"type": "string"
},
"image_500_1_1": {
"description": "500px square (1:1 ratio)",
"type": "string"
},
"image_500_3_2": {
"description": "500px width (3:2 ratio)",
"type": "string"
},
"image_75_1_1": {
"description": "75px square (1:1 ratio)",
"type": "string"
},
"image_75_3_2": {
"description": "75px width (3:2 ratio)",
"type": "string"
}
},
"required": [
"image_75_1_1",
"image_150_1_1",
"image_300_1_1",
"image_500_1_1",
"image_75_3_2",
"image_150_3_2",
"image_300_3_2",
"image_500_3_2"
],
"type": "object"
}
},
"required": [
"is_primary",
"order",
"alt",
"urls"
],
"title": "CatalogItemImage",
"type": "object"
}
}
}Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/catalogapi-com-item-details-response"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.