v32

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-151,1412,2144.5 MB
Purge history

Get purges history list

Get purges history.

get/cdn/purge_statuses

Query parameters

cnamestring

Purges associated with a specific resource CNAME.

Example:

  • &cname=example.com
statusstring

Purge with a certain status.

Possible values:

  • In progress
  • Successful
  • Failed
  • Status report disabled
purge_typestring

Purge requests with a certain purge type.

Possible values:

  • purge_by_pattern - Purge by Pattern.
  • purge_by_url - Purge by URL.
  • purge_all - Purge All.
from_createdstring

Start date and time of the requested time period (ISO 8601/RFC 3339 format, UTC.)

Examples:

  • &from_created=2021-06-14T00:00:00Z
  • &from_created=2021-06-14T00:00:00.000Z
to_createdstring

End date and time of the requested time period (ISO 8601/RFC 3339 format, UTC.)

Examples:

  • &to_created=2021-06-15T00:00:00Z
  • &to_created=2021-06-15T00:00:00.000Z
offsetinteger

Number of purge requests in the response to skip starting from the beginning of the requested period.

limitinteger

Maximum number of purges in the response.

Response

Successful.

OR

Example response

[
  {
    "purge_id": 1,
    "status": "Successful",
    "resource": {
      "id": 1,
      "cname": "cdn.site.com"
    },
    "payload": {
      "urls": [
        "http://example.com/path1/file1.jpg",
        "http://site.example.com/path-18/file2.jpg"
      ]
    },
    "created": "2021-10-29T13:21:01.550849Z",
    "purge_type": "purge_by_url"
  }
]