---
title: "List Tenants"
method: GET
path: "/api/admin/tenants"
tags: ["Admin"]
---

# List Tenants

`GET /api/admin/tenants`

## Query parameters

- `skip` integer
- `limit` integer

## Response `200`

Successful Response

- TenantListResponse — Schema for list of tenants response.
  - `tenants` TenantResponse[], required
    - `name` string, required
    - `description` string, nullable
    - `plan` 'starter' | 'pro' | 'enterprise', required
    - `credit_balance` integer, required — Credit balance of the tenant
    - `peppol_ids` string[], nullable — Peppol IDs of the tenant
    - `ibans` string[], nullable — IBANs of the tenant
    - `company_number` string, nullable — Company number. For Belgium this is the CBE number or their EUID (European Unique Identifier) number
    - `company_tax_id` string, nullable — Company tax ID. For Belgium this is the VAT number. Must include the country prefix
    - `company_name` string, nullable — Name of the company. Must include the company type. For example: `BV`, `NV`, `CVBA`, `VOF`
    - `company_address` string, nullable — Address of the company. Must be in the form of `Street Name Street Number`
    - `company_zip` string, nullable — Zip code of the company
    - `company_city` string, nullable — City of the company
    - `company_country` string, nullable — Country of the company
    - `company_email` string, nullable — Email of the company
    - `smp_registration` boolean, nullable — Whether the tenant is registered on our SMP
    - `smp_registration_date` string, date-time, nullable — Date when the tenant was registered on SMP
    - `bcc_recipient_email` string, nullable — BCC recipient email to deliver documents
    - `id` string, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `total` integer, required — Total number of tenants

## Other responses

- `401` — Unauthorized: Invalid or missing admin key
- `422` — Validation Error
- `500` — Internal Server Error: Unexpected server error

---

[API](https://skmtc.net/e-invoice-be/apis/e-invoice-be-peppol-access-point-api.md) · [All operations](https://skmtc.net/e-invoice-be/apis/e-invoice-be-peppol-access-point-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/e-invoice-be/e-invoice-be-peppol-access-point-api/versions/a5b8396effe8/schema)