---
title: "Get Customer State"
method: GET
path: "/v1/customers/{id}/state"
tags: ["customers", "public"]
---

# Get Customer State

`GET /v1/customers/{id}/state`

Get a customer state by ID.

The customer state includes information about
the customer's active subscriptions and benefits.

It's the ideal endpoint to use when you need to get a full overview
of a customer's status.

**Scopes**: `customers:read` `customers:write`

## Path parameters

- `id` string, uuid4, required — The customer ID.

## Response `200`

Successful Response

- CustomerState — unresolved $ref

## Other responses

- `404` — Customer not found.
- `422` — Validation Error

---

[API](https://skmtc.net/polar/apis/polar-api.md) · [All operations](https://skmtc.net/polar/apis/polar-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/polar/polar-api/revisions/77e4ef94fcc3/schema)