API Reference
Core concepts

Errors and status codes

Errors use the same envelope with success: false, a human-readable message, and an optional errors object. Validation failures key each problem by its dot-path field.

Example
{
  "statusCode": 422,
  "success": false,
  "message": "Validation failed",
  "errors": {
    "orders.0.dropoff.1.phone": ["must be a valid E.164 phone"]
  }
}

Status codes

CodeMeaningWhen
200OKRequest succeeded (including batch create, which is synchronous).
401UnauthorizedMissing, invalid, or revoked API key.
403ForbiddenBusiness blocked, or API access not approved for the key's environment.
409ConflictIdempotency key reused with a different body, or a cancel past its window.
413Payload too largeBatch exceeds the maximum orders per call for your account.
422UnprocessableStructural validation failed; see errors.
429Too many requestsRate limit exceeded; see Retry-After.