Requests received by an integration, newest first
GET/v1/integrations/{integrationId}/logs
Returns the requests that an integration received, newest first, up to 20 per page. Each log shows the parameters that AnyTrack received and the event that it made. Use the logs to troubleshoot a postback or a webhook. Received parameters may contain personal or sensitive data and are not redacted by this API.
Before you call
Section titled “Before you call”This endpoint needs IDs that other endpoints return:
- Call List the account integrations. Copy the
idof the integration: it is theintegrationId. - Call this endpoint with these IDs.
Authentication
Section titled “Authentication”bearerAuth: API key created in the dashboard (atk_…). Send it in the Authorization: Bearer YOUR_API_KEY header.
Path parameters
Section titled “Path parameters”integrationIdstringrequiredID of the integration. Get it from
listIntegrations (id).Query parameters
Section titled “Query parameters”fromstring · dateFirst day of the logs, included, in UTC.
Format YYYY-MM-DD, e.g.
2026-01-31tostring · dateLast day of the logs, included, in UTC.
Format YYYY-MM-DD, e.g.
2026-01-31cursorstringThe
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 2048Responses
Section titled “Responses”Every response field is present unless it shows optional. A type that ends in | null can be null.
200 Successful response
Section titled “200 Successful response”application/json
dataarray of objectRequests that the integration received, newest first. Each page has up to 20 requests.
Show 7 child attributes
idstringID of the log entry.
receivedAtstringTime when AnyTrack received the request, in ISO 8601 format and in UTC.
statusstringResult of the request.
parsed: AnyTrack read the request and made an event. ignored: AnyTrack did not use the request. duplicated: AnyTrack received the same request before. error: AnyTrack could not process the request. Read message for the reason. unknown: the stored status is not recognized.Allowed values
parsed ignored duplicated error unknownmessagestring | nullReason for the status.
null when AnyTrack gives no reason.propertyIdstring | nullID of the property of the request.
null when AnyTrack did not link the request to a property.eventobject | nullEvent that AnyTrack made from the request.
null when the request made no event.Show 4 child attributes
eventNamestring | nullAnyTrack event name.
valuenumber | nullValue of the event as the platform sent it.
clientIdstringAnyTrack client ID of the event.
clickIdstring | nullAnyTrack click ID of the event.
null when the request had no click ID.paramsobjectReceived parser parameters and query parameters, merged with body fields and selected Shopify headers. Conflicting body keys have a
Body suffix. Values may contain personal or sensitive data; they are not redacted by this API.nextCursorstring | nullCursor of the next page. Send it as
cursor with the same query to get the next page. null on the last page.Errors
Section titled “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. |
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
Section titled “Request example”Command template. Replace the path placeholders. Add the query parameters that you need. This is not a recorded request or response.
curl --request GET 'https://api.anytrack.io/v1/integrations/{integrationId}/logs' \ --header 'Authorization: Bearer YOUR_API_KEY'