Skip to content
Start here

List integrations

GET/accounts/{account_id}/one/integrations

Returns a paginated list of integrations for the account.

Security
API Token

The preferred authorization scheme for interacting with the Cloudflare API. Create a token.

Example:Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
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
Path ParametersExpand Collapse
account_id: string
Query ParametersExpand Collapse
application: optional string

Filter by application/vendor (e.g., GOOGLE_WORKSPACE, MICROSOFT_INTERNAL).

direction: optional "asc" or "desc"

Direction to order results.

One of the following:
"asc"
"desc"
dlp_enabled: optional boolean

Filter by DLP enabled status (true/false).

order: optional "application" or "created" or "name" or "status"

Field to order results by.

One of the following:
"application"
"created"
"name"
"status"
page: optional number

Page number within the paginated result set.

page_size: optional number

Number of results per page.

status: optional "Healthy" or "Initializing" or "Offline" or "Unhealthy"

Filter by integration status.

One of the following:
"Healthy"
"Initializing"
"Offline"
"Unhealthy"
use_cases: optional string

Filter by enabled use cases (e.g., casb, ces). Matches integrations enrolled in any of the specified values. Can be specified multiple times.

ReturnsExpand Collapse
errors: array of unknown

List of errors.

messages: array of string

List of messages.

result: array of object { id, application, created, 4 more }

List of items.

id: string

Integration ID.

formatuuid
application: map[string]
created: string

When the integration was created.

formatdate-time
is_paused: boolean

Whether the user paused the integration.

name: string

Name of the integration.

status: string

Integration status.

updated: string

When the integration was last updated.

formatdate-time
result_info: object { count, next, page, 3 more }

Pagination metadata.

count: optional number

Number of items in current page.

page: optional number

Current page number.

per_page: optional number

Number of items per page.

total_count: optional number

Total number of items.

success: boolean

Whether the request succeeded.

List integrations

curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/one/integrations \
    -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN"
{
  "errors": [],
  "messages": [],
  "result": [
    {
      "application": {
        "category": "Productivity",
        "display_name": "Google Workspace",
        "logo": "https://onprem.cloudflare.com/static/google_workspace.png"
      },
      "created": "2025-01-15T10:00:00Z",
      "id": "019d2e6a-d995-7185-afbd-4feead9e42ec",
      "is_paused": false,
      "name": "My Google Workspace",
      "status": "Healthy",
      "updated": "2025-04-10T08:30:00Z"
    }
  ],
  "result_info": {
    "count": 1,
    "next": null,
    "page": 1,
    "per_page": 10,
    "previous": null,
    "total_count": 1
  },
  "success": true
}
Returns Examples
{
  "errors": [],
  "messages": [],
  "result": [
    {
      "application": {
        "category": "Productivity",
        "display_name": "Google Workspace",
        "logo": "https://onprem.cloudflare.com/static/google_workspace.png"
      },
      "created": "2025-01-15T10:00:00Z",
      "id": "019d2e6a-d995-7185-afbd-4feead9e42ec",
      "is_paused": false,
      "name": "My Google Workspace",
      "status": "Healthy",
      "updated": "2025-04-10T08:30:00Z"
    }
  ],
  "result_info": {
    "count": 1,
    "next": null,
    "page": 1,
    "per_page": 10,
    "previous": null,
    "total_count": 1
  },
  "success": true
}