Skip to content
Start here

List applications

client.zeroTrust.resourceLibrary.applications.list(ApplicationListParams { account_id, fields, filter, 4 more } params, RequestOptionsoptions?): SinglePage<ApplicationListResponse { id, application_confidence_score, application_score_composition, 16 more } >
GET/accounts/{account_id}/resource-library/applications

List the applications available to an account, both the applications Cloudflare curates and the custom applications the account has defined.

Results are paginated. Use filter and search to narrow the list, order_by to sort it, and fields to reduce each result to only the properties you need.

The authenticated principal must have access to the account identified by account_id.

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
ParametersExpand Collapse
params: ApplicationListParams { account_id, fields, filter, 4 more }
account_id: string

Path param: Account ID.

fields?: string

Query param: Return only the listed properties on each application, as a comma-separated list. Use this to keep responses small when you only need part of each application — for example populating a picker with fields=id,name instead of downloading every hostname and IP subnet.

Omit this parameter to receive the full application object.

id is always returned.

Selectable properties: id, name, human_id, version, hostnames, support_domains, ip_subnets, port_protocols, supported, gen_ai_score, application_confidence_score, created_at, updated_at, review_status.

Unknown or empty property names return 400.

filter?: string

Query param: Filter applications using key:value format. Supported filter keys:

  • name: Filter by application name (e.g., name:HR)
  • id: Filter by application ID (e.g., id:498)
  • human_id: Filter by human-readable ID (e.g., human_id:HR)
  • hostname: Filter by hostname or support domain (e.g., hostname:portal.example.com)
  • source: Filter by application source name (e.g., source:cloudflare)
  • ip_subnet: Filter by IP subnet using CIDR containment — returns applications where any stored subnet contains the search value (e.g., ip_subnet:10.0.1.5/32 matches apps with 10.0.0.0/16)
  • category_id: Filter by category ID (e.g., category_id:12).
  • category_name: Filter by category name (e.g., category_name:HR).
  • supported: Filter by supported Cloudflare product (e.g., supported:ACCESS). Values: GATEWAY, ACCESS, CASB.
  • review_status: Filter by the account’s Gateway review status. Values: approved, unapproved, in_review, unreviewed. .
limit?: number

Query param: Limit of number of results to return (max 250).

offset?: number

Query param: Offset of results to return.

order_by?: string

Query param: Order results using field:direction format. Supported fields are name, id, human_id, category_id, application_type, application_confidence_score, and gen_ai_score. Supported directions are asc and desc. Ignored when search is provided; results are ranked by relevance instead.

ReturnsExpand Collapse
ApplicationListResponse { id, application_confidence_score, application_score_composition, 16 more }

Describes one application in a list response. This endpoint returns every property below unless the fields query parameter narrows the response, so treat all of them except id as optional.

id: number

Returns the application ID.

formatint64
maximum4294967295
minimum0
application_confidence_score?: number

Confidence score for the application. Returns -1 when no score is available.

formatfloat
application_score_composition?: unknown

Returns the score composition breakdown for the application.

application_source?: string

Returns the application source.

application_type?: string

Returns the application type.

application_type_description?: string

Returns the application type description.

category_id?: number

Returns the category ID.

formatint64
maximum4294967295
minimum1
created_at?: string

Returns the application creation time.

gen_ai_score?: number

GenAI score for the application. Returns -1 when no score is available.

formatfloat
hostnames?: Array<string>

Hostnames matched by the application.

human_id?: string

Returns the human readable ID.

ip_subnets?: Array<string>

IP subnets matched by the application.

name?: string

Returns the application name.

port_protocols?: Array<string>

Port and protocol pairs matched by the application.

review_status?: "approved" | "unapproved" | "in_review" | "unreviewed"

The account-specific Gateway review status. Applications with no assigned review status are returned as unreviewed.

One of the following:
"approved"
"unapproved"
"in_review"
"unreviewed"
support_domains?: Array<string>

Support domains matched by the application.

supported?: Array<"GATEWAY" | "ACCESS" | "CASB">

Cloudflare products that support this application.

One of the following:
"GATEWAY"
"ACCESS"
"CASB"
updated_at?: string

Returns the application update time.

version?: string

Returns the application version.

List applications

import Cloudflare from 'cloudflare';

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

// Automatically fetches more pages as needed.
for await (const applicationListResponse of client.zeroTrust.resourceLibrary.applications.list({
  account_id: '023e105f4ecef8ad9ca31a8372d0c353',
})) {
  console.log(applicationListResponse.id);
}
{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "success": true,
  "result": [
    {
      "id": 498,
      "application_confidence_score": 0.92,
      "application_score_composition": {
        "categories": [
          {
            "confidence": 0.95,
            "name": "Security"
          }
        ],
        "plan": "free"
      },
      "application_source": "cloudflare",
      "application_type": "Human Resources",
      "application_type_description": "Applications used to manage employees and workforce tools.",
      "category_id": 12,
      "created_at": "2025-01-01T00:00:00Z",
      "gen_ai_score": 1.5,
      "hostnames": [
        "example.com",
        "foo.com"
      ],
      "human_id": "HR",
      "ip_subnets": [
        "192.168.1.0/24",
        "10.0.0.0/8"
      ],
      "name": "HR",
      "port_protocols": [
        "tcp/80",
        "tcp/443"
      ],
      "review_status": "approved",
      "support_domains": [
        "example.com",
        "foo.com"
      ],
      "supported": [
        "GATEWAY",
        "ACCESS"
      ],
      "updated_at": "2025-01-01T00:00:00Z",
      "version": "2025-01-01T00:00:00Z"
    }
  ],
  "result_info": {
    "count": 1,
    "page": 1,
    "per_page": 20,
    "total_count": 2000
  }
}
Returns Examples
{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "success": true,
  "result": [
    {
      "id": 498,
      "application_confidence_score": 0.92,
      "application_score_composition": {
        "categories": [
          {
            "confidence": 0.95,
            "name": "Security"
          }
        ],
        "plan": "free"
      },
      "application_source": "cloudflare",
      "application_type": "Human Resources",
      "application_type_description": "Applications used to manage employees and workforce tools.",
      "category_id": 12,
      "created_at": "2025-01-01T00:00:00Z",
      "gen_ai_score": 1.5,
      "hostnames": [
        "example.com",
        "foo.com"
      ],
      "human_id": "HR",
      "ip_subnets": [
        "192.168.1.0/24",
        "10.0.0.0/8"
      ],
      "name": "HR",
      "port_protocols": [
        "tcp/80",
        "tcp/443"
      ],
      "review_status": "approved",
      "support_domains": [
        "example.com",
        "foo.com"
      ],
      "supported": [
        "GATEWAY",
        "ACCESS"
      ],
      "updated_at": "2025-01-01T00:00:00Z",
      "version": "2025-01-01T00:00:00Z"
    }
  ],
  "result_info": {
    "count": 1,
    "page": 1,
    "per_page": 20,
    "total_count": 2000
  }
}