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

# DocketStream REST API: Overview, Base URL, and Versioning

> The DocketStream REST API gives Enterprise customers programmatic access to live jail rosters, court cases, corrections data, and alert webhooks.

The DocketStream REST API enables you to integrate real-time correctional intelligence directly into your own applications, workflows, and dashboards. Every endpoint surfaces the same live data powering the DocketStream platform — Georgia jail rosters, court case records, GDC corrections data, and Smart Alert webhooks — all accessible programmatically over HTTPS.

## Base URL

All API requests are made to the following base URL:

```
https://api.docketstream.org/v1
```

Append the resource path to this base URL to form a complete endpoint, for example:

```
https://api.docketstream.org/v1/roster
```

## API Availability

<Warning>
  The DocketStream API is available on the **Enterprise plan only**. If you are
  on a lower-tier plan, API requests will return a `403 forbidden` response.
  Contact [support@docketstream.org](mailto:support@docketstream.org) to upgrade
  your account or request a demo.
</Warning>

## Request and Response Format

All requests must include a `Content-Type: application/json` header. Request bodies, where required, must be valid JSON. Every successful response is returned as JSON.

## Authentication

All requests require a valid API key passed as a Bearer token in the `Authorization` header. See the [Authentication](/api/authentication) page for instructions on generating a key and constructing authenticated requests.

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
```

## Rate Limits

Enterprise accounts may make up to **100 requests per minute**. When you exceed this limit, the API returns HTTP `429 Too Many Requests`. Back off and retry after the interval indicated in the `Retry-After` response header.

<Tip>
  Need a higher rate limit for a high-volume integration? Contact the DocketStream sales team at [support@docketstream.org](mailto:support@docketstream.org) to discuss a custom allowance.
</Tip>

## Available Resources

| Resource    | Endpoint       | Description                   |
| ----------- | -------------- | ----------------------------- |
| Roster      | `/roster`      | Live inmate booking data      |
| Courts      | `/courts`      | Court case records            |
| Corrections | `/corrections` | GDC offender and parolee data |
| Alerts      | `/alerts`      | Watcher management            |
| Webhooks    | `/webhooks`    | Event subscription setup      |

## Versioning

The current API version is **v1**, reflected in the base URL. DocketStream will communicate breaking changes at least **30 days in advance** via email to the address on your account and through a banner in the platform dashboard. Non-breaking additions (new fields, new optional parameters) may be introduced at any time without prior notice.

<Note>
  Pin your integration to the `/v1` base URL. Future major versions will be
  released at `/v2`, giving you time to migrate without disrupting existing
  requests.
</Note>

## Explore the API

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/api/authentication">
    Generate an API key and learn how to pass it as a Bearer token in every
    request.
  </Card>

  <Card title="Roster" icon="users" href="/api/roster">
    Query live inmate booking records by county, name, status, or date range.
  </Card>

  <Card title="Courts" icon="scale-balanced" href="/api/courts">
    Search 305,000+ Georgia court cases and retrieve full hearing histories.
  </Card>

  <Card title="Corrections" icon="building-columns" href="/api/corrections">
    Access GDC offender, parolee, and sex offender registry data.
  </Card>

  <Card title="Alerts & Webhooks" icon="bell" href="/api/alerts-webhooks">
    Manage Smart Alert watchers and receive real-time event push notifications.
  </Card>
</CardGroup>