> ## Documentation Index
> Fetch the complete documentation index at: https://docs.batchrelay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Shipping services

> Read the V1 automation shipping choices before creating a quote.

`GET /v1/catalog/shipping-services` returns the published V1 shipping choices
for automation forms. It is public and cacheable for five minutes.

<Warning>
  This page targets the pending Shipping Catalog API rollout. The public API
  currently returns `404` for this route. Do not enable an integration until it
  returns `200`.
</Warning>

The response is discovery data, not a quote. Copy the selected `service` into
the order, then quote the full order. The quote decides whether that service is
available for the destination and freezes the final amount.

```json theme={null}
{
  "shipping_catalog_revision": "shipping-catalog-v1",
  "shipping_services": [
    {
      "service": "economy_untracked",
      "label": "Economy untracked",
      "tracking": "untracked",
      "delivery_estimate": "2-8 business days after production",
      "base_amount_cents": 595,
      "base_amount_label": "$5.95 base",
      "currency": "USD",
      "eligibility": ["Eligible loose photo prints only", "Maximum 10 physical prints"]
    }
  ]
}
```

## Published choices

| Service             | Base schedule | Notes                                                                                                     |
| ------------------- | ------------- | --------------------------------------------------------------------------------------------------------- |
| `economy_untracked` | \$5.95        | Loose 4 × 5, 4 × 6, 5 × 5, 5 × 7, or 8 × 10 prints only. Maximum 10 prints. Lower-48 street address only. |
| `economy`           | \$7.95        | Tracked. U.S. street, PO Box, APO, and FPO destinations. Not available for Alaska or Hawaii.              |
| `expedited`         | \$11.50       | Tracked. U.S. street address only. Alaska and Hawaii surcharges may apply.                                |

`standard_one_day` and `priority_one_day` remain valid order values, but the
catalog does not publish them yet. Do not present them as generally available
automation choices.

## Refresh on every run

Store the returned `shipping_catalog_revision` with a saved workflow setting.
Reload the catalog when the workflow runs. If the saved service or revision is
gone, ask the user to choose again rather than guessing a replacement.