Quickstart

Get your first submission created via the LiquidTCG API in under 5 minutes.

1. Get an API key

Go to your store admin dashboard → Settings → API Keys → Create Key. Choose Full scope for write access. The raw key is shown only once — save it to your environment variables.

2. Create a submission

curl -X POST https://your-store.liquidtcg.co/api/v1/submissions \
  -H "Authorization: Bearer bk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: unique-request-id-001" \
  -d '{
    "customer_email": "customer@example.com",
    "customer_name": "Jane Smith",
    "card_list": "4x Counterspell NM\n2x Force of Will LP",
    "notes": "Interested in store credit"
  }'

3. List submissions

curl https://your-store.liquidtcg.co/api/v1/submissions \
  -H "Authorization: Bearer bk_YOUR_API_KEY"

4. Check rate limit headers

Every response includes:

  • X-RateLimit-Limit — requests allowed per minute
  • X-RateLimit-Remaining — remaining in current window
  • X-RateLimit-Reset — Unix timestamp when the window resets

Next steps