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

# Introduction

> An overview of the Zivio API

### The Zivio API

The Zivio API gives you programmatic access to your projects, suppliers, bids, invoices and
approvals — everything you manage in the Zivio platform. It authenticates with OAuth 2.0,
grants access through fine-grained scopes, and comes with an MCP server so AI assistants can
query your Zivio data directly.

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/v4/quickstart">
    Get a token and make your first request.
  </Card>

  <Card title="Authentication" icon="key" href="/v4/authentication">
    The client credentials flow in detail.
  </Card>

  <Card title="Scopes" icon="shield-check" href="/v4/scopes">
    Every scope and what it unlocks.
  </Card>

  <Card title="MCP server" icon="robot" href="/v4/mcp">
    Connect Claude or ChatGPT to Zivio.
  </Card>
</CardGroup>

### Base URLs

Use the global endpoint unless you have been allocated a specific data region.

| Region | Base URL                          |
| ------ | --------------------------------- |
| Global | `https://api.zivio.net/api/v4`    |
| EU     | `https://api.eu.zivio.net/api/v4` |
| UK     | `https://api.uk.zivio.net/api/v4` |
| US     | `https://api.us.zivio.net/api/v4` |

These endpoints serve every Zivio organisation, so every request must identify yours with the
`zivio-tenant-id` header — including the token request. See
[Identifying your organisation](/v4/authentication#identifying-your-organisation).

### Conventions

* **Money is in minor currency units.** `1000000` is £10,000.00. This applies to request
  bodies, responses and filter values alike.
* **List endpoints are paginated** with `page` and `limit` (default 20, maximum 100).
* **Every resource exposes a `/help` endpoint** — for example `GET /projects/help` — which
  returns the filterable attributes, valid operators and enum values for that resource.
  It is the fastest way to discover what you can query without leaving your terminal.
* **Errors share one envelope** across every non-2xx response. See [Errors](/v4/errors).
* **`zivio-tenant-id` is required on every request** to the endpoints above, and is checked
  before authentication.

### Where to go next

<Steps>
  <Step title="Get running">
    The [Quickstart](/v4/quickstart) takes you from credentials to your first response.
  </Step>

  <Step title="Choose your access">
    [Scopes](/v4/scopes) lists everything you can request, so you can ask for the narrowest
    set your integration needs.
  </Step>

  <Step title="Query what you need">
    [Filtering and pagination](/v4/filtering-and-pagination) covers the query syntax the list
    endpoints share.
  </Step>
</Steps>

<Note>
  Already built against an older version of the Zivio API? See
  [Migrating from v3](/v4/migrating-from-v3).
</Note>