Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Talon.One Loyalty API

Loyalty program balances, points, cards, and transactions.

Talon.One Loyalty API is one of 13 APIs that Talon.One publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Loyalty. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 6 operations across 6 paths. It is described by OpenAPI 3.0.3, at version 1.0.

Requests are made against a single base URL, https://yourbaseurl.talon.one.

6 operations 6 paths 0 schemas 3 GET2 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.0
Base URL
https://yourbaseurl.talon.one
Authentication
API Key, API Key
Contact
Resource Areas
1

Authentication & Security 2

Talon.One Loyalty API declares 2 security schemes for authenticating requests. An API key is passed in the header as Authorization (integrationKey). An API key is passed in the header as Authorization (managementKey). By default, every request must be authenticated.

  • integrationKey — Integration API key with the ApiKey-v1 prefix, e.g. header "Authorization: ApiKey-v1 ".
  • managementKey — Management API key with the ManagementKey-v1 prefix, e.g. header "Authorization: ManagementKey-v1 ".

Paths & Operations 6

Across 6 paths, the API surfaces 6 operations — 3 GET, 2 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Loyalty 6

Loyalty program balances, points, cards, and transactions.

GET
/v1/loyalty_programs/{loyaltyProgramId}/profile/{integrationId}/points
Get customer's loyalty points
getLoyaltyProfilePoints 2 params → 200
GET
/v1/loyalty_programs/{loyaltyProgramId}/profile/{integrationId}/balances
Get customer's loyalty balances
getLoyaltyBalances 2 params → 200
POST
/v1/loyalty_programs/{loyaltyProgramId}/activate_points
Activate pending points
activateLoyaltyPoints 1 param → 204
PUT
/v1/loyalty_programs/{loyaltyProgramId}/profile/{integrationId}/add_points
Add points to customer
addLoyaltyPoints 2 params body → 204
GET
/v1/loyalty_programs
List loyalty programs
listLoyaltyPrograms → 200
POST
/v1/loyalty_programs/{loyaltyProgramId}/cards/batch
Create loyalty cards
createLoyaltyCards 1 param body → 200

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

talon-one-loyalty-api-openapi.yml Raw ↑

Other APIs Talon.One publishes across the network.

Talon.One Account API
Talon.One Applications API
Talon.One Attributes API
Talon.One Audiences API
Talon.One Campaigns API
Talon.One Collections API
Talon.One Coupons API
Talon.One Customer Profiles API
Talon.One Customer Sessions API
Talon.One Events API
Talon.One Exports API
Talon.One Referrals API