Validate loads without saving

curl -X POST https://tryenvoy.ai/api/v1/loads/validate \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "loads": [
    {
      "load_number": "string",
      "equipment_type": "VAN",
      "stops": [
        {
          "location": {
            "city": "string",
            "state": "string"
          }
        }
      ]
    }
  ]
}'

{
  "valid": true,
  "data": [
    {
      "index": 1,
      "valid": true,
      "external_id": "string",
      "errors": [
        {
          "code": "validation_error",
          "message": "string",
          "field": "string"
        }
      ],
      "warnings": [
        {
          "code": "validation_error",
          "message": "string",
          "field": "string"
        }
      ]
    }
  ],
  "summary": {
    "total": 1,
    "valid": 1,
    "invalid": 1,
    "with_warnings": 1
  }
}

Dry run of POST /v1/loads/batch: checks each load and reports per-item errors (the batch route would reject the load) and warnings (accepted, but missing a field the AI agent needs, or a status Envoy doesn’t recognize). Nothing is written. Takes the same body; each load is checked on its own, so one malformed load doesn’t fail the request.

Authentication: Supports API key and bearer token authentication.

Dry run of POST /v1/loads/batch: checks each load and reports per-item errors (the batch route would reject the load) and warnings (accepted, but missing a field the AI agent needs, or a status Envoy doesn't recognize). Nothing is written. Takes the same body; each load is checked on its own, so one malformed load doesn't fail the request. **Authentication:** Supports API key and bearer token authentication.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Headers

Idempotency-KeystringOptional<=255 characters

A unique key (up to 255 printable ASCII characters, e.g. a UUID) that makes a retry of this request safe. Envoy stores the response for 24 hours; a retry with the same key and the same request returns it again with Idempotent-Replayed: true instead of running twice. The same key with a different request returns 422 idempotency_key_reused; while the first request is still running, 409 idempotency_key_in_progress. 5xx and 429 responses are not stored.

A unique key (up to 255 printable ASCII characters, e.g. a UUID) that makes a retry of this request safe. Envoy stores the response for 24 hours; a retry with the same key and the same request returns it again with `Idempotent-Replayed: true` instead of running twice. The same key with a different request returns 422 `idempotency_key_reused`; while the first request is still running, 409 `idempotency_key_in_progress`. 5xx and 429 responses are not stored.

Request

This endpoint expects an object.

loadslist of objectsRequired

Loads in the /v1/loads/batch shape

Response

Successful Response

validboolean

True when every item is valid (warnings allowed)

datalist of objects

summaryobject

Counts for a dry run: how many items would be applied, rejected, or applied with warnings.

Errors

401

Unauthorized Error

403

Forbidden Error

409

Conflict Error

422

Unprocessable Entity Error

429

Too Many Requests Error