---
title: List organization members
---

[Skip to content](#_top)

[API Reference](https://developers.cloudflare.com/api)

[Organizations](https://developers.cloudflare.com/api/resources/organizations)

[Members](https://developers.cloudflare.com/api/resources/organizations/subresources/members)

Copy Markdown

Open in **Claude**Open in **ChatGPT**Open in **Cursor**

---

**Copy Markdown****View as Markdown**

# List organization members

GET/organizations/{organization\_id}/members

List memberships for an Organization. (Currently in Public Beta - see https://developers.cloudflare.com/fundamentals/organizations/)

##### 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`

##### P ath ParametersExpand Collapse

organization\_id: string

[Link to this property](<#(resource)%20organizations.members%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20organization_id%20%3E%20(schema)>)

##### Q uery ParametersExpand Collapse

page\_size: optional number

The amount of items to return. Defaults to 10.

maximum1000

minimum0

[Link to this property](<#(resource)%20organizations.members%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20page_size%20%3E%20(schema)>)

page\_token: optional string

An opaque token returned from the last list response that when provided will retrieve the next page.

Parameters used to filter the retrieved list must remain in subsequent requests with a page token.

[Link to this property](<#(resource)%20organizations.members%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20page_token%20%3E%20(schema)>)

<details>

<summary>

status: optional array of "active"or "pending"or "rejected"or "canceled"

Filter the list of memberships by membership status.

</summary>

One of the following:

"active"

<a href="#(resource)%20organizations.members%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20status%20%3E%20(schema)%20%3E%20(items)%20%3E%20(member)%200">Link to this property</a>

"pending"

<a href="#(resource)%20organizations.members%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20status%20%3E%20(schema)%20%3E%20(items)%20%3E%20(member)%201">Link to this property</a>

"rejected"

<a href="#(resource)%20organizations.members%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20status%20%3E%20(schema)%20%3E%20(items)%20%3E%20(member)%202">Link to this property</a>

"canceled"

<a href="#(resource)%20organizations.members%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20status%20%3E%20(schema)%20%3E%20(items)%20%3E%20(member)%203">Link to this property</a>

</details>

[Link to this property](<#(resource)%20organizations.members%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20status%20%3E%20(schema)>)

<details>

<summary>

user: optional object {email }

</summary>

email: optional string

Filter the list of memberships for a specific email that ends with a substring.

<a href="#(resource)%20organizations.members%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20user%20%3E%20(schema)%20%3E%20(property)%20email">Link to this property</a>

</details>

[Link to this property](<#(resource)%20organizations.members%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20user%20%3E%20(schema)>)

##### ReturnsExpand Collapse

errors: array of unknown

[Link to this property](<#(resource)%20organizations.members%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20errors>)

<details>

<summary>

messages: array of <a href="https://developers.cloudflare.com/api/resources/$shared#(resource)%20%24shared%20%3E%20(model)%20response_info%20%3E%20(schema)">ResponseInfo</a> { code, message, documentation\_url, source }

</summary>

code: number

minimum1000

<a href="#(resource)%20%24shared%20%3E%20(model)%20response_info%20%3E%20(schema)%20%3E%20(property)%20code">Link to this property</a>

message: string

<a href="#(resource)%20%24shared%20%3E%20(model)%20response_info%20%3E%20(schema)%20%3E%20(property)%20message">Link to this property</a>

documentation\_url: optional string

<a href="#(resource)%20%24shared%20%3E%20(model)%20response_info%20%3E%20(schema)%20%3E%20(property)%20documentation_url">Link to this property</a>

<details>

<summary>

source: optional object {pointer }

</summary>

pointer: optional string

<a href="#(resource)%20%24shared%20%3E%20(model)%20response_info%20%3E%20(schema)%20%3E%20(property)%20source%20%3E%20(property)%20pointer">Link to this property</a>

</details>

<a href="#(resource)%20%24shared%20%3E%20(model)%20response_info%20%3E%20(schema)%20%3E%20(property)%20source">Link to this property</a>

</details>

[Link to this property](<#(resource)%20organizations.members%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20messages>)

<details>

<summary>

result: array of <a href="https://developers.cloudflare.com/api/resources/organizations#(resource)%20organizations.members%20%3E%20(model)%20organization_member%20%3E%20(schema)">OrganizationMember</a> { id, create\_time, meta, 3 more }

</summary>

id: string

Organization Member ID

<a href="#(resource)%20organizations.members%20%3E%20(model)%20organization_member%20%3E%20(schema)%20%3E%20(property)%20id">Link to this property</a>

create\_time: string

formatdate-time

<a href="#(resource)%20organizations.members%20%3E%20(model)%20organization_member%20%3E%20(schema)%20%3E%20(property)%20create_time">Link to this property</a>

meta: map\[unknown]

<a href="#(resource)%20organizations.members%20%3E%20(model)%20organization_member%20%3E%20(schema)%20%3E%20(property)%20meta">Link to this property</a>

<details>

<summary>

status: "active"or "pending"or "rejected"or "canceled"

</summary>

One of the following:

"active"

<a href="#(resource)%20organizations.members%20%3E%20(model)%20organization_member%20%3E%20(schema)%20%3E%20(property)%20status%20%3E%20(member)%200">Link to this property</a>

"pending"

<a href="#(resource)%20organizations.members%20%3E%20(model)%20organization_member%20%3E%20(schema)%20%3E%20(property)%20status%20%3E%20(member)%201">Link to this property</a>

"rejected"

<a href="#(resource)%20organizations.members%20%3E%20(model)%20organization_member%20%3E%20(schema)%20%3E%20(property)%20status%20%3E%20(member)%202">Link to this property</a>

"canceled"

<a href="#(resource)%20organizations.members%20%3E%20(model)%20organization_member%20%3E%20(schema)%20%3E%20(property)%20status%20%3E%20(member)%203">Link to this property</a>

</details>

<a href="#(resource)%20organizations.members%20%3E%20(model)%20organization_member%20%3E%20(schema)%20%3E%20(property)%20status">Link to this property</a>

update\_time: string

formatdate-time

<a href="#(resource)%20organizations.members%20%3E%20(model)%20organization_member%20%3E%20(schema)%20%3E%20(property)%20update_time">Link to this property</a>

<details>

<summary>

user: object {id, email, name, two\_factor\_authentication\_enabled }

</summary>

id: string

<a href="#(resource)%20organizations.members%20%3E%20(model)%20organization_member%20%3E%20(schema)%20%3E%20(property)%20user%20%3E%20(property)%20id">Link to this property</a>

email: string

<a href="#(resource)%20organizations.members%20%3E%20(model)%20organization_member%20%3E%20(schema)%20%3E%20(property)%20user%20%3E%20(property)%20email">Link to this property</a>

name: string

<a href="#(resource)%20organizations.members%20%3E%20(model)%20organization_member%20%3E%20(schema)%20%3E%20(property)%20user%20%3E%20(property)%20name">Link to this property</a>

two\_factor\_authentication\_enabled: boolean

<a href="#(resource)%20organizations.members%20%3E%20(model)%20organization_member%20%3E%20(schema)%20%3E%20(property)%20user%20%3E%20(property)%20two_factor_authentication_enabled">Link to this property</a>

</details>

<a href="#(resource)%20organizations.members%20%3E%20(model)%20organization_member%20%3E%20(schema)%20%3E%20(property)%20user">Link to this property</a>

</details>

[Link to this property](<#(resource)%20organizations.members%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20result>)

<details>

<summary>

result\_info: object {next\_page\_token, total\_size }

</summary>

next\_page\_token: optional string

Use this opaque token in the next request to retrieve the next page.

Parameters used to filter the retrieved list must remain in subsequent requests with a page token.

<a href="#(resource)%20organizations.members%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20result_info%20%3E%20(property)%20next_page_token">Link to this property</a>

total\_size: optional number

Counts the total amount of items in a list with the applied filters. The API omits next\_page\_token to indicate no more items in a particular list.

<a href="#(resource)%20organizations.members%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20result_info%20%3E%20(property)%20total_size">Link to this property</a>

</details>

[Link to this property](<#(resource)%20organizations.members%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20result_info>)

success: true

[Link to this property](<#(resource)%20organizations.members%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20success>)

### List organization members

HTTP

HTTPTypeScriptPythonGoTerraform

```
curl https://api.cloudflare.com/client/v4/organizations/$ORGANIZATION_ID/members \
    -H "X-Auth-Email: $CLOUDFLARE_EMAIL" \
    -H "X-Auth-Key: $CLOUDFLARE_API_KEY"
```

200 example

```
{
  "errors": [],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "result": [
    {
      "id": "a7b9c3d2e8f4a1b5c6d0e9f2a3b7c4d8",
      "create_time": "2019-12-27T18:11:19.117Z",
      "meta": {
        "foo": {}
      },
      "status": "active",
      "update_time": "2019-12-27T18:11:19.117Z",
      "user": {
        "id": "id",
        "email": "email",
        "name": "name",
        "two_factor_authentication_enabled": true
      }
    }
  ],
  "result_info": {
    "next_page_token": "next_page_token",
    "total_size": 0
  },
  "success": true
}
```

##### Returns Examples

200 example

```
{
  "errors": [],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "result": [
    {
      "id": "a7b9c3d2e8f4a1b5c6d0e9f2a3b7c4d8",
      "create_time": "2019-12-27T18:11:19.117Z",
      "meta": {
        "foo": {}
      },
      "status": "active",
      "update_time": "2019-12-27T18:11:19.117Z",
      "user": {
        "id": "id",
        "email": "email",
        "name": "name",
        "two_factor_authentication_enabled": true
      }
    }
  ],
  "result_info": {
    "next_page_token": "next_page_token",
    "total_size": 0
  },
  "success": true
}
```