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

# API Scopes

API scopes define the permissions your application has when accessing Pleo APIs.

Scopes determine which resources your application can read or modify. Your application cannot access APIs or perform actions outside the scopes granted to it.

You request scopes when [registering your application](/docs/current/how-tos/oauth/how-to-register-an-oauth-client#technical-information) as part of Pleo's Technology Partner [Early Access Programme](/docs/current/getting-started/developer-partnership-programme) and during the [authorisation](/docs/current/how-tos/oauth/how-to-direct-users-to-the-authorisation-endpoint#3-build-the-authorisation-request) process.

## Scope format

Scopes use a resource and permission format:

`resource:permission`

Examples:

* export-jobs:write
* export-jobs:read
* users:read

## Available scopes by API

Each API defines its own set of scopes:

* [Exports API Scopes](/reference/export-api/export-api-scopes)
* [Tags API Scopes](/reference/scopes-2)
* [Chart of Accounts API Scopes](/reference/accounts/chart-of-accounts-api-scopes)
* [Vendors API Scopes](/reference/vendor/vendor-api-scopes)
* [Tax Code API Scopes](/reference/scopes-3)
* [Employees API Scopes](/reference/employees/employees-api-scopes)
* [Companies API Scopes](/reference/companies/companies-api-scopes)

## When scopes are evaluated

Scopes are enforced when your application makes API requests. If your access token does not include the required scope, the API will reject the request.

## Important

Ensure you request all scopes required for your integration. Missing scopes will prevent your application from accessing the corresponding API endpoints.