OurScent

Errors

The error format and HTTP codes of the OurScent API, and what to do about each.

Every error has the same shape, with a request_id — send it to us when asking about a call.

JSON
{
  "error": {
    "code": "insufficient_credits",
    "message": "No credits left on this account. Top up or upgrade.",
    "request_id": "req_41ab…"
  }
}
HTTPcodeMeaning
400bad_requestA missing or invalid parameter
401unauthorizedKey missing, wrong or revoked
402insufficient_creditsNo credits left: top up or upgrade
403forbidden_scopeOutside the key’s scopes, or from a disallowed IP/origin
404not_foundThe perfume or resource does not exist
413payload_too_largeImage larger than 10 MB
415unsupported_media_typeNot a JPEG, PNG or WebP
429rate_limitedOver the rate limit: wait for Retry-After
503unavailableTemporarily busy: retry

Calls that return an error spend no credit.

Your first key in two minutes

Sign in with your OurScent account, create a test key, send your first call.