SANDBOX_CLAIM_NOT_FOUND

Cause

The claim token is unknown, the link signature is invalid or past its 7-day window, the sandbox was already claimed, or it expired unclaimed. All of these answer identically by design — there is no oracle distinguishing them.

How to fix it

If the link is simply stale, use the claim page to request a fresh signed link. Otherwise create a new sandbox with POST /v1/sandboxes.

Example response

{
  "error_code": "SANDBOX_CLAIM_NOT_FOUND",
  "error_type": "invalid_request",
  "error_message": "The sandbox claim link is invalid or has expired.",
  "hint": "If the link is simply stale, use the claim page to request a fresh signed link. Otherwise create a new sandbox with POST /v1/sandboxes.",
  "docs_url": "https://docs.billerapi.com/errors/SANDBOX_CLAIM_NOT_FOUND",
  "request_id": "d94f5e2a-8c3b-4f1e-9a7d-6b2c1e0f8a34"
}

Related

• Error handling — the error envelope shape and how to parse it
• Error code reference — every stable error code