---
title: "Get Tenant"
method: GET
path: "/api/admin/tenants/{tenant_id}"
tags: ["Admin"]
---

# Get Tenant

`GET /api/admin/tenants/{tenant_id}`

## Path parameters

- `tenant_id` string, required

## Response `200`

Successful Response

- TenantResponse — Schema for tenant response data.
  - `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

## Other responses

- `401` — Unauthorized: Invalid or missing admin key
- `404` — Not Found: Tenant not found
- `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)