Guides

Rate Codes

Rate codes let you retrieve different configured pricing tiers — full price, a campaign offer, a special commission rate — through a single integration. One retailer ID, one API key, any number of tiers.

In the API the rate code travels as the providerCode query parameter. Your TTG contact configures the tiers and shares the codes with you during setup; there is no endpoint to list them.

Requesting a Tier

Add providerCode to the inventory call:

1GET /api/v3/events/{eventId}/occurrences/{occurrenceId}/inventory-items?providerCode=campaign-may

Everything else — endpoint, auth, response shape — is identical to a standard inventory call. Only the prices change:

$# Default tier
$curl "https://api.ttix.io/api/v3/events/123/occurrences/456/inventory-items" \
>  -H "X-TT-API-Key: $API_KEY" -H "X-TT-Retailer: $RETAILER_ID"
$
$# Campaign tier — same call, one extra parameter
$curl "https://api.ttix.io/api/v3/events/123/occurrences/456/inventory-items?providerCode=campaign-may" \
>  -H "X-TT-API-Key: $API_KEY" -H "X-TT-Retailer: $RETAILER_ID"
RequestBehavior
No providerCodeDefault tier — identical to today’s behavior. Existing integrations need no changes.
Recognized codePrices reflect that tier’s configuration.
Unrecognized code404 with an error naming the rejected code. A code counts as recognized only when it is configured for your retailer on that event — a typo, an expired code, or a code from another event or retailer is rejected the same way.

The 404 carries error.details.resourceType: "providerCode" and error.details.resourceId set to the rejected code, so you can tell it apart from an event or occurrence that doesn’t exist.

To show multiple tiers concurrently, make one inventory call per code. Each response stands alone.

Purchasing at a Tier

Create the cart with the inventoryItemId and priceOptionId values returned by the tier-priced inventory call, exactly as in the standard Purchase Flow. The held prices match the tier you requested, and the rate is recorded on the resulting order — no extra parameters needed at cart or checkout.

FAQ

Can one call return all tiers at once? No — one tier per call is the contract. Request each code separately.

Do rate codes affect which seats I see? A tier can be configured to apply only to part of the inventory (for example, specific sections). Seats outside that scope still appear, priced at the default tier.

How do I get codes for a new offer? Ask your TTG contact. Tiers are configured on TTG’s side; no integration changes are needed for a new code.

Are codes case-sensitive? Yes. Send them exactly as provided.