Skip to navigation

Your suppliers

List the suppliers your searches use.

What: the suppliers Kitionz will fan a /search out to for you — on the channel you are calling from and in this environment. Resolved by the SAME authority /search uses, so this list and your search can never disagree.

When: to build a supplier picker, or to check what a key is actually enabled for before debugging an empty search.

Before / After: here → optionally pass a subset of these sourceCodes as supplierCodes on /search.

Gotchas

  • This answers “who is switched on for me”, not “who has inventory for this route”. A supplier listed here can still return zero offers for a given route/date.
  • managed: true means the fare is fetched on Kitionz’s portal login, so those offers come back with booking: { bookable: true, requestBooking: true } — you book on the portal and post the PNR to /bookings/:id/fulfil.
  • An empty list is a real answer, not an error: meta.diagnostics says which gate is blocking each supplier and where to fix it.

Response (trimmed)

{ "data": [
{ "sourceCode": "fdcircle", "name": "FD Circle", "inventoryCategory": "SERIES", "managed": false },
{ "sourceCode": "gapi", "name": "GAPI", "inventoryCategory": "ONLINE", "managed": false }
], "meta": { "count": 2 } }

Authentication

AuthorizationBearer

Your Kitionz API key, sent as Authorization: Bearer keyId:secret. Create a Test key at sandbox.kitionz.com → API keys, a Live key at kitionz.com → API → API keys.

Response

Default Response
successboolean
statusCodedouble
datalist of objects
metaobject