NetBird Full API Reference + Read-Only MCP Prototype
GET/api/integrations/msp/tenants

List MSP tenants

Lists MSP tenants with their account details, access groups, status, and DNS challenge. Use the tenant status values existing, invited, pending, and active to review each tenant's lifecycle state.

4 status codes
200Returns an array of MSP tenant objects with account details, groups, status, DNS challenge, and available lifecycle timestamps.
activated_atstringoptional
The date and time when the tenant was activated.
created_atstringrequired
The date and time when the tenant was created.
dns_challengestringrequired
The DNS challenge to set in a TXT record
domainstringrequired
The tenant account domain
groupsarray<object>required
MSP users Groups that can access the Tenant and Roles to assume
idstringrequired
The updated MSP tenant account ID
invited_atstringoptional
The date and time when the existing tenant was invited.
namestringrequired
The name for the MSP tenant
statusstringrequired
The status of the tenant
Allowed:existinginvitedpendingactive
updated_atstringrequired
The date and time when the tenant was last updated.
400Returned when the request is invalid.
403Returned when the request is missing valid authentication.
500Returned when an internal server error occurs.

Error handling

A 400 indicates an invalid request. A 403 is returned when authentication is missing or invalid; provide valid authentication credentials. A 500 indicates an internal server error.