> ## 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.

# Nash documentation

> One API to orchestrate last-mile delivery across 80+ providers and your own fleet — and an agent that makes every delivery smarter than the last.

<div className="nash-home">
  <div className="nash-hero">
    <div className="nash-hero-aurora" />

    <div className="nash-hero-inner">
      <p className="nash-hero-eyebrow">Nash docs</p>
      <h1>Build on deliveries <em>in motion</em></h1>

      <p className="nash-hero-sub">
        One API to orchestrate last-mile delivery across 80+ providers and your own
        fleet — and an agent that makes every delivery smarter than the last.
      </p>

      <button className="nash-hero-search" data-nash-search type="button">
        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="1.7" strokeLinecap="square" strokeLinejoin="miter">
          <path d="M4 10.5a6.5 6.5 0 1 0 13 0 6.5 6.5 0 1 0-13 0" />

          <path d="M15.3 15.3 21 21" />
        </svg>

        <span className="grow">Search docs, guides, and endpoints…</span>
        <kbd>⌘K</kbd>
      </button>

      <div className="nash-quick">
        <a className="nash-pill" href="/reference/how-nash-works">
          <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="1.7" strokeLinecap="square" strokeLinejoin="miter">
            <path d="M12 5.4 4.5 3.4v15.2l7.5 2 7.5-2V3.4l-7.5 2z" />

            <path d="M12 5.4v15.2" />
          </svg>

          How Nash works
        </a>

        <a className="nash-pill" href="/api-reference/order/create-order">
          <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="1.7" strokeLinecap="square" strokeLinejoin="miter">
            <path d="m4.5 6.8 5.4 5.2-5.4 5.2" />

            <path d="M12.5 17.2H20" />
          </svg>

          Create your first order
        </a>

        <a className="nash-pill" href="/reference/authentication">
          <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="1.7" strokeLinecap="square" strokeLinejoin="miter">
            <path d="M3.7 15.8a4.3 4.3 0 1 0 8.6 0 4.3 4.3 0 1 0-8.6 0" />

            <path d="M11.2 12.6 20.5 3.3M17.2 6.6l2.9 2.9" />
          </svg>

          Authentication
        </a>

        <a className="nash-pill" href="/release-notes/change">
          <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="1.7" strokeLinecap="square" strokeLinejoin="miter">
            <path d="M3 13.4h4.6L10 6.2l3.8 11.6 2.4-4.4H21" />
          </svg>

          What's new
        </a>
      </div>
    </div>
  </div>

  <section className="nash-section">
    <div className="nash-surface-grid">
      <div className="nash-surface">
        <span className="surface-eyebrow">Platform</span>
        <span className="surface-title"><a href="/reference/how-nash-works">Documentation</a></span>

        <span className="surface-desc">
          Model your operation — orders, jobs, dispatch strategies, zones, and webhooks —
          and let Nash pick the right provider for every delivery.
        </span>

        <div className="surface-links">
          <a className="surface-link" href="/reference/how-nash-works"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="1.7" strokeLinecap="square" strokeLinejoin="miter"><path d="M4 12h15.5" /><path d="M13.5 5.5 20 12l-6.5 6.5" /></svg> How Nash works</a>
          <a className="surface-link" href="/reference/dispatch-strategies"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="1.7" strokeLinecap="square" strokeLinejoin="miter"><path d="M4 12h15.5" /><path d="M13.5 5.5 20 12l-6.5 6.5" /></svg> Dispatch strategies</a>
          <a className="surface-link" href="/reference/webhooks"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="1.7" strokeLinecap="square" strokeLinejoin="miter"><path d="M4 12h15.5" /><path d="M13.5 5.5 20 12l-6.5 6.5" /></svg> Webhooks</a>
          <a className="surface-link" href="/fleet/overview"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="1.7" strokeLinecap="square" strokeLinejoin="miter"><path d="M4 12h15.5" /><path d="M13.5 5.5 20 12l-6.5 6.5" /></svg> Your fleet</a>
        </div>
      </div>

      <div className="nash-surface">
        <span className="surface-eyebrow">Copilot</span>
        <span className="surface-title"><a href="/nash-agent/overview">Nash Agent</a></span>

        <span className="surface-desc">
          An operations copilot that investigates, acts with your sign-off, and analyzes —
          scoped to your organization and your permissions.
        </span>

        <div className="surface-links">
          <a className="surface-link" href="/nash-agent/overview"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="1.7" strokeLinecap="square" strokeLinejoin="miter"><path d="M4 12h15.5" /><path d="M13.5 5.5 20 12l-6.5 6.5" /></svg> Overview</a>
          <a className="surface-link" href="/nash-agent/custom-agents"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="1.7" strokeLinecap="square" strokeLinejoin="miter"><path d="M4 12h15.5" /><path d="M13.5 5.5 20 12l-6.5 6.5" /></svg> Custom agents</a>
          <a className="surface-link" href="/nash-agent/guardrails"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="1.7" strokeLinecap="square" strokeLinejoin="miter"><path d="M4 12h15.5" /><path d="M13.5 5.5 20 12l-6.5 6.5" /></svg> Guardrails & confirmations</a>
          <a className="surface-link" href="/nash-agent/channels"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="1.7" strokeLinecap="square" strokeLinejoin="miter"><path d="M4 12h15.5" /><path d="M13.5 5.5 20 12l-6.5 6.5" /></svg> Channels: Slack, SMS & voice</a>
        </div>
      </div>

      <div className="nash-surface">
        <span className="surface-eyebrow">Reference</span>
        <span className="surface-title"><a href="/api-reference/api-overview">API Reference</a></span>

        <span className="surface-desc">
          Every endpoint, request, and response — orders, jobs, quotes, routes, zones, and
          the rest. With an OpenAPI spec you can hand to an LLM.
        </span>

        <div className="surface-links">
          <a className="surface-link" href="/reference/authentication"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="1.7" strokeLinecap="square" strokeLinejoin="miter"><path d="M4 12h15.5" /><path d="M13.5 5.5 20 12l-6.5 6.5" /></svg> Authentication</a>
          <a className="surface-link" href="/api-reference/order/create-order"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="1.7" strokeLinecap="square" strokeLinejoin="miter"><path d="M4 12h15.5" /><path d="M13.5 5.5 20 12l-6.5 6.5" /></svg> Create Order</a>
          <a className="surface-link" href="/api-reference/order/select-quote"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="1.7" strokeLinecap="square" strokeLinejoin="miter"><path d="M4 12h15.5" /><path d="M13.5 5.5 20 12l-6.5 6.5" /></svg> Select Quote</a>
          <a className="surface-link" href="/reference/errors"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="1.7" strokeLinecap="square" strokeLinejoin="miter"><path d="M4 12h15.5" /><path d="M13.5 5.5 20 12l-6.5 6.5" /></svg> Errors</a>
        </div>
      </div>
    </div>
  </section>

  <section className="nash-section">
    <div className="nash-section-hd">
      <h2>Start building</h2>
      <a className="nash-all" href="/reference/plan-your-integration">Plan your integration →</a>
    </div>

    <div className="nash-build-grid">
      <div>
        <Steps>
          <Step title="Get your API key">
            Grab an API key and organization ID from the [Nash portal](/reference/generating-api-key-and-org-id), and build against the [sandbox environment](/reference/environments) until you're ready.
          </Step>

          <Step title="Create an order">
            One request with a pickup and a dropoff. Nash validates the addresses and returns quotes from eligible providers.
          </Step>

          <Step title="Dispatch it">
            [Select a quote](/api-reference/order/select-quote) yourself, or [autodispatch](/api-reference/order/autodispatch-order) and let your [dispatch strategy](/reference/dispatch-strategies) decide.
          </Step>

          <Step title="Listen for what happens next">
            Subscribe to [webhooks](/reference/webhooks) and every status change — assignment, pickup, dropoff — comes to you.
          </Step>
        </Steps>
      </div>

      <div>
        <CodeGroup>
          ```bash curl theme={"dark"}
          curl -X POST https://api.sandbox.usenash.com/v1/order \
            -H "Authorization: Bearer $NASH_API_KEY" \
            -H "Nash-Org-Id: $NASH_ORG_ID" \
            -H "Content-Type: application/json" \
            -d '{
              "externalId": "order-4f2a",
              "pickupAddress": "210 King St, San Francisco, CA 94107",
              "dropoffAddress": "1 Ferry Building, San Francisco, CA 94111"
            }'
          ```

          ```javascript Node theme={"dark"}
          const res = await fetch("https://api.sandbox.usenash.com/v1/order", {
            method: "POST",
            headers: {
              Authorization: `Bearer ${process.env.NASH_API_KEY}`,
              "Nash-Org-Id": process.env.NASH_ORG_ID,
              "Content-Type": "application/json",
            },
            body: JSON.stringify({
              externalId: "order-4f2a",
              pickupAddress: "210 King St, San Francisco, CA 94107",
              dropoffAddress: "1 Ferry Building, San Francisco, CA 94111",
            }),
          });

          const order = await res.json();
          // order.quotes — priced quotes from eligible providers
          ```

          ```python Python theme={"dark"}
          import os
          import requests

          res = requests.post(
              "https://api.sandbox.usenash.com/v1/order",
              headers={
                  "Authorization": f"Bearer {os.environ['NASH_API_KEY']}",
                  "Nash-Org-Id": os.environ["NASH_ORG_ID"],
              },
              json={
                  "externalId": "order-4f2a",
                  "pickupAddress": "210 King St, San Francisco, CA 94107",
                  "dropoffAddress": "1 Ferry Building, San Francisco, CA 94111",
              },
          )

          order = res.json()
          # order["quotes"] — priced quotes from eligible providers
          ```
        </CodeGroup>

        <p className="text-sm text-slate-500 mt-3">The <code>Nash-Org-Id</code> header is required when your API key has access to more than one organization. <a href="/reference/generating-api-key-and-org-id">Get your org ID →</a></p>
      </div>
    </div>
  </section>

  <section className="nash-section">
    <div className="nash-section-hd">
      <h2>Popular guides</h2>
    </div>

    <CardGroup cols={3}>
      <Card title="Sample checkout workflow" icon={<svg viewBox="0 0 24 24" width="20" height="20" fill="none" stroke="currentColor" strokeWidth="1.7" strokeLinecap="square" strokeLinejoin="miter"><path d="m4.5 6.8 5.4 5.2-5.4 5.2" /><path d="M12.5 17.2H20" /></svg>} href="/guides/checkout-workflow">
        Quote at checkout, confirm at payment, dispatch on fulfillment — the integration most teams ship first.
      </Card>

      <Card title="Route optimization" icon={<svg viewBox="0 0 24 24" width="20" height="20" fill="none" stroke="currentColor" strokeWidth="1.7" strokeLinecap="square" strokeLinejoin="miter"><path d="m3 16.2 5.4-.7v5l-5.4.7z" /><path d="m15.6 3.7 5.4-.7v5l-5.4.7z" /><path d="M8.9 18.4h5.6a3.6 3.6 0 0 0 3.6-3.6V8.6" /></svg>} href="/guides/route-optimization">
        Turn a pile of orders into sequenced, capacity-aware routes — then dispatch them as one.
      </Card>

      <Card title="Production testing" icon={<svg viewBox="0 0 24 24" width="20" height="20" fill="none" stroke="currentColor" strokeWidth="1.7" strokeLinecap="square" strokeLinejoin="miter"><path d="M3.4 12a8.6 8.6 0 1 0 17.2 0 8.6 8.6 0 1 0-17.2 0" /><path d="m8.1 12.5 2.6 2.6 5.2-5.8" /></svg>} href="/guides/production-testing">
        Simulate provider behavior end-to-end before a single real courier is dispatched.
      </Card>
    </CardGroup>
  </section>

  <section className="nash-section">
    <div className="nash-section-hd">
      <h2>Jump into the API</h2>
      <a className="nash-all" href="/api-reference/api-overview">Full reference →</a>
    </div>

    <div className="nash-api-strip">
      <a className="nash-chip" href="/api-reference/order/create-order">Create Order <span className="mono">POST</span></a>
      <a className="nash-chip" href="/api-reference/job/get-job">Get Job <span className="mono">GET</span></a>
      <a className="nash-chip" href="/api-reference/order/select-quote">Select Quote <span className="mono">POST</span></a>
      <a className="nash-chip" href="/api-reference/provider/get-providers">Get Providers <span className="mono">GET</span></a>
      <a className="nash-chip" href="/api-reference/route/dispatch-routes">Dispatch Routes <span className="mono">POST</span></a>
      <a className="nash-chip" href="/api-reference/delivery-windows/book-a-delivery-window-for-order">Book Delivery Window <span className="mono">POST</span></a>
      <a className="nash-chip" href="/api-reference/zones/get-zones">Get Zones <span className="mono">GET</span></a>
      <a className="nash-chip" href="/reference/webhooks">Webhooks <span className="mono">—</span></a>
    </div>
  </section>

  <section className="nash-section">
    <div className="nash-section-hd">
      <h2>Bring your tools</h2>
    </div>

    <CardGroup cols={2}>
      <Card title="Use LLMs with the Nash API" icon={<svg viewBox="0 0 24 24" width="20" height="20" fill="none" stroke="currentColor" strokeWidth="1.7" strokeLinecap="square" strokeLinejoin="miter"><path d="m12 3 2 7 7 2-7 2-2 7-2-7-7-2 7-2z" /></svg>} href="/api-reference/using-llms-with-nash-api">
        Point Claude, Cursor, or your own agent at our MCP server and OpenAPI spec — the whole reference, machine-readable. `llms.txt · openapi.json · MCP`
      </Card>

      <Card title="Talk to a human" icon={<svg viewBox="0 0 24 24" width="20" height="20" fill="none" stroke="currentColor" strokeWidth="1.7" strokeLinecap="square" strokeLinejoin="miter"><path d="M4 4.5h16V16H9.2L4.8 19.8V16H4z" /></svg>} href="mailto:support@usenash.com">
        Integration questions, provider onboarding, or something the docs didn't answer — we read everything. `support@usenash.com`
      </Card>
    </CardGroup>
  </section>
</div>
