GET /external-checkout/sessions/{id}/status - kurnl Developer Docs

Use this from the customer-facing return page after a partner-hosted checkout (CKO-03 / WooCommerce) to show whether provisioning has completed. It is public (no key or secret) and returns only catalog + lifecycle fields — never contact, address, or payment data — so it is safe to call from the browser.

Endpoint

GET /partner/external-checkout/sessions/{session_id}/status

Authentication

None. This is the only external-checkout read that requires no credential. It is rate-limited to 60 requests / minute per IP.

Path parameters

Parameter	Description
`session_id`	The external-checkout session id returned when the session was created.

Response

{
  "status": "completed",
  "provisioned": true,
  "subscription_status": "ACTIVE",
  "plan_name": "Fibre 500/500",
  "provider_name": "Acme Fibre",
  "partner_reference": "wc_order_10432"
}

Field	Type	Meaning
`status`	string	Session lifecycle — `pending`, `redirected`, `completed`, or `unknown`.
`provisioned`	boolean	`true` once a kurnl subscription exists for the session.
`subscription_status`	string \| null	The subscription’s own status (e.g. `ACTIVE`, `PENDING_INSTALL`) once provisioned; `null` before that.
`plan_name`	string \| null	The checked-out plan’s display name.
`provider_name`	string \| null	The ISP the session belongs to.
`partner_reference`	string \| null	Your reference echoed back (e.g. the WooCommerce order id).

TTL / expiry

Semantics match the authenticated GET /external-checkout/sessions/{id}:

pending / redirected sessions past their expiry return 410 Gone.
completed sessions never expire.

Poll every few seconds on the return page until provisioned is true (or subscription_status is ACTIVE), then stop. The endpoint degrades gracefully — a transient backend hiccup still returns the session status rather than a 500.