---
title: "Get Confirm Progress"
method: GET
path: "/carts/{cart_id}/confirm-progress"
tags: ["Carts"]
---

# Get Confirm Progress

`GET /carts/{cart_id}/confirm-progress`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/carts/{cart_id}/confirm-progress`
- Auth: none declared

A multi-stay confirm's progress: one status per stay, plus payment.

Poll it while ``POST /carts/{id}/confirm`` is in flight; it never waits
on the confirm's locks. A terminal cart reads its committed outcome.

## Path parameters

- `cart_id` integer, required

## Headers

- `authorization` string, nullable
- `API-Version` '1'

## Cookies

- `tp_cart` string, nullable

## Response `200`

Successful Response

- CartConfirmProgressResponse: ``GET /carts/{id}/confirm-progress`` — per stay plus one payment row. Never exposes the provider phase. ``confirmed`` and ``failed`` come from the committed cart; ``checking`` is manual recovery or a confirm that stopped reporting.
  - `cart_id` integer, required
  - `status` 'not_started' | 'in_progress' | 'confirmed' | 'failed' | 'checking', required
  - `payment` 'authorized' | 'captured' | 'released' | 'refunded' | 'unknown', nullable
  - `stays` ConfirmStayProgress[]: Every stay, in date order.
    - `stay_id` integer, required
    - `property_id` integer, required
    - `status` 'waiting' | 'booking' | 'done' | 'failed' | 'cancelled', required: waiting, booking, done, failed (could not book), or cancelled (undone by an unwind after another stay failed).
    - `check_in` string, date, nullable: The stay's earliest line check-in.
    - `check_out` string, date, nullable: The stay's latest line check-out.
    - `cause` 'unavailable' | 'other', nullable: On a ``failed`` stay after an unwind: ``unavailable`` when its park said the room or site was no longer available, else ``other``. Null on every other stay.
  - `updated_at` string, date-time, nullable
  - `checkout_code` string, nullable: The ``TPC-`` display code of a 2+ stay cart: the reference the guest quotes to Total Parks, also after an unwind.
  - `grand_total` string, nullable: The cart total: the amount authorised, refunded, or released.
  - `currency` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/totalparks/apis/total-parks-public-api.md) · [All operations](https://skmtc.dev/totalparks/apis/total-parks-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/totalparks/apis/total-parks-public-api/revisions/dcb4c822e2c6?raw)
