CTCGX Store API

Overview

The CTCGX API allows you to programmatically manage your store's inventory, retrieve orders, and receive real-time event notifications via webhooks.

Key Features

• Full Inventory Sync - Push your entire catalog in one request
• Incremental Updates - Update individual listings as they change
• Product Lookup - Match your products to CTCGX's database using TCGPlayer, Scryfall, or other external IDs
• Order Management - Retrieve orders and update fulfillment status
• Webhooks - Get notified when orders are placed, inventory runs low, and more
• Test Mode - Safely test your integration with sandbox API keys

Rate Limits

API requests are rate limited to 100 requests per minute per API key. Rate limit headers are included in all responses:

• X-RateLimit-Limit - Maximum requests per minute
• X-RateLimit-Remaining - Requests remaining in the current window
• X-RateLimit-Reset - Unix timestamp when the limit resets

Error Handling

The API uses standard HTTP status codes. Errors include a JSON body with details:

{
  "error": "validation_error",
  "message": "Invalid request body",
  "details": [
    { "field": "items[0].price", "message": "Price must be a positive number" }
  ]
}