billing

GET `/v1/subscriptions`

List the organization's subscriptions.

Gbogbo àwọn ìwé àṣẹ olùgbékalẹ̀ àgbékalẹ̀ →

Ìfàṣẹ́pọ̀

Fi bọ́ọ̀lù (bearer token) ranṣẹ gẹ́gẹ́ bí kọ́kọ́rọ́ API. Kọ́kọ́rọ́ náà gbọ́dọ̀ ní ìyọ̀ǹda billing.view; a ó kọ̀ ọ́ silẹ pẹlu 403, kii ṣe 404, ti kọ́kọ́rọ́ náà kò bá ní i.

Ibùdó àmì ìdánimọ̀ ilé-iṣẹ́ rẹ sí

Oju-iwọle yii nlo org_id gẹgẹbi ayẹwo ibeere. Fi silẹ ni ita yoo si bo igi iyalo rẹ lapapọ; ranṣẹ si lati dín ibeere naa kù si ajọ kan.

Id àjọ rẹ wa lórí ojú-ìwákòòkò àwọn bọ́tìnnì API nínú daṣibọọdú rẹ, lẹ́gbẹ̀ẹ́ bọ́tìnnì náà gan-an. Ó jẹ́ ìd kan náà nínú gbogbo ìpè tí o bá ṣe.

Gbiyanju rẹ

Rọ́pọ̀ èyíkéyìí nínú àwọn àmì ìtọ́ka < > pẹ̀lú iye tirẹ̀, àti àmì ìdánimọ̀ bọ́tìnnì náà pẹ̀lú bọ́tìnnì kan láti inú dásibọ̀ọ̀dù rẹ.

curl -X GET https://api.zinndigital.com/v1/subscriptions \
  -H "Authorization: Bearer zdk_live_…"

Ṣé o ti wọlé? Iwọ̀n api ní nú ìgbékalẹ̀ rẹ kún id àjọ gidi rẹ ati bọtini tirẹ, o si nṣiṣẹ ibeere na lòdì si api gidi ki o le rii esi gidi na. Ṣí ojú abáná yìí sílẹ̀ nínú kọnsólù API

Àwọn kúlẹ̀kúlẹ̀

The subscriptions in scope — each pins the exact plan version it was sold and carries the captured price + entitlements (a purchase-time snapshot, never re-derived from the live catalog, docs/05 §1). Cursor-paginated, RLS-scoped; requires billing.view.

Àwọn ìpìlẹ̀

Orúkọ	Iru	Tí a nílò	Kini o jẹ
`X-Zinn-Org (header)`	`string`	Bẹẹkọ	Which organisation this call acts for. Send a client organisation's id and every org-scoped endpoint answers for that client alone; omit it and the answer covers everything…
`cursor (query)`	`string`	Bẹẹkọ	Opaque cursor from a previous page's `page.next_cursor`.
`limit (query)`	`integer`	Bẹẹkọ	Maximum items to return (page size).
`status (query)`	`SubscriptionStatus`	Bẹẹkọ	Filter by subscription status.
`org_id (query)`	`Uuid`	Bẹẹkọ	Restrict to one organization in scope.

Idahun

Orúkọ	Iru	Tí a nílò	Kini o jẹ
`data`	`Subscription[]`	Bẹẹni	—
`page`	`PageMeta`	Bẹẹni	—

Awọn aṣiṣe ti ibudo ipari yii le da pada

401 · 403 · 422 · 429