Tracked conversion events, newest first

POST/v1/properties/{propertyId}/reports/conversions

Returns every tracked event of a property, newest first, for a date range of up to 31 days. Each event has its value, customer details, and attribution. Filter by event name, or by a click ID or client ID to follow one visitor.

Before you call

This endpoint needs IDs that other endpoints return:

1. Call List the account properties. Copy the id of the property: it is the propertyId.
2. Call this endpoint with these IDs.

Authentication

bearerAuth: API key created in the dashboard (atk_…). Send it in the Authorization: Bearer YOUR_API_KEY header.

Path parameters

propertyIdstringrequired

ID of the property. Get it from listProperties (id).

Request body

application/jsonrequired

fromstring · daterequired

First day of the report, included, in the property time zone. The range covers at most 31 days.

Format YYYY-MM-DD, e.g. 2026-01-31

tostring · daterequired

Last day of the report, included, in the property time zone. to must be on or after from.

Format YYYY-MM-DD, e.g. 2026-01-31

eventNamesarray of string

Event names to include, for example Purchase or Lead. Without this field, the report includes every event.

Min items 1Max items 50Item min length 1Item max length 64

clickIdstring

AnyTrack click ID or property-scoped client ID. Modern click IDs and bare client IDs filter by browser, within the requested dates and event names. Legacy reference IDs filter by the stored reference ID. Undecodable IDs return 400 with invalid_request; valid unknown IDs return no rows.

Min length 1Max length 256

limitinteger

Number of items on each page.

Default 50Min 1Max 200

cursorstring

The nextCursor from the previous page. Keep the property and query fields unchanged. limit may change where supported. Pages are not snapshot-consistent.

Min length 1Max length 2048

Responses

Every response field is present unless it shows optional. A type that ends in | null can be null.

200 Successful response

application/json

dataarray of object

Events on this page, newest first.

Show 17 child attributes

idstring

ID of the conversion. Send it as conversionId to Get a conversion event. Do not parse the ID: its format can change.

timestring

Time of the event, in ISO 8601 format and in UTC.

eventNamestring | null

AnyTrack event name, for example Purchase or Lead.

valuenumber | null

Reported event value in currency, or null when unavailable. Usually converted to the property currency during ingestion; the original currency can be retained if conversion fails.

currencystring | null

Currency of value.

originalValuenumber | null

Original event value in originalCurrency, retained when currency conversion occurred. null when no separate original value was stored.

originalCurrencystring | null

Currency of the separately stored original event value. null when no separate original currency was stored.

transactionIdstring | null

Transaction ID that the conversion source sent, for example an order ID.

clientIdstring

AnyTrack client ID of the visitor browser, scoped to this property. Send it as clickId in the conversions report to find this browser’s events within the requested date range.

clickIdstring | null

AnyTrack click ID recorded on the event. null when the event has no click ID. Modern click IDs identify the browser when used as a conversions-report filter.

newSessionboolean

true when the event started a new session.

integrationIdstring | null

ID of the integration that sent the event. Send it as integrationId to Get an integration. null when no integration sent the event.

brandstring | null

Brand name linked to the event.

pageUrlstring | null

URL of the page where the event happened.

linkobject | null

Link linked to the event. null when the event has no link.

Show 3 child attributes

idstring | null

ID of the link.

labelstring | null

Label of the link.

urlstring | null

URL of the link.

customerobject | null

Customer details of the event. They contain personal data: keep them secure. null when the event has no customer details.

Show 9 child attributes

emailstring | null

Email address of the customer.

phonestring | null

Phone number of the customer.

firstNamestring | null

First name of the customer.

lastNamestring | null

Last name of the customer.

citystring | null

City of the customer.

statestring | null

State or region of the customer.

zipcodestring | null

Postal code of the customer.

countrystring | null

Country of the customer.

countryCodestring | null

Country code of the customer.

attributionobject | null

Reported main attribution touchpoint: channel, traffic source, campaign, ad set, and ad. null when no attribution details are available.

Show 13 child attributes

channelstring | null

Channel of the touchpoint.

adNetworkstring | null

Ad network of the touchpoint.

sourcestring | null

Traffic source of the touchpoint, as in utm_source.

mediumstring | null

Traffic medium of the touchpoint, as in utm_medium.

referrerstring | null

Referrer of the visit.

pageVariantstring | null

Page variant of the visit.

contentstring | null

Ad content of the touchpoint, as in utm_content.

termstring | null

Keyword of the touchpoint, as in utm_term.

clickIdParamstring | null

Name of the ad click ID parameter in the landing page URL, for example gclid or fbclid.

clickIdValuestring | null

Value of the ad click ID parameter.

campaignobject | null

Campaign of the touchpoint.

Show 2 child attributes

idstring | null

ID of the campaign on the ad platform.

namestring | null

Name of the campaign.

adsetobject | null

Ad set of the touchpoint.

Show 2 child attributes

idstring | null

ID of the ad set on the ad platform.

namestring | null

Name of the ad set.

adobject | null

Ad of the touchpoint.

Show 2 child attributes

idstring | null

ID of the ad on the ad platform.

namestring | null

Name of the ad.

nextCursorstring | null

Cursor of the next page. Send it as cursor with the same query to get the next page. null on the last page.

reportobject

Settings that AnyTrack used for the report.

Show 5 child attributes

propertyIdstring

ID of the property.

fromstring

First day of the report, as in the request.

tostring

Last day of the report, as in the request.

timezonestring

Time zone of the report. It is the time zone of the property.

currencystring

Configured reporting currency of the property. For individual conversions, use the currency returned on each event for its value.

Errors

Every error returns the error object.

Status	Description and action
400	invalid_request, invalid_cursor: A parameter or a body field is not valid, or the cursor belongs to a different query. Correct the request. error.details, when present, names invalid fields. Do not reuse a cursor with a different query.
401	unauthenticated: Missing, invalid or deleted API key. Send a valid key in Authorization: Bearer. MCP uses an OAuth access token, which may also expire or be revoked.
403	api_access_unavailable: API access is disabled for this account. Contact AnyTrack support. OAuth requests also require the anytrack:read scope (insufficient_scope).
404	not_found: An ID does not exist, or it belongs to a different account. The API gives the same error for both. Check the IDs. Get them again from the list endpoints.
413	payload_too_large: The request body is larger than 16 KB. Send a smaller request body.
429	rate_limited: The account sent more than 60 requests in one minute. Wait for the number of seconds in the Retry-After header, then retry.
500	response_too_large, internal_error: The response is larger than 1 MB, or the API has an internal error. For response_too_large, ask for fewer rows or metrics. For internal_error, contact AnyTrack support with the requestId.
503	service_unavailable: The service is not available for a short time. Retry later, and wait longer after each failed retry.
504	upstream_timeout: A downstream request timed out (the report client timeout is 65 seconds). Narrow the date range, then retry with backoff.

Request example

Command template. Replace the path placeholders. Put the request body in request-body.json, as in the schema above. Add the query parameters that you need. This is not a recorded request or response.

curl --request POST 'https://api.anytrack.io/v1/properties/{propertyId}/reports/conversions' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data @request-body.json

Download the OpenAPI contract.