extras

GET /v1/extra-purchases/{purchaseId}

Get an extra purchase.

सर्व extras एंडपॉइंट्स

प्रमाणीकरण

बेरर टोकन म्हणून API की पाठवा. की मध्ये billing.view परवानगी असणे आवश्यक आहे; ती नसलेली की 404 ऐवजी 403 सह नाकारली जाते.

या एंडपॉइंटला कोणतीही संस्था आयडी (organisation id) लागत नाही. तुमची की (key) आधीच ती कोणत्या संस्थेशी संबंधित आहे हे ओळखते आणि प्रतिसाद त्यानुसार मर्यादित केला जातो.

प्रयत्न करा

कोनसांस्कृतिक कंसात (<>) असलेली कोणतीही गोष्ट तुमच्या स्वतःच्या मूल्यांनी बदला आणि key प्लेसहोल्डरला तुमच्या डॅशबोर्डवरील किने बदला.

curl -X GET https://api.zinndigital.com/v1/extra-purchases/{purchaseId} \
  -H "Authorization: Bearer zdk_live_…"

साइन इन केलेले आहे? तुमच्या डॅशबोर्डमधील API कन्सोल तुमची खरी संस्था आयडी आणि तुमची स्वतःची की आपोआप भरतो आणि लाइव्ह API विरुद्ध विनंती कार्यान्वित करतो जेणेकरून तुम्हाला वास्तविक प्रतिसाद पाहता येईल. एपी कन्सोलमध्ये हा एंडपॉइंट उघडा

तपशील

Returns one extra purchase in scope with its status and outcome. Requires `billing.view`.

पॅरामीटर्स

नावप्रकारआवश्यकहे काय आहे
purchaseId (path)UuidहोयThe extra purchase's id.

प्रतिसाद

नावप्रकारआवश्यकहे काय आहे
idUuidहोयUUIDv7 identifier — sortable by creation time (docs/02 §8).
org_idUuidहोयUUIDv7 identifier — sortable by creation time (docs/02 §8).
extra_idUuidहोयUUIDv7 identifier — sortable by creation time (docs/02 §8).
site_idobjectनाही
domain_idobjectनाही
statusExtraPurchaseStatusहोयAn extra purchase's lifecycle state.
categorystringहोय
fulfilment_typeExtraFulfilmentTypeहोयHow an extra is delivered.
intervalExtraIntervalहोयOne-off charge or a recurring subscription.
priceMoneyAmountहोयA money value — integer minor units + an ISO 4217 code (CLAUDE.md §2.8).
recurrencestring<none, active, ended>होयWhether the recurrence behind this purchase is still live. `none` = it never recurred (a one-off); `active` = a scheduled charge exists; `ended` = it recurred and no longer does…
next_renewal_onobjectनाहीThe next charge date, or `null`. Also `null` for a live charge that has no date scheduled yet, so read `recurrence` — not this field — to decide whether a purchase renews at all.
sla_due_atobjectनाही
completed_atobjectनाही
failure_reasonstringनाही
created_atstringहोय
updated_atstringहोय

ही एंडपॉइंट परत करू शकेल अशा त्रुटी

401 · 403 · 404 · 429