Talon.One

Talon.One Loyalty cards API

Represents loyalty cards. [Loyalty cards](https://docs.talon.one/docs/product/loyalty-programs/card-based/card-based-overview) allow your customers to collect and spend loyalty points within a card-based loyalty program.

GitHub OpenAPI
Business capability
Loyalty & Retention Management BC-420.40

Operations 19

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /v2/loyalty_programs/{loyaltyProgramId}/cards/{loyaltyCardId}/link_profile Link a customer profile to a loyalty card · Link customer profile to card #
Ask an LLM
“How do I register a physical loyalty card to a customer's account?”
“Can a shopper attach an anonymous loyalty card to their profile after signing up?”
Tell an agent
Link customer {integrationId} to loyalty card {loyaltyCardId} in program {loyaltyProgramId}.
Register card {loyaltyCardId} to profile {integrationId} in card-based program {loyaltyProgramId}.
POST /v2/loyalty_programs/{loyaltyProgramId}/cards/{loyaltyCardId}/unlink_profile Unlink a customer profile from a loyalty card · Unlink customer profile from a loyalty card #
Ask an LLM
“How do I detach a customer from a loyalty card they no longer use?”
“Can I remove one profile from a card that's shared by several customers?”
Tell an agent
Unlink customer {integrationId} from loyalty card {loyaltyCardId} in program {loyaltyProgramId}.
Detach profile {integrationId} from card {loyaltyCardId} of program {loyaltyProgramId}.
GET /v1/loyalty_programs/{loyaltyProgramId}/cards/{loyaltyCardId}/balances Get a loyalty card's point balances · Get card's point balances #
Ask an LLM
“How many points are on a customer's loyalty card right now?”
“Can I check a card's balance in one subledger as of a past date?”
Tell an agent
Get the points balance of loyalty card {loyaltyCardId} in program {loyaltyProgramId}.
Show card {loyaltyCardId}'s balance in subledger {subledgerId} of program {loyaltyProgramId} as of {endDate}.
GET /v1/loyalty_programs/{loyaltyProgramId}/cards/{loyaltyCardId}/transactions List a loyalty card's transactions in real time · List card's transactions #
Ask an LLM
“Where can my checkout app show the latest points earned and spent on a card, via the Integration API?”
“Can I see only a card's redemption transactions within a date range?”
Tell an agent
List the real-time transactions on loyalty card {loyaltyCardId} in program {loyaltyProgramId}.
Show Integration API {loyaltyTransactionType} transactions for card {loyaltyCardId} in program {loyaltyProgramId} since {startDate}.
GET /v1/loyalty_programs/{loyaltyProgramId}/cards/{loyaltyCardId}/points List a loyalty card's unused points · List card's unused loyalty points #
Ask an LLM
“Which point batches on a loyalty card are still unspent, and when do they expire?”
“Can I list only the pending points on a card?”
Tell an agent
List the unused points on loyalty card {loyaltyCardId} in program {loyaltyProgramId}.
Show card {loyaltyCardId}'s unspent points with status {status} in program {loyaltyProgramId}.
POST /v1/loyalty_programs/{loyaltyProgramId}/cards Generate a single loyalty card · Generate loyalty card #
Ask an LLM
“How do I issue one new loyalty card on demand when a customer signs up in store?”
“Can a newly generated card be linked to customer profiles right away?”
Tell an agent
Generate one new loyalty card in program {loyaltyProgramId}.
Generate a card in program {loyaltyProgramId} linked to customers {customerProfileIds}.
GET /v1/loyalty_programs/{loyaltyProgramId}/cards List loyalty cards in a program · List loyalty cards #
Ask an LLM
“Which loyalty cards have been issued in my card-based program?”
“Can I find all cards belonging to one batch or linked to one customer profile?”
Tell an agent
List the loyalty cards in program {loyaltyProgramId}.
Find cards in program {loyaltyProgramId} from batch {batchId}.
POST /v1/loyalty_programs/{loyaltyProgramId}/import_cards Import loyalty cards from a CSV file · Import loyalty cards #
Ask an LLM
“How do I bring my existing physical card numbers into a card-based program?”
“What columns does the loyalty card import file need?”
Tell an agent
Import the loyalty cards in {upFile} into program {loyaltyProgramId}.
Upload card CSV {upFile} to card-based program {loyaltyProgramId}.
POST /v1/loyalty_programs/{loyaltyProgramId}/cards/batch Create a batch of loyalty cards · Create loyalty cards #
Ask an LLM
“Can I mint thousands of loyalty card codes at once for a print run?”
“How do I control the code format when creating cards in bulk?”
Tell an agent
Create {numberOfCards} loyalty cards in program {loyaltyProgramId}.
Create a batch {batchId} of {numberOfCards} cards in program {loyaltyProgramId}.
GET /v1/loyalty_programs/{loyaltyProgramId}/export_card_balances Export balances of all loyalty cards to CSV · Export all card transaction logs #
Ask an LLM
“How do I get a spreadsheet of every card's points balance in a program?”
“Can I export all card balances as of a specific end date?”
Tell an agent
Export the balances of every card in loyalty program {loyaltyProgramId}.
Download card balances for program {loyaltyProgramId} as of {endDate}.
GET /v1/loyalty_programs/{loyaltyProgramId}/cards/export Export loyalty cards to CSV · Export loyalty cards #
Ask an LLM
“Can I download the list of cards issued in a program, including who they're linked to?”
“What cards were created in a given batch or date window?”
Tell an agent
Export the loyalty cards of program {loyaltyProgramId} to CSV.
Export cards from batch {batchId} in program {loyaltyProgramId} created after {createdAfter}.
DELETE /v1/loyalty_programs/{loyaltyProgramId}/cards/{loyaltyCardId} Delete a loyalty card · Delete loyalty card #
Ask an LLM
“How do I permanently remove a loyalty card from a program?”
“Can I delete a card that was issued by mistake?”
Tell an agent destructive · confirm first
Delete loyalty card {loyaltyCardId} from program {loyaltyProgramId}.
Permanently remove card {loyaltyCardId} in loyalty program {loyaltyProgramId}.
PUT /v1/loyalty_programs/{loyaltyProgramId}/cards/{loyaltyCardId} Activate or deactivate a loyalty card · Update loyalty card #
Ask an LLM
“How do I deactivate a customer's loyalty card temporarily?”
“Can I switch an inactive card back to active?”
Tell an agent
Set loyalty card {loyaltyCardId} in program {loyaltyProgramId} to status {status}.
Deactivate card {loyaltyCardId} in program {loyaltyProgramId}.
GET /v1/loyalty_programs/{loyaltyProgramId}/cards/{loyaltyCardId} Get a loyalty card · Get loyalty card #
Ask an LLM
“What are the status and linked profiles of a specific loyalty card?”
“Can I look up one card by its ID to see its details?”
Tell an agent
Get loyalty card {loyaltyCardId} in program {loyaltyProgramId}.
Show the details of card {loyaltyCardId} from loyalty program {loyaltyProgramId}.
PUT /v1/loyalty_programs/{loyaltyProgramId}/cards/{loyaltyCardId}/add_points Add loyalty points to a card · Add points to card #
Ask an LLM
“How do I top up points on a loyalty card manually?”
“Can points I add to a card be set to expire on a certain date?”
Tell an agent
Add {points} points to loyalty card {loyaltyCardId} in program {loyaltyProgramId}.
Credit card {loyaltyCardId} with {points} points in program {loyaltyProgramId}, valid until {validUntil}.
PUT /v1/loyalty_programs/{loyaltyProgramId}/cards/{loyaltyCardId}/deduct_points Deduct loyalty points from a card · Deduct points from card #
Ask an LLM
“How do I remove points from a loyalty card after a refund?”
“Can I deduct card points from a specific subledger?”
Tell an agent
Deduct {points} points from loyalty card {loyaltyCardId} in program {loyaltyProgramId}.
Take {points} points off card {loyaltyCardId} in subledger {subledgerId} of program {loyaltyProgramId}.
GET /v1/loyalty_programs/{loyaltyProgramId}/cards/{loyaltyCardId}/export_log Export a loyalty card's ledger log to CSV · Export card's ledger log #
Ask an LLM
“Can I download one card's points history as a CSV for a date range?”
“What date format options are there when exporting a card's ledger?”
Tell an agent
Export the ledger of card {loyaltyCardId} in program {loyaltyProgramId} from {rangeStart} to {rangeEnd}.
Download card {loyaltyCardId}'s ledger CSV for program {loyaltyProgramId} between {rangeStart} and {rangeEnd} in {dateFormat} format.
GET /v1/loyalty_programs/{loyaltyProgramId}/cards/{loyaltyCardId}/logs List a loyalty card's transactions for back-office use · List card's transactions (Management API) #
Ask an LLM
“Is there a Management API way for support staff to review a card's transaction logs?”
“Can a back-office tool page through a card's transactions for specific sessions?”
Tell an agent
Using the Management API, list the transaction logs of card {loyaltyCardId} in program {loyaltyProgramId}.
Show back-office logs for card {loyaltyCardId} in program {loyaltyProgramId} for sessions {customerSessionIDs}.
PUT /v1/loyalty_programs/{loyaltyProgramId}/cards/{loyaltyCardId}/transfer Transfer a loyalty card's data to a new card · Transfer card data #
Ask an LLM
“A customer lost their card; how do I move their points and linked profiles onto a replacement?”
“Does transferring card data block the original card?”
Tell an agent destructive · confirm first
Transfer card {loyaltyCardId} in program {loyaltyProgramId} to new card {newCardIdentifier}.
Replace lost card {loyaltyCardId} with {newCardIdentifier} in program {loyaltyProgramId}, blocking it for reason {blockReason}.

Documentation

📖
APIReference
https://docs.talon.one/integration-api
📖
Documentation
https://docs.talon.one/docs/dev/integration-api/overview
📖
GettingStarted
https://docs.talon.one/docs/dev/quickstart
📖
APIReference
https://docs.talon.one/management-api
📖
Documentation
https://docs.talon.one/docs/dev/management-api/overview
📖
APIReference
https://docs.talon.one/third-party-api
📖
Documentation
https://docs.talon.one/docs/dev/technology-partners/overview
📖
Documentation
https://docs.talon.one/docs/dev/technology-partners/shopify/integrate-with-shopify
📖
Documentation
https://docs.talon.one/docs/dev/get-started/webhooks
📖
APIReference
https://docs.talon.one/outbound-notifications

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/talon-one/refs/heads/main/openapi/talon-one-loyalty-cards-api-openapi.yml

Other Resources

🔗
PostmanCollection
https://raw.githubusercontent.com/api-evangelist/talon-one/refs/heads/main/collections/talon-one.postman_collection.json
🔗
OpenCollection
https://raw.githubusercontent.com/api-evangelist/talon-one/refs/heads/main/collections/talon-one.opencollection.json
🔗
Postman
https://www.postman.com/talonone-rnd/workspace/talon-one/overview
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/talon-one/refs/heads/main/data-model/talon-one-data-model.yml
🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/talon-one/refs/heads/main/asyncapi/talon-one-webhooks.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/talon-one:talon-one-loyalty-cards-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

talon-one-loyalty-cards-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Talon One Loyalty cards API
  version: ''
  description: 'Operations tagged Loyalty cards across 2 of this provider''s published API definitions: talon-one-integration-api-openapi.yml, talon-one-management-api-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://yourbaseurl.talon.one
tags:


# --- truncated at 32 KB (98 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/talon-one/refs/heads/main/openapi/talon-one-loyalty-cards-api-openapi.yml