GET /accounts/{account_id}/dex/fleet-status/devices

List details of devices using WARP.

Servers

Path parameters

Name Type Required Description
account_id String Yes

Unique Cloudflare account ID.

Query parameters

Name Type Required Description
to String Yes

End of the time range to query. Timestamp can be provided in ISO 8601 datetime format or milliseconds since epoch.

page Number Yes

Page number of paginated results.

Default value: 1

source String No

Source:

  • hourly - device details aggregated hourly, up to 7 days prior
  • last_seen - device details, up to 60 minutes prior. Time windows exceeding 60 minutes will be rejected from June 1st, 2026. Please use 'hourly' or 'raw' instead for longer time ranges.
  • raw - device details, up to 7 days prior

Valid values:

  • "last_seen"
  • "raw"
  • "hourly"

Default value: "last_seen"

platform String No

Operating system.

per_page Number Yes

Number of results per page.

version String No

WARP client version.

device_id String No

Device-specific ID, given as UUID.

colo String No

Cloudflare colo airport code.

status String No

Network status.

mode String No

The mode under which the WARP client is run.

sort_by String No

Dimension to sort results by.

Valid values:

  • "device_id"
  • "mode"
  • "timestamp"
  • "version"
  • "colo"
  • "status"
  • "platform"

Default value: "timestamp"

from String Yes

Start of the time range to query. Timestamp can be provided in ISO 8601 datetime format or milliseconds since epoch.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.