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

# API Overview

> The DSALTA Public API — read your compliance data over HTTPS with a scoped API token.

The DSALTA Public API is a REST API over HTTPS. Responses are JSON, resources are
addressed by predictable URLs, and every endpoint is authenticated with a scoped API
token. Most endpoints read your compliance data (`GET`); the Documents API also lets
you add files and links to a document and remove a file.

> [card] [Manage API](https://help.dsalta.com/api-reference/manage-api/overview.md)
>
> Read your compliance program — controls, documents, frameworks, people, policies,
> tests, and vendors.

## Base URL

All requests go to `https://apip.dsalta.com/v1`. Append the endpoint path, for example
`https://apip.dsalta.com/v1/frameworks`.

## Authentication

The API authenticates with a DSALTA API token, sent as a Bearer token in the
`Authorization` header on every request:

```bash theme={null}
curl https://apip.dsalta.com/v1/frameworks \
  -H "Authorization: Bearer <DSALTA_API_TOKEN>"
```

A request without a valid token returns `401 Unauthorized`. A token that lacks the
required scope (for example `frameworks:read`) returns `403 Forbidden`.

> [!TIP]
>
> In the interactive playground on each endpoint page, click **Authorize** and paste
> your API token once. It is then attached to every request you send from the docs.

## Pagination

List endpoints accept `page` and `limit` query parameters. `page` is the 1-based page
number and `limit` is the number of items per page.

```bash theme={null}
curl "https://apip.dsalta.com/v1/frameworks?page=1&limit=25" \
  -H "Authorization: Bearer <YOUR_TOKEN>"
```

## Errors

The API uses standard HTTP status codes. `2xx` means success and `4xx` means the
request was rejected.

| Status | Meaning |
| - | - |
| `200 OK` | The request succeeded. |
| `400 Bad Request` | The request body was malformed or missing required fields. |
| `401 Unauthorized` | The API token is missing, invalid, or expired. |
| `403 Forbidden` | The token is valid but lacks the scope required for this endpoint. |
| `404 Not Found` | The requested resource does not exist. |

## Making a request

A typical call sends your API token in the `Authorization` header:

```bash cURL theme={null}
curl https://apip.dsalta.com/v1/frameworks \
  -H "Authorization: Bearer <DSALTA_API_TOKEN>"
```

```javascript JavaScript theme={null}
const res = await fetch("https://apip.dsalta.com/v1/frameworks", {
  headers: { Authorization: "Bearer <DSALTA_API_TOKEN>" },
});
const data = await res.json();
```

```python Python theme={null}
import requests

res = requests.get(
    "https://apip.dsalta.com/v1/frameworks",
    headers={"Authorization": "Bearer <DSALTA_API_TOKEN>"},
)
data = res.json()
```

Browse every endpoint group in the sidebar to see parameters, responses, and a live playground.


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