API errors

Error envelope

{
  "error": {
    "code": "asset_not_found",
    "message": "No asset with id 42 for this shop",
    "status": 404,
    "request_id": "req_..."
  }
}

Include the request id when contacting support.

Common error codes

HTTP	Code	Meaning
400	`invalid_request`	Malformed JSON or missing field.
400	`idempotency_key_required`	Write request missing Idempotency-Key.
401	`unauthorized`	Missing, invalid, unknown, or revoked token.
402	`plan_required`	API access has not been activated for the shop.
404	`asset_not_found`, `mapping_not_found`, `order_not_found`, `category_not_found`, `job_not_found`	The resource is missing or belongs to another shop.
409	`idempotency_conflict`	The same key was reused with a different request.
409	`stamping_in_progress`	Resend is blocked while PDF stamping is pending.
422	`storage_quota_exceeded`	The upload or import would exceed storage quota.
429	`rate_limited`	The API key or order resend limit was reached.
500	`internal_error`	Unexpected server error.

API docs

Start here

API quickstart

Ping the API, import an asset, map it to a product, and assign access to an order.

Reference

Endpoint reference

Review the available endpoints for assets, mappings, orders, access changes, and status.

Was this helpful?

Still stuck? Email admin@alvaapps.com.

Last updated 2026-06-05