List your labels
Lists the labels you may send as label with an upload. A label is a trade name you sell under. A partner with several labels on one contract gets one row per label. A partner with one label gets that one, and a partner without a label gets an empty list. Labels are display only: the fee, the payout and the attribution follow the partner, never the label.
Partner API key, sent as Authorization: Bearer <key>. Production keys start with jpk_live_ and work only on https://api.joulo.nl. Sandbox keys start with jpk_test_ and work only on https://api-staging.joulo.nl. Sandbox keys minted before September 2026 also start with jpk_live_. A key used on the wrong host returns 401 with a detail. A key is bound to one partner and reaches only the Partner API routes. Any other route returns 404 when it does not exist. A route that needs a scope the key lacks, such as GET /sessions, returns 403 with error: Insufficient scope and a required_scope. Every other route returns 403 with error: partner_api_key_scope. Mint and revoke keys in the partner portal. A partner has one active key at a time.
In: header
Response Body
curl -X GET "https://api.joulo.nl/functions/v1/api/partner/labels"{
"labels": [
{
"label": "liveenergy",
"name": "LiveEnergy"
},
{
"label": "shave-energy",
"name": "Shave Energy"
}
]
}{
"error": "Missing or invalid API token"
}