Programs API

Get protection prices for one item or many in one call: for example, a page of search results, or the customer's cart at checkout.

Sessions. The first call returns a session_id. Send it on every later call for the same customer's purchase, so Teak offers the same protection throughout. Start a new session for each purchase, and never reuse one after the order is placed. See Sessions.

Prices. premium is the protection price for the item. For the same item on the same session, it's the price the customer confirms. If the item changes, for example its cost or event times, call the Programs API again.

One error fails the whole call. If any item can't be priced, for example because its product type isn't mapped, the call fails and returns no prices. The error names the item. Fix or leave out that item and call again.

Items. Items that cost 0 are left out of the response. Each item in the response has your reference_id, so give each item in a call its own reference_id.

Server only. Call this from your server, with an access token. A request with the widget's public key returns 401.

Errors return the HTTP status with a body of msg and type, or a list of field errors for an invalid body. See Error handling.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Server-to-server and AI integrations are for enterprise partners only. Teak Solutions Team works with partners to determine the appropriate integration solution.

Deprecated in 2027

The Programs API and the current way of placing server-to-server orders will be deprecated in 2027. The four integration steps stay the same. See Coming soon.

Body Params

The items to price, and where the customer is.

string
required

ISO 4217 code for item costs and protection prices, such as USD. Use the same currency for every call on a session.

string
required

The language and region for the response, such as en_US.

location
object
required

Where the customer is. Teak uses it to choose protection that's available to them. Send country (with region in the US and Canada), or ip_address. Teak tries them in that order and uses the first it can resolve.

The session for this customer's purchase, from an earlier response. Leave it out to start a session. An empty string returns 422.

items
array of objects
required

The items to price.

items*
Responses

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json