> For the complete documentation index, see [llms.txt](https://docs.specifyapp.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.specifyapp.com/reference/http-api.md).

# HTTP API

## Overview

The Specify HTTP API is accessible over the following base url:

```
https://api.specifyapp.com/v2
```

{% hint style="info" %}
The Specify HTTP API is currently read-only upon your design data.
{% endhint %}

## Authentication

In order to request the routes of the HTTP API, you need to set a Personal Access Token within your request headers like so:

```
Authorization: PAT <your-personal-access-token>
```

{% hint style="info" %}
Get a Personal Access Token from [your user settings ↗︎](https://specifyapp.com/user/personal-access-tokens)
{% endhint %}

## Headers

To work with the Specify HTTP API, we recommend the use of the following headers:

```
Content-Type: application/json
Authorization: PAT <your-personal-access-token>
```

## Endpoints

<table><thead><tr><th width="111">Verb</th><th width="305">Route</th><th>Description</th></tr></thead><tbody><tr><td><code>POST</code></td><td><a href="/pages/1ZcAkMrh1TrjwrGN5rFM"><code>/parsers-engine-rpc</code></a></td><td>Execute the <a href="/pages/KqUpwmCkEdT919LYPoZS">Parsers Engine</a> against a given input and <a href="/pages/BE8GV64z8L12OkglNmN2#parserrule">Parsers Rules</a></td></tr></tbody></table>