Errors

SuperSend TX returns JSON errors that match the OpenAPI contract.

Shape

{
  "error": {
    "message": "Human-readable summary",
    "details": {}
  }
}

details is optional and may include field-level validation info.

Common status codes

Examples

Unverified domain (403)

{
  "error": {
    "message": "Sending domain is not verified"
  }
}

Validation (400)

{
  "error": {
    "message": "Validation failed",
    "details": {
      "to": "Required"
    }
  }
}

Idempotency

Some write endpoints accept an Idempotency-Key header. Replays with the same key return the original success response instead of creating duplicates — see the API Explorer and OpenAPI spec for which operations support it.