# Read Attriboo reports through the API

Use the REST API to read Attriboo reports in your own tools. For an AI assistant, prefer the existing MCP OAuth connection when available. The public OpenAPI file describes the read-only report endpoints.

Canonical page: https://www.attriboo.com/docs/api

Instructions reviewed: 2026-10-30

## Authenticate and list your websites

The API base is https://www.attriboo.com/api/v1. Send a Bearer token in the Authorization header. Existing OAuth access tokens and workspace API keys are accepted. OAuth report access is read-only; workspace keys have broader capabilities, including supported event and payment writes.

Owners and admins can find a workspace key in Settings → API & MCP. Keep it in a private server environment. Do not put it in client-side JavaScript or a public repository.

List websites using a token from your private environment

```
curl "https://www.attriboo.com/api/v1/sites" \
  -H "Authorization: Bearer $ATTRIBOO_TOKEN"
```

## Choose the website, dates and model

Pass site as a website ID or domain. It can be omitted only when the workspace has one website. Dates are UTC. period defaults to 30d; custom from and to dates are both inclusive and use YYYY-MM-DD. model defaults to first_touch.

Money is in integer cents in the selected website's currency. Success responses contain status and data; failures contain status and error. Check the HTTP status and handle 429 responses before retrying.

Read a 30-day overview

```
curl "https://www.attriboo.com/api/v1/stats/overview?site=YOUR_SITE_ID&period=30d&compare=none&model=first_touch" \
  -H "Authorization: Bearer $ATTRIBOO_TOKEN"
```

## Use the machine-readable report reference

The OpenAPI description covers GET /sites and the supported GET /stats/* reports. It intentionally excludes write endpoints, payment callbacks and account setup. It is a report reference, not permission to access an account.

The official CLI and public agent tools for creating websites or retrieving installation snippets are planned. Current MCP funnels describe the fixed reporting funnel, not a customer's saved custom funnels.

- [Read the report API OpenAPI JSON](https://www.attriboo.com/openapi.json)
- [Get started with your AI agent](https://www.attriboo.com/agents)

## Related guides

- [Connect your AI assistant with MCP](https://www.attriboo.com/docs/markdown/mcp.md)
- [Get started with your AI agent](https://www.attriboo.com/docs/markdown/agents.md)
- [Change dates and comparisons](https://www.attriboo.com/docs/markdown/date-ranges.md)
- [Understand recorded revenue](https://www.attriboo.com/docs/markdown/revenue.md)