curl --request POST \
--url https://app.bily.ai/api/customer/v1/store-data/{storeUrl}/tracking/events \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"connectionKey": "website",
"since": "2023-11-07T05:31:56Z",
"until": "2023-11-07T05:31:56Z",
"eventName": "<string>",
"eventId": "<string>",
"limit": 50,
"baselineKeys": "<string>",
"filter": "<string>",
"email": "<string>",
"params": {}
}
'const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
connectionKey: 'website',
since: '2023-11-07T05:31:56Z',
until: '2023-11-07T05:31:56Z',
eventName: '<string>',
eventId: '<string>',
limit: 50,
baselineKeys: '<string>',
filter: '<string>',
email: '<string>',
params: {}
})
};
fetch('https://app.bily.ai/api/customer/v1/store-data/{storeUrl}/tracking/events', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.bily.ai/api/customer/v1/store-data/{storeUrl}/tracking/events"
payload = {
"connectionKey": "website",
"since": "2023-11-07T05:31:56Z",
"until": "2023-11-07T05:31:56Z",
"eventName": "<string>",
"eventId": "<string>",
"limit": 50,
"baselineKeys": "<string>",
"filter": "<string>",
"email": "<string>",
"params": {}
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){}{
"error": "Store not found",
"requestId": "<string>",
"details": "<unknown>",
"retryAfter": "<string>"
}{
"error": "Store not found",
"requestId": "<string>",
"details": "<unknown>",
"retryAfter": "<string>"
}{
"error": "Store not found",
"requestId": "<string>",
"details": "<unknown>",
"retryAfter": "<string>"
}{
"error": "Store not found",
"requestId": "<string>",
"details": "<unknown>",
"retryAfter": "<string>"
}{
"error": "Store not found",
"requestId": "<string>",
"details": "<unknown>",
"retryAfter": "<string>"
}{
"error": "Store not found",
"requestId": "<string>",
"details": "<unknown>",
"retryAfter": "<string>"
}{
"error": "Store not found",
"requestId": "<string>",
"details": "<unknown>",
"retryAfter": "<string>"
}Read matching tracking receipts
Inspects at most the latest 200 source events in a past window of at most 120 minutes. Returns at most 50 matches. Empty or limited results do not prove that no event arrived. Incoming receipts do not prove destination delivery; inspect providerEvidence separately. Requires analytics:query. This POST is read-only. Supply all search scope in the JSON body with no URL query string; the body must not exceed 16 KiB.
curl --request POST \
--url https://app.bily.ai/api/customer/v1/store-data/{storeUrl}/tracking/events \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"connectionKey": "website",
"since": "2023-11-07T05:31:56Z",
"until": "2023-11-07T05:31:56Z",
"eventName": "<string>",
"eventId": "<string>",
"limit": 50,
"baselineKeys": "<string>",
"filter": "<string>",
"email": "<string>",
"params": {}
}
'const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
connectionKey: 'website',
since: '2023-11-07T05:31:56Z',
until: '2023-11-07T05:31:56Z',
eventName: '<string>',
eventId: '<string>',
limit: 50,
baselineKeys: '<string>',
filter: '<string>',
email: '<string>',
params: {}
})
};
fetch('https://app.bily.ai/api/customer/v1/store-data/{storeUrl}/tracking/events', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.bily.ai/api/customer/v1/store-data/{storeUrl}/tracking/events"
payload = {
"connectionKey": "website",
"since": "2023-11-07T05:31:56Z",
"until": "2023-11-07T05:31:56Z",
"eventName": "<string>",
"eventId": "<string>",
"limit": 50,
"baselineKeys": "<string>",
"filter": "<string>",
"email": "<string>",
"params": {}
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){}{
"error": "Store not found",
"requestId": "<string>",
"details": "<unknown>",
"retryAfter": "<string>"
}{
"error": "Store not found",
"requestId": "<string>",
"details": "<unknown>",
"retryAfter": "<string>"
}{
"error": "Store not found",
"requestId": "<string>",
"details": "<unknown>",
"retryAfter": "<string>"
}{
"error": "Store not found",
"requestId": "<string>",
"details": "<unknown>",
"retryAfter": "<string>"
}{
"error": "Store not found",
"requestId": "<string>",
"details": "<unknown>",
"retryAfter": "<string>"
}{
"error": "Store not found",
"requestId": "<string>",
"details": "<unknown>",
"retryAfter": "<string>"
}{
"error": "Store not found",
"requestId": "<string>",
"details": "<unknown>",
"retryAfter": "<string>"
}Authorizations
A server-side Bily API key created under Settings > AI tools > Access keys. Select the intended workspace before creating it.
Headers
An organization ID returned by GET /context or GET /organizations. Omit it when a scoped key supplies the organization. Otherwise provide it when no organization is selected.
"org_01J8W7T9G3E6ZQ4M2K5N8P1R0S"
Path Parameters
The exact store URL returned by GET /context or GET /stores.
"store.example.com"
Body
An exact key from tracking connections. Defaults to website.
ISO timestamp within the last 120 minutes. Defaults to five minutes ago.
Optional past ISO timestamp at or after since.
Exact event name without contact details.
Opaque event ID without contact details.
Maximum returned receipts.
1 <= x <= 50Comma-separated baseline keys from test-baseline. At most 200 keys.
Search retained event names and public scalar values.
256Exact case-insensitive email match. Send only in the JSON body, never the URL.
254Public scalar event parameters. Sensitive identity, credential and reserved keys are rejected.
Show child attributes
Show child attributes
Response
Request completed successfully.
The response is of type object.