Talon.One

Talon.One Customer data API

Represents the data of a customer, including sessions and events used for reporting and debugging in the Campaign Manager.

GitHub OpenAPI
Business capability
Customer Data Management BC-420.10

Operations 14

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

GET /v1/applications/{applicationId}/customers List an Application's customers · List application's customers #
Ask an LLM
“Who are the customers that have interacted with one of my Applications?”
“Can I find a customer in an Application by their integration ID?”
Tell an agent
List the customers of Application {applicationId}.
Find the customer with integration ID {integrationId} in Application {applicationId}.
POST /v1/applications/{applicationId}/customer_search Search an Application's customers by attributes · List application customers matching the given attributes #
Ask an LLM
“Which customers in one Application have a given attribute value, like a certain city?”
“Can I search an Application's customers by several attributes at once?”
Tell an agent
Search Application {applicationId} for customers matching attributes {attributes}.
Find customers in Application {applicationId} with integration IDs {integrationIDs}.
POST /v1/customer_search/no_total Search all customer profiles by attributes · List customer profiles matching the given attributes #
Ask an LLM
“Which customer profiles across my whole account match a set of attributes?”
“Can I search sandbox customer profiles by attribute instead of live ones?”
Tell an agent
Search all customer profiles in the account matching attributes {attributes}.
Find account-wide profiles with profile IDs {profileIDs}, in sandbox mode {sandbox}.
GET /v1/customers/{customerId} Get a customer profile · Get customer profile #
Ask an LLM
“What attributes and loyalty data are stored on a specific customer profile?”
“Can I fetch a customer profile by its internal ID from an admin tool?”
Tell an agent
Get customer profile {customerId}.
Show me everything stored on customer {customerId}'s profile.
GET /v1/customers/no_total List all customer profiles · List customer profiles #
Ask an LLM
“How many customer profiles exist across my account, page by page?”
“Can I list only sandbox customer profiles?”
Tell an agent
List all customer profiles in my account.
List {pageSize} customer profiles, sandbox only: {sandbox}.
GET /v1/applications/{applicationId}/customers/{customerId} Get a customer within an Application · Get application's customer #
Ask an LLM
“What does a specific customer look like in the context of one Application?”
“Can I retrieve one Application customer by their ID?”
Tell an agent
Get customer {customerId} in Application {applicationId}.
Show Application {applicationId}'s record for customer {customerId}.
GET /v1/applications/{applicationId}/customer_activity_reports/no_total List activity reports for an Application's customers · Get Activity Reports for Application Customers #
Ask an LLM
“What did all my customers do in an Application over the last quarter?”
“Can I filter customer activity summaries by campaign name or advocate?”
Tell an agent
Get activity reports for all customers of Application {applicationId} from {rangeStart} to {rangeEnd}.
Show customer activity in Application {applicationId} for campaign {campaignName} between {rangeStart} and {rangeEnd}.
GET /v1/applications/{applicationId}/customer_activity_reports/{customerId} Get one customer's activity report · Get customer's activity report #
Ask an LLM
“What has one particular customer done in my Application during a date range?”
“Can I get a single shopper's activity summary for last month?”
Tell an agent
Get the activity report of customer {customerId} in Application {applicationId} from {rangeStart} to {rangeEnd}.
Summarize customer {customerId}'s activity in Application {applicationId} between {rangeStart} and {rangeEnd}.
GET /v1/applications/{applicationId}/customers/{customerId}/analytics Get a customer's analytics report · Get customer's analytics report #
Ask an LLM
“What are the purchase and session analytics for one customer?”
“Can I see analytics for a single shopper without picking a date range?”
Tell an agent
Get the analytics report for customer {customerId} in Application {applicationId}.
Show customer {customerId}'s analytics in Application {applicationId}.
GET /v1/applications/{applicationId}/sessions List an Application's customer sessions · List Application sessions #
Ask an LLM
“Which carts or sessions were opened in my Application yesterday?”
“Can I find sessions where a particular coupon or referral code was used?”
Tell an agent
List the sessions of Application {applicationId}.
Show sessions in Application {applicationId} that used coupon {coupon}.
POST /v1/applications/{applicationId}/sessions_search Search sessions by customer attributes · List Application sessions matching the given customer attributes #
Ask an LLM
“Which sessions belong to customers with a given profile attribute, like loyalty members in Berlin?”
“Can I pull the sessions for a list of customer integration IDs at once?”
Tell an agent
Find sessions in Application {applicationId} whose customers match attributes {attributes}.
Search Application {applicationId} sessions for customers {integrationIDs}.
GET /v1/applications/{applicationId}/sessions/{sessionId} Get a customer session · Get Application session #
Ask an LLM
“What was in a specific customer session, and what effects did it get?”
“Can I look up one session's details by its ID?”
Tell an agent
Get session {sessionId} in Application {applicationId}.
Show the details of customer session {sessionId} from Application {applicationId}.
GET /v1/applications/{applicationId}/events/no_total List events recorded in an Application · List Applications events #
Ask an LLM
“What events have been recorded in my Application recently?”
“Can I find the events triggered by a specific customer email or coupon code?”
Tell an agent
List the events recorded in Application {applicationId}.
Show events of type {type} in Application {applicationId} for customer email {customerEmail}.
GET /v1/applications/{applicationId}/event_types List the event types seen in an Application · List Applications event types #
Ask an LLM
“What distinct event types have actually been recorded in one Application?”
“Which kinds of events has my integration been sending to this Application?”
Tell an agent
List the distinct event types recorded in Application {applicationId}.
Show which event types Application {applicationId} has received.

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-customer-data-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-customer-data-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-customer-data-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Management Customer data API
  version: ''
  description: 'The Management API allows you to programmatically do what the Campaign Manager

    does.'
servers:
- url: https://yourbaseurl.talon.one
security:
- manager_auth: []
- management_key: []
tags:


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