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

> ## Agent Instructions
> Nash exposes two MCP servers. The docs MCP server at https://docs.usenash.com/mcp searches this documentation and needs no credentials. The Nash MCP server at https://mcp.usenash.com/mcp operates an organization's deliveries and needs a Nash API key. See https://docs.usenash.com/reference/build-with-ai.
> Use the Sandbox environment (https://api.sandbox.usenash.com/v1) for anything that creates or dispatches deliveries during development.

# Nash API

> The Nash API is the gateway to the delivery orchestration platform. Find the right resource group, learn how to authenticate, pick an environment, and get started.

The Nash API is the gateway to our delivery orchestration platform. This page is the on-ramp: find the resource group you need, then learn how to authenticate, which environment to target, and the rate limits that apply.

## Available APIs

> [card] [Orders](https://docs.usenash.com/api-reference/order/order.md)
>
> Create orders, compare quotes, and dispatch deliveries programmatically.

> [card] [Dispatch Strategies](https://docs.usenash.com/api-reference/dispatch-strategies/dispatch-strategy.md)
>
> Choose providers and configure how jobs (deliveries) get dispatched.

> [card] [Notifications](https://docs.usenash.com/api-reference/notifications/notifications.md)
>
> Send notifications to your customers or internal systems.

> [card] [Store Locations & Zones](https://docs.usenash.com/api-reference/store-locations/get-store-locations.md)
>
> Manage delivery origins and the geographic areas they serve.

> [card] [Jobs](https://docs.usenash.com/api-reference/job/jobs.md)
>
> Track and update a job (delivery) once it has been dispatched.

> [card] [Batch Jobs](https://docs.usenash.com/api-reference/batch-job/create-batch-job.md)
>
> Track and update jobs (deliveries) with multiple packages.

> [card] [Providers](https://docs.usenash.com/api-reference/provider/get-providers.md)
>
> Get the providers available in your organization.

> [card] [Routes](https://docs.usenash.com/api-reference/route/get-route.md)
>
> Create, update, and dispatch ordered multi-stop routes.

> [card] [Shifts](https://docs.usenash.com/api-reference/shifts/get-all-shifts.md)
>
> Manage driver shifts.

> [card] [Templates](https://docs.usenash.com/api-reference/templates/upsert-multiple-templates.md)
>
> Upsert reusable templates.

> [card] [Store Catalog](https://docs.usenash.com/api-reference/store-catalog/pick-and-pack.md)
>
> Manage products and store inventory.

> [card] [Feedback](https://docs.usenash.com/api-reference/feedback/add-delivery-feedback.md)
>
> Submit delivery feedback.

> [card] [Shipping](https://docs.usenash.com/api-reference/shipping/manifest-orders.md)
>
> Manifest and dispatch orders for shipping.

> [card] [Fleet](https://docs.usenash.com/fleet/overview.md)
>
> The inbound surface a fleet uses to report delivery state to Nash.

> [card] [Miscellaneous](https://docs.usenash.com/api-reference/miscellaneous/server-health-check.md)
>
> Server health check.

## Conventions

The API follows RESTful conventions and uses JSON for both requests and responses. Set the `Content-Type` header to `application/json` on requests that carry a payload. All requests are strictly HTTPS.

Every Nash API response includes a request ID, whether the request succeeded or failed (see [Errors](https://docs.usenash.com/reference/errors.md)). Include it when contacting support about a specific API call — it's the fastest way for us to find your request.

## Authentication

Nash APIs use API keys. Send your key as a Bearer token in the `Authorization` header. If your key has access to more than one Nash organization, also send the `Nash-Org-Id` header to indicate which org the request is for.

```sh theme={"dark"}
curl --request GET \
  --url https://api.sandbox.usenash.com/v1/jobs \
  --header "Authorization: Bearer $NASH_API_KEY" \
  --header "Nash-Org-Id: $NASH_ORG_ID"
```

See [Authentication](https://docs.usenash.com/reference/authentication.md) for full details, including how to create an API key and find your organization ID.

## Environments

Nash provides separate Production and Sandbox environments, each with US and AU endpoints. Sandbox is a free, fully-featured environment for testing your integration without dispatching to real drivers. For the full list of base URLs and Portal links, see [Environments](https://docs.usenash.com/reference/environments.md).

## Rate limits

Each organization is limited to 20 requests per second across all Nash API endpoints. Requests beyond the limit receive an HTTP `429` response, so build in a backoff strategy. See [Rate limits & throttling](https://docs.usenash.com/reference/rate-limits-throttling.md) for guidance.

## Using LLMs

If you're integrating with the help of an LLM, Nash publishes documentation in LLM-friendly formats and a few best practices for sharing context safely. See [Using LLMs with Nash API](https://docs.usenash.com/api-reference/using-llms-with-nash-api.md).

## Next steps

> [card] [Authentication](https://docs.usenash.com/reference/authentication.md)
>
> Create an API key and authenticate your requests.

> [card] [Environments](https://docs.usenash.com/reference/environments.md)
>
> Pick the right base URL for Sandbox or Production.

> [card] [Orders](https://docs.usenash.com/api-reference/order/order.md)
>
> Start managing delivery operations with the Orders API.

> [card] [Using LLMs with Nash API](https://docs.usenash.com/api-reference/using-llms-with-nash-api.md)
>
> Integrate faster with LLM-friendly documentation.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.