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.
{
"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.