---
title: "Retrieve provisioning usage"
method: GET
path: "/accounts/{account}/provisioning-usage"
tags: ["Account"]
---

# Retrieve provisioning usage

`GET /accounts/{account}/provisioning-usage`

## Request

- Base URL: `https://api.factuarea.com/v1`
- URL: `https://api.factuarea.com/v1/accounts/{account}/provisioning-usage`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Retrieve the provisioning usage of YOUR account as a provider.
- Managed accounts by environment (test ones do not count), `limit`, `remaining` and `managed_accounts_by_plan`.
- Also `provider_paid_additional_nifs` and `provider_paid_employee_seats`.
- Needs the privileged `accounts:read` scope (403 `privileged_scope_required`).

## Path parameters

- `account` string, uuid, required

## Headers

- `Factuarea-Version` string, date

## Response `200`

- object
  - `data` ProvisioningUsage, required: Provisioning usage of your account as a provider: its managed accounts with the management in force, its managed account limit and what it pays for them on top of their fee.
    - `object` 'provisioning_usage', required: Always `provisioning_usage`.
    - `managed_accounts` object, required: Managed accounts with the management in force, by environment. Test ones never count towards `limit`.
      - `live` integer, required
      - `test` integer, required
    - `limit` integer, required: Maximum number of live managed accounts of your account.
    - `remaining` integer, required: Live managed accounts that still fit within `limit` (never negative).
    - `managed_accounts_by_plan` object, required: Live managed accounts with the management in force, by plan. Every plan of the catalog is always present (0 when there is none).
      - `emprendedor` integer, required
      - `empresario` integer, required
      - `integral` integer, required
      - `enterprise` integer, required
    - `provider_paid_additional_nifs` integer, required: Additional tax IDs of your managed accounts that your account pays.
    - `provider_paid_employee_seats` integer, required: Employee seats of your managed accounts that your account pays.

## Other responses

- `400`: `parameter_unknown` with `subcode` `retired_active_profile_header`: the retired `X-Active-Profile` header was sent; the company goes in the path. `parameter_invalid_format` on `Factuarea-Version`: the header is not a `YYYY-MM-DD` date. `unsupported_api_version`: the `Factuarea-Version` date is not a supported version.
- `401`: Missing or invalid API key.
- `403`: The request is authenticated but not allowed: the API key lacks the required scope (`insufficient_scope`), the plan does not include the public API or this feature (`addon_not_active`, `feature_not_available_in_plan`), or the module is not available with a test key (`module_not_available_in_sandbox`).
- `404`: The requested resource does not exist or belongs to another company. `account_not_found`: the account in the path does not exist or is not the account of the API key.
- `429`: Rate limit exceeded. Retry after the duration in `Retry-After`.
- `500`: Unexpected server error.

---

[API](https://skmtc.dev/factuarea/apis/factuarea-public-api.md) · [All operations](https://skmtc.dev/factuarea/apis/factuarea-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/factuarea/apis/factuarea-public-api/revisions/718e77934422?raw)