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

# Introduction

> Generate freight quotes programmatically.

The **Dyspach API** lets you generate freight quotes programmatically — send an
origin, destination, and items, and get back priced carrier services to allocate against.

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Make your first quote request in a few minutes.
  </Card>

  <Card title="Authentication" icon="key" href="/authentication">
    Create and use an organisation API key.
  </Card>

  <Card title="Filters" icon="filter" href="/guides/filters">
    Narrow results by carrier, service, or rate card.
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/get-quote">
    Full request/response schemas and a live playground.
  </Card>
</CardGroup>

## Base URL

```text theme={null}
https://api.dyspach.com
```

All endpoints live under `/v1/org`.

## Core concepts

<AccordionGroup>
  <Accordion title="Organisation & customers" icon="building">
    You authenticate as your **organisation** (the tenant). A **customer** is one
    of your shippers. You reference a customer by its business **internal id**
    (e.g. `ACME`) — never a database UUID.
  </Accordion>

  <Accordion title="One request, one or more customers" icon="users">
    `general.customerIds` is a list. The response returns one entry under
    `results` per customer, with shared `origin` / `destination` / `goods` at the
    top level.
  </Accordion>

  <Accordion title="Filters" icon="filter">
    An optional `filters` block narrows which of a customer's services and rate
    cards are priced — by carrier, service, service type/class, or rate card. See
    [Filters](/guides/filters).
  </Accordion>

  <Accordion title="Quote ids" icon="hashtag">
    Every response includes a `quoteId` per customer. Pass it to
    [Fetch a quote](/api-reference/fetch-quote) to retrieve it later.
  </Accordion>
</AccordionGroup>

<Note>
  The API is server-to-server. Keep your API key secret and never expose it in a
  browser or mobile client.
</Note>