Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.sellfern.com/llms.txt

Use this file to discover all available pages before exploring further.

Sellfern public V1 errors use stable machine-readable codes so integrations and AI agents can recover safely.
StatusCodeMeaningRecommended handling
400validation_errorRequest parameters or body are invalid.Fix the request before retrying.
401unauthorizedAPI key is missing, invalid, expired, or revoked.Stop and ask for a valid API key.
403missing_scopeAPI key lacks the required scope.Request a key with the minimum additional scope.
404not_foundResource does not exist or is outside the API key organization.Do not infer cross-organization ownership.
422idempotency_conflictIdempotency key was reused with a different request.Generate a new key for a new logical mutation.
429rate_limitedAPI key exceeded rate limits.Back off and retry later.

​
Error response shape

error.details is included when structured remediation data is available. meta.request_id is always safe to log and share with Sellfern support. 
{
  "success": false,
  "error": {
    "code": "missing_scope",
    "message": "API key lacks the required scope for this endpoint.",
    "details": {
      "required_scope": "orders:read"
    }
  },
  "meta": {
    "request_id": "req_01HX..."
  }
}