Get Started

Errors

All errors return a JSON body with a machine-readable code and a human-readable message.

1{
2  "detail": {
3    "code": "COLLECTION_NOT_FOUND",
4    "message": "Collection not found"
5  }
6}

HTTP status codes

StatusMeaning
400Bad request — invalid parameters
401Missing or invalid API key
402Payment required — no payment method on file
403Forbidden — insufficient permissions for this key
404Resource not found
422Validation error — check the message field
429Rate limit exceeded
503Service temporarily unavailable

Error codes

CodeDescription
VALIDATION_ERRORRequest parameter failed validation
UNAUTHORIZEDAPI key missing or invalid
FORBIDDENKey doesn’t have permission for this action
NOT_FOUNDRequested resource doesn’t exist
COLLECTION_NOT_FOUNDCollection ID not found or not owned by this account
VIDEO_NOT_FOUNDVideo ID not found or not owned by this account
INSUFFICIENT_CREDITSAccount has no remaining credits
PAYMENT_METHOD_REQUIREDAction requires a saved payment method
SEARCH_UNAVAILABLESearch service temporarily unavailable — retry shortly
QUOTA_EXCEEDEDPlan-level usage quota reached
BILLING_NOT_CONFIGUREDNo Stripe customer associated with this account