---
title: Futrou API
description: Automate Futrou Cloud with the public v2 REST API.
---

## API endpoint

The Futrou REST API is available at:

```text
https://api.futrou.com/v2
```

It uses HTTPS and JSON. Send `Content-Type: application/json` with requests that include a body.

## Authenticate with an API token

For automation, create a long-lived API token in the [Futrou Console](https://app.futrou.com/) and send it as a bearer token:

```bash
curl https://api.futrou.com/v2/... \
  -H "Authorization: Bearer $FUTROU_API_TOKEN" \
  -H "Accept: application/json"
```

Use environment variables or your CI secret store for tokens—never commit them to a repository. Session-cookie authentication is available for interactive browser flows, but bearer tokens are the recommended choice for automation.

## Pagination, limits, and errors

List endpoints accept `page`, `limit`, `sort`, and `direction` query parameters. Pagination metadata is returned in response headers, including `X-Total-Pages`, `X-Total-Items`, and `X-Page`.

The API applies a global rate limit of 100 requests per second. A `429 Too Many Requests` response includes `Retry-After`; wait for that period before retrying.

## Full reference

Explore every endpoint, request schema, and response in the [interactive API reference](https://api.futrou.com/) or download the [OpenAPI v2 specification](https://api.futrou.com/v2/openapi.json).