---
title: "Get purges history list"
method: GET
path: "/cdn/purge_statuses"
tags: ["Purge history"]
---

# Get purges history list

`GET /cdn/purge_statuses`

Get purges history.

## Query parameters

- `cname` string
- `status` string — Purge with a certain status. Possible values: - **In progress** - **Successful** - **Failed** - **Status report disabled**
- `purge_type` string — 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_created` string
- `to_created` string
- `offset` integer
- `limit` integer

## Response `200`

Successful.

- union
  - PurgeStatusResponse[]
    - `purge_id` integer — Purge ID.
    - `status` 'In progress' | 'Successful' | 'Failed' — Purge status. Possible values: - **In progress** - Purge is in progress. - **Successful** - Purge was successful. - **Failed** - Purge failed.
    - `resource` Resource
      - `id` integer — Resource ID.
      - `cname` string — CNAME of the resource.
    - `payload` Payload — Purge payload depends on purge type. Possible values: - **urls** - Purge by URL. - **paths** - Purge by Pattern and purge All.
    - `created` string — Date and time when the purge was created (ISO 8601/RFC 3339 format, UTC).
    - `purge_type` string — Contains the name of the purge request type. Possible values: - **`purge_by_pattern`** - Purge by Pattern. - **`purge_by_url`** - Purge by URL. - **`purge_all`** - Purge All.
  - object
    - `count` integer, required — Total number of items.
    - `next` string, nullable, required — URL to the next page of results. Null if current page is the last one.
    - `previous` string, nullable, required — URL to the previous page of results. Null if current page is the first one.
    - `results` PurgeStatusResponse[], required — List of items on the current page.
      - `purge_id` integer — Purge ID.
      - `status` 'In progress' | 'Successful' | 'Failed' — Purge status. Possible values: - **In progress** - Purge is in progress. - **Successful** - Purge was successful. - **Failed** - Purge failed.
      - `resource` Resource
        - `id` integer — Resource ID.
        - `cname` string — CNAME of the resource.
      - `payload` Payload — Purge payload depends on purge type. Possible values: - **urls** - Purge by URL. - **paths** - Purge by Pattern and purge All.
      - `created` string — Date and time when the purge was created (ISO 8601/RFC 3339 format, UTC).
      - `purge_type` string — Contains the name of the purge request type. Possible values: - **`purge_by_pattern`** - Purge by Pattern. - **`purge_by_url`** - Purge by URL. - **`purge_all`** - Purge All.

---

[API](https://skmtc.net/g-core/apis/gcore-openapi.md) · [All operations](https://skmtc.net/g-core/apis/gcore-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/g-core/gcore-openapi/revisions/09e652815095/schema)