GET /accounts/{account_id}/images/v2

List up to 10000 images from CF Images, with up to 1000 results per page. Use the optional parameters below to get a specific range of images. Pagination is supported via continuation_token.

Metadata Filtering (Optional):

You can optionally filter images by custom metadata fields using the meta.<field>[<operator>]=<value> syntax.

Supported Operators:

eq / eq:string / eq:number / eq:boolean - Exact match
gt / gt:number - Greater than (number only)
gte / gte:number - Greater than or equal (number only)
lt / lt:number - Less than (number only)
lte / lte:number - Less than or equal (number only)
in / in:string / in:number - Match any value in list (pipe-separated)

Metadata Filter Constraints:

Maximum 5 metadata filters per request
Maximum 5 levels of nesting (e.g., meta.first.second.third.fourth.fifth)
Maximum 10 elements for list operators (in)
Supports string, number, and boolean value types
Range operators (gt, gte, lt, lte) only accept numeric values

Filter Consistency: Filters are combined with AND logic. The system does not validate whether filter combinations are logically consistent. For example, meta.priority[eq:number]=5&meta.priority[lte:number]=3 will return zero results because no value can satisfy both conditions simultaneously. It is the caller's responsibility to ensure filter combinations make sense.

Examples:

# List all images
/images/v2

# Filter by metadata [eq]
/images/v2?meta.status[eq:string]=active

# Filter by metadata [in]
/images/v2?meta.status[in]=pending|deleted|flagged

# Filter by metadata [in:number]
/images/v2?meta.ratings[in:number]=4|5

# Filter by metadata range [gte:number]
/images/v2?meta.priority[gte:number]=1

# Filter by bounded range
/images/v2?meta.priority[gte:number]=1&meta.priority[lte:number]=5

# Filter by nested metadata
/images/v2?meta.region.name[eq]=eu-west

# Combine metadata filters with creator
/images/v2?meta.status[eq]=active&creator=user123

# Multiple metadata filters (AND logic)
/images/v2?meta.status[eq]=active&meta.priority[eq:number]=5

Servers

https://api.cloudflare.com/client/v4

Path parameters

Name	Type	Required	Description
`account_id`	String	Yes

Query parameters

Name	Type	Required	Description
`meta.[]`	String	No	Optional metadata filter(s). Multiple filters can be combined with AND logic. Operators: `eq`, `eq:string`, `eq:number`, `eq:boolean` - Exact match `gt`, `gt:number` - Greater than (number only) `gte`, `gte:number` - Greater than or equal (number only) `lt`, `lt:number` - Less than (number only) `lte`, `lte:number` - Less than or equal (number only) `in`, `in:string`, `in:number` - Match any value in pipe-separated list Examples: `meta.status[eq]=active` `meta.priority[eq:number]=5` `meta.enabled[eq:boolean]=true` `meta.priority[gte:number]=1` `meta.score[lt:number]=100` `meta.region[in]=us-east\|us-west\|eu-west` Note: Filter consistency is not validated. Contradictory filters (e.g., `meta.priority[eq:number]=5&meta.priority[lte:number]=3`) will return zero results.
`sort_order`	String	No	Valid values: `"desc"` `"asc"` Default value: "desc"
`continuation_token`	String	No
`per_page`	Number	No	Default value: 1000
`creator`	String	No

How to start integrating

Add HTTP Task to your workflow definition.
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.
Click Test request to test run your request to the API and see the API's response.