Skip to content
Start here

List tenant accounts

client.tenants.accounts.list(stringtenantId, RequestOptionsoptions?): SinglePage<TenantAccount { id, created_on, name, 2 more } >
GET/tenants/{tenant_id}/accounts

List of accounts for the Tenant.

Security

API Email + API Key

The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.

Example:X-Auth-Email: user@example.com

The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.

Example:X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
ParametersExpand Collapse
tenantId: string
ReturnsExpand Collapse
TenantAccount { id, created_on, name, 2 more }
id: string
created_on: string
formatdate-time
name: string | null
settings: Settings { abuse_contact_email, access_approval_expiry, api_access_enabled, 3 more }
abuse_contact_email: string | null
access_approval_expiry: string | null
formatdate-time
api_access_enabled: boolean | null
Deprecateddefault_nameservers: string | null

Use DNS Settings instead. Deprecated.

enforce_twofactor: boolean | null
Deprecateduse_account_custom_ns_by_default: boolean | null

Use DNS Settings instead. Deprecated.

type: "standard" | "enterprise"
One of the following:
"standard"
"enterprise"

List tenant accounts

import Cloudflare from 'cloudflare';

const client = new Cloudflare({
  apiEmail: process.env['CLOUDFLARE_EMAIL'], // This is the default and can be omitted
  apiKey: process.env['CLOUDFLARE_API_KEY'], // This is the default and can be omitted
});

// Automatically fetches more pages as needed.
for await (const tenantAccount of client.tenants.accounts.list('tenant_id')) {
  console.log(tenantAccount.id);
}
{
  "errors": [],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "result": [
    {
      "id": "id",
      "created_on": "2019-12-27T18:11:19.117Z",
      "name": "name",
      "settings": {
        "abuse_contact_email": "abuse_contact_email",
        "access_approval_expiry": "2019-12-27T18:11:19.117Z",
        "api_access_enabled": true,
        "default_nameservers": "default_nameservers",
        "enforce_twofactor": true,
        "use_account_custom_ns_by_default": true
      },
      "type": "standard"
    }
  ],
  "success": true
}
Returns Examples
{
  "errors": [],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "result": [
    {
      "id": "id",
      "created_on": "2019-12-27T18:11:19.117Z",
      "name": "name",
      "settings": {
        "abuse_contact_email": "abuse_contact_email",
        "access_approval_expiry": "2019-12-27T18:11:19.117Z",
        "api_access_enabled": true,
        "default_nameservers": "default_nameservers",
        "enforce_twofactor": true,
        "use_account_custom_ns_by_default": true
      },
      "type": "standard"
    }
  ],
  "success": true
}