Cloudflare API | Durable Objects › Namespaces › Objects › List Objects

API Reference

Account & User Management

Resource Sharing

AI

Certificate Management

Certificate Authorities

Client Certificates

Custom Certificates

Custom Hostnames

Keyless Certificates

MTLS Certificates

Origin CA Certificates

Origin Post Quantum Encryption

Origin TLS Client Auth

Cloudflare One

DNS

Account Custom Nameservers

Domain/Zone Management

IP Addresses

Media

Networking

Magic Network Monitoring

Network Interconnects

Observability

Security Center

Radar

Routing & Performance

Rules

Cloud Connector

Managed Transforms

URL Normalization

Security

Content Scanning

Leaked Credential Checks

Storage & Databases

Threat Intelligence

Brand Protection

Workers & Pages

Durable Objects

List Namespaces

Workers For Platforms

Shared

Durable Objects

durable_objects

Durable Objects

Namespaces

durable_objects.namespaces

Methods

List Namespaces -> SinglePage<

>

get/accounts/{account_id}/workers/durable_objects/namespaces

Returns the Durable Object namespaces owned by an account.

Domain types

Namespace = { id, class, name, 3 more... }

Durable Objects Namespaces

Objects

durable_objects.namespaces.objects

Methods

List Objects -> CursorLimitPagination<

>

get/accounts/{account_id}/workers/durable_objects/namespaces/{id}/objects

Returns the Durable Objects in a given namespace.

Security

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

Example: Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

Accepted Permissions (at least one required)

Workers Scripts Write Workers Scripts Read

Parameters

account_id: string

(maxLength: 32)

Identifier

id: string

ID of the namespace.

cursor: string

Optional

Opaque token indicating the position from which to continue when requesting the next set of records. A valid value for the cursor can be obtained from the cursors object in the result_info structure.

limit: number

Optional

(maximum: 10000, minimum: 10)

The number of objects to return. The cursor attribute may be used to iterate over the next batch of objects if there are more than the limit.

Response fields

errors: Array<

>

messages: Array<

>

success: true

Whether the API call was successful

result: Array<

>

Optional

result_info: { count, cursor, page, 2 more... }

Optional

Request example

curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/workers/durable_objects/namespaces/$ID/objects \
    -H "X-Auth-Email: $CLOUDFLARE_EMAIL" \
    -H "X-Auth-Key: $CLOUDFLARE_API_KEY"

200Example

{
  "errors": [
    {
      "code": 1000,
      "message": "message"
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message"
    }
  ],
  "success": true,
  "result": [
    {}
  ],
  "result_info": {
    "count": 1,
    "cursor": "AAAAANuhDN7SjacTnSVsDu3WW1Lvst6dxJGTjRY5BhxPXdf6L6uTcpd_NVtjhn11OUYRsVEykxoUwF-JQU4dn6QylZSKTOJuG0indrdn_MlHpMRtsxgXjs-RPdHYIVm3odE_uvEQ_dTQGFm8oikZMohns34DLBgrQpc",
    "page": 1,
    "per_page": 20,
    "total_count": 2000
  }
}

Domain types

DurableObject = { id, hasStoredData }