reseller

GET /v1/reseller/plugin-affiliates

The Pro-plugin affiliate programmes a reseller can earn commission from.

All reseller endpoints

All developer docs →

Zinn®, our Viking, hammering at his anvil beside an API endpoint sending events to several listeners.

Authentication

Send an API key as a bearer token. The key must carry the reseller.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/reseller/plugin-affiliates \
  -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

Every active, visible Freemius affiliation programme across our Pro plugins, with the commission Freemius holds today (never a typed figure) and where to apply. Licences sold through these programmes are sold under the Zinn® brand; the reseller earns the commission (owner ruling 2026-11-13, "A: affiliate link"). complete is false only when Freemius was asked and could not answer, so a short list is never read as "none". A product Freemius says has no programme is in without_programme; one that cannot be checked (no key pair, e.g. a bundle) is in skipped with its reason. Neither makes the list incomplete. Cached for an hour. 404 when the org has no reseller programme. Requires reseller.view.

Parameters

NameTypeRequiredWhat it is
org_id (query)UuidNoWhich of your organizations this applies to. Required only when you belong to more than one here — otherwise it is inferred, and an id outside your direct memberships is a 404…

Response

NameTypeRequiredWhat it is
enabledbooleanYesFalse when Zinn® staff turned the Pro-plugin affiliate programmes off for this reseller (then programmes is empty). Commission already earned is never clawed back.
completebooleanYesFalse only when Freemius was asked about a product and could not answer (an HTTP error or no connection); the list may be short and a retry may help. No programme, or a product…
programmesResellerPluginAffiliateProgramme[]Yes—
without_programmeobject[]YesProducts Freemius answered for with no active, visible affiliate programme.
skippedobject[]YesProducts that were not asked, with why (no_keys, no key pair on the platform, e.g. a bundle).

Errors this endpoint can return

401 · 403 · 404 · 429