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

# Origin One API

> Integrate drug-testing orders, results, and clinics into your systems with the Origin One REST API.

The Origin One API is a REST API for integrating with the Origin One platform. Use it to create and track drug-testing orders, find collection-site clinics, and look up companies, locations, packages, and services.

## Base URLs

| Environment | Base URL |
| - | - |
| Production | `https://api.origin.one` |
| Staging | `https://api.stage.origin.one` |

All endpoints are versioned under `/api/v2`.

## Quick example

Every request is authenticated with a bearer API token. See [Authentication](/authentication) for how to get one.

```bash theme={null}
curl https://api.origin.one/api/v2/locations/456 \
  --header "Authorization: Bearer $ORIGIN_ONE_API_TOKEN"
```

## Get started

<Columns cols={2}>
  <Card title="Authentication" icon="key" href="/authentication">
    Get an API token and authenticate your requests.
  </Card>

  <Card title="Scopes" icon="shield-check" href="/scopes">
    Understand which scopes your token needs for each endpoint.
  </Card>

  <Card title="Responses" icon="inbox" href="/responses">
    Read resource types, identifiers, dates, and null values.
  </Card>

  <Card title="Pagination" icon="list" href="/pagination">
    Page through list endpoints with a consistent envelope.
  </Card>

  <Card title="Errors" icon="triangle-exclamation" href="/errors">
    Handle validation errors and HTTP status codes.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/webhooks">
    Receive order status updates at your callback URL.
  </Card>
</Columns>

## Explore the API

<Columns cols={2}>
  <Card title="Orders" icon="clipboard-list" href="/api-reference/orders/create">
    Create, list, get, and cancel drug-testing orders.
  </Card>

  <Card title="Order lifecycle" icon="route" href="/order-lifecycle">
    Follow order statuses and know when a result is final.
  </Card>

  <Card title="Clinics" icon="hospital" href="/api-reference/clinics/search">
    Find collection-site clinics near your participants.
  </Card>

  <Card title="Reference data" icon="database" href="/api-reference/companies/list">
    Companies, locations, packages, and services linked to your token.
  </Card>
</Columns>


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