---
title: "One catalog push's state and counts"
method: GET
path: "/v1/pushes/{push_id}"
tags: ["Store"]
---

# One catalog push's state and counts

`GET /v1/pushes/{push_id}`

## Request

- Base URL: `https://carbonguru.io`
- URL: `https://carbonguru.io/v1/pushes/{push_id}`
- Auth: HTTP bearer

The push record is a file_import_jobs row whose id is the push id. sessions lists every session the push produced — a push spans more than one when its rows span countries or exceed the worker's group cap. completed_at is absent: the worker writes it, and the shipped status route does not return the column.

## Path parameters

- `push_id` string, required

## Response `200`

The platform's payload, passed through unchanged.

- object

## Other responses

- `401`: No valid credential. Every authentication failure returns this one document.
- `402`: The account's plan does not include this capability. Carries min_tier and upgrade_url.
- `403`: A missing scope, an exhausted analysis allowance, or an object that is not the caller's.
- `404`: No such resource.

---

[API](https://skmtc.dev/carbonguru/apis/carbonguru-api.md) · [All operations](https://skmtc.dev/carbonguru/apis/carbonguru-api/llms.txt) · [OpenAPI document](https://skmtc.dev/carbonguru/apis/carbonguru-api/revisions/26dcbe7a8500?raw)