A valid request URL is required to generate request examples{
"customer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"subscriptions": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"plan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"plan": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"key": "<string>",
"name": "<string>"
},
"status": "incomplete",
"current_period_start": "2023-11-07T05:31:56Z",
"current_period_end": "2023-11-07T05:31:56Z",
"cancel_at_period_end": true,
"canceled_at": "2023-11-07T05:31:56Z",
"trial_ends_at": "2023-11-07T05:31:56Z",
"provider": "stripe",
"items": [
{
"quantity": 123,
"price": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"kind": "recurring",
"currency": "<string>",
"amount_minor": 123,
"currency_exponent": 123,
"interval_unit": "<string>",
"interval_count": 123,
"archived": true
}
}
],
"created_at": "2023-11-07T05:31:56Z"
}
],
"can_manage": true
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}What my team pays
The team’s subscriptions from the mirror, newest first, every status included — a cancelled one is what somebody is looking at when they ask why the team lost access. Each carries its plan (id, key, name), its items (the price and quantity actually billed, with currency_exponent so a screen never divides by a guessed 100), the period, and cancel_at_period_end.
The active customer is X-Customer-Id, or the oldest membership when the header is absent — the header identifies, the membership authorizes. Every member may read this: the plan a team is on is as visible as its roster. can_manage says whether this caller may also perform the money acts below, so a screen renders read-only for a member without a probe that would 403.
It needs a verified session, like the rest of the team surface. An anonymous session answers 404, which is true rather than a refusal: it belongs to no customer.
A valid request URL is required to generate request examples{
"customer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"subscriptions": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"plan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"plan": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"key": "<string>",
"name": "<string>"
},
"status": "incomplete",
"current_period_start": "2023-11-07T05:31:56Z",
"current_period_end": "2023-11-07T05:31:56Z",
"cancel_at_period_end": true,
"canceled_at": "2023-11-07T05:31:56Z",
"trial_ends_at": "2023-11-07T05:31:56Z",
"provider": "stripe",
"items": [
{
"quantity": 123,
"price": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"kind": "recurring",
"currency": "<string>",
"amount_minor": 123,
"currency_exponent": 123,
"interval_unit": "<string>",
"interval_count": 123,
"archived": true
}
}
],
"created_at": "2023-11-07T05:31:56Z"
}
],
"can_manage": true
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}Autorizações
A contact session token, uk_ct_…. Belongs to one of the developer's own users, and reads only that user's data.
Cabeçalhos
The customer this call is acting inside — the same arrangement as X-Organization-Id, one plane down. Switching customers is navigation, not a mutation: nothing is stored, you send a different header, and the membership JOIN behind it decides what you may do there. An id you are not a member of matches no row and answers 404. Absent, the contact's oldest membership answers.