Skip to Content

Limits and request ids

Rate limits, the size and count limits of each call, and the request id to quote when you contact us.

Rate limits

  • Per key: 120 requests a minute, and 5,000 requests a day (the day resets at 00:00 UTC). Ask your contact if you need more.
  • Answers carry X-RateLimit-Limit and X-RateLimit-Remaining for the per-minute limit.
  • Over a limit you get 429 rate_limited with a Retry-After header in seconds. Wait that long, then try again.
  • Calls with a missing or wrong key are limited to 30 a minute per address.

Request ids

Every answer carries an X-Request-Id. Quote it when you contact us about a call, and we can find it in our logs.

All limits

WhatLimit
Requests per key120 a minute, 5,000 a day (00:00 UTC reset)
Calls with a missing or wrong key30 a minute per address
Products per POST /api/v1/products50
Jobs per POST /api/v1/jobs50
File name200 characters: letters A to Z, digits, -, _ and .
Request body4 MB. Images and 3D files go as links.
Articles per GET /api/v1/assets?articles=100
Articles per page of ?since=100
Article number1 to 64 characters: letters, digits, ., _ and -
Product name300 characters
Reference images per product10, by https link; JPEG, PNG or WebP, up to 10 MB each
Variants per product50
DimensionsAbove 0 and below 10,000 cm per side
Event subscriptions3 active per company, https only
Event delivery10 second timeout; retries for about 21 hours
Signature tolerance5 minutes

Need more? Ask your CharpstAR contact.

On this page