---
title: "Poll self-billing checkout"
method: GET
path: "/portal/billing/checkout/{id}"
tags: ["SelfBilling"]
---

# Poll self-billing checkout

`GET /portal/billing/checkout/{id}`

## Request

- Base URL: `https://us.api.flexprice.io/v1`
- URL: `https://us.api.flexprice.io/v1/portal/billing/checkout/{id}`
- Auth: API key in header `x-api-key`

Reports the caller tenant's checkout and activates the tenant once it is paid.

## Path parameters

- `id` string, required

## Response `200`

OK

- SelfBillingCheckoutResponse
  - `checkout_id` string
  - `status` 'initiated' | 'pending' | 'completed' | 'failed' | 'expired'
  - `tenant_status` 'trialing' | 'active' | 'suspended'
  - `terminal` boolean
  - `url` string

## Other responses

- `404`: Checkout not found
- `500`: Server error

## Changes

- **2026-10-20** `a24bd13338e3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/flexprice/apis/flexprice-api/changes/portal/billing/checkout/:id/get.md)

---

[API](https://skmtc.dev/flexprice/apis/flexprice-api.md) - [All operations](https://skmtc.dev/flexprice/apis/flexprice-api/llms.txt) - [OpenAPI document](https://skmtc.dev/flexprice/apis/flexprice-api/revisions/84cb4a3af400?raw)