billing
GET /v1/pro-discounts
Your hosting-customer discount on every Pro plugin, and your code for each.
Authentication
Send an API key as a bearer token. The key must carry the billing.view permission; a key without it is refused with 403, not 404.
Where your organisation id goes
This endpoint takes org_id as a query parameter. Leave it out and the call covers your whole tenancy subtree; send it to narrow the call to one organisation.
Your organisation id is on the API keys screen in your dashboard, beside the key itself. It is the same id in every call you make.
Try it
Replace anything in angle brackets with your own values, and the key placeholder with a key from your dashboard.
curl -X GET https://api.zinndigital.com/v1/pro-discounts \
-H "Authorization: Bearer zdk_live_…"Signed in? The API console in your dashboard fills in your real organisation id and your own key, and runs the request against the live API so you can see the actual response. Open this endpoint in the API console
Details
Hosting customers get 50% off the first payment of any Zinn® Pro plugin, through one personal code per plugin. This lists every Pro plugin the discount covers (read from the plugin registry, so a newly released Pro appears here with no change), whether your account qualifies — a paid hosting plan, active, in good standing; trials do not qualify — and the code you already hold for each, if any. Requires billing.view. Never calls the store: a code redeemed a minute ago may still read active until you ask for it again or the daily upkeep reads the store.
Parameters
| Name | Type | Required | What it is |
|---|---|---|---|
org_id (query) | string | No | The account to read. Required when you belong to more than one. |
Response
| Name | Type | Required | What it is |
|---|---|---|---|
org_id | string | Yes | — |
eligible | boolean | Yes | Whether this account holds a paid hosting plan, active and in good standing. |
terms | ProDiscountTerms | Yes | The hosting-customer discount's terms, read from the plugin registry. |
offers | ProDiscountOffer[] | Yes | — |
Errors this endpoint can return
401 · 403 · 422