# Campaign performance report > POST /v1/properties/{propertyId}/reports/campaigns: Date ranges are limited to 31 days.
POST/v1/properties/{propertyId}/reports/campaigns
## Authentication **bearerAuth**: API key created in the dashboard (atk_...). Send it in the `Authorization: Bearer YOUR_API_KEY` header. ## Path parameters
propertyIdstringrequired
Property id
## Request body
application/jsonrequired
fromstring · daterequired
Inclusive start date in the report time zone
Format YYYY-MM-DD, e.g. 2026-01-31
tostring · daterequired
Inclusive end date in the report time zone
Format YYYY-MM-DD, e.g. 2026-01-31
attributionstring
Allowed values last-ad-click first-ad-clickDefault last-ad-click
groupBystring
Allowed values campaign adset adDefault campaign
metricsarray of string
Min items 1Max items 20Item max length 80
conversionEventsarray of string
Defaults to the property conversion events
Min items 1Max items 20Item min length 1Item max length 64
filtersobject
Show 6 child attributes
channelarray of string
Min items 1Max items 50Item min length 1Item max length 256
platformarray of string
Min items 1Max items 50Item min length 1Item max length 256
adNetworkarray of string
Min items 1Max items 50Item min length 1Item max length 256
campaignIdsarray of string
Min items 1Max items 50Item min length 1Item max length 256
adsetIdsarray of string
Min items 1Max items 50Item min length 1Item max length 256
adIdsarray of string
Min items 1Max items 50Item min length 1Item max length 256
sortobject
Show 2 child attributes
metricstringrequired
Allowed values spend impressions reach frequency linkClicks sessions clients eventValues results resultValues cpm cpc ctr roas
directionstring
Allowed values asc descDefault desc
limitinteger
Default 50Min 1Max 100
cursorstring
nextCursor from the previous page
Min length 1Max length 2048
## Responses ### 200 Successful response
application/json
dataarray of objectrequired
Show 7 child attributes
idstringrequired
typestringrequired
Allowed values campaign adset ad
namestring | nullrequired
channelstring | nullrequired
adNetworkstring | nullrequired
statusstring | nullrequired
Allowed values active paused terminated
metricsmap of (number | null)required
nextCursorstring | nullrequired
reportobjectrequired
Show 8 child attributes
propertyIdstringrequired
fromstringrequired
tostringrequired
timezonestringrequired
currencystringrequired
attributionstringrequired
Allowed values last-ad-click first-ad-click
groupBystringrequired
Allowed values campaign adset ad
conversionEventsarray of stringrequired
summarymap of (number | null) | nullrequired
Totals for the whole query; returned only on the first page
### 400 Invalid request
application/json
errorobjectrequired
Show 5 child attributes
codestringrequired
Allowed values invalid_request invalid_cursor unauthenticated api_access_unavailable not_found payload_too_large rate_limited response_too_large upstream_timeout service_unavailable internal_error
messagestringrequired
requestIdstringrequired
retryablebooleanrequired
Whether retrying the request can succeed
detailsarray of object
Show 2 child attributes
pathstringrequired
messagestringrequired
messagestring
codestring
issuesarray of object
Show 1 child attribute
messagestringrequired
### 401 Missing, invalid or deleted API key Same response body as [400](#400-invalid-request). ### 403 API access unavailable on the plan Same response body as [400](#400-invalid-request). ### 404 Unknown or inaccessible property Same response body as [400](#400-invalid-request). ### 413 Request body too large Same response body as [400](#400-invalid-request). ### 429 Rate limit exceeded; see Retry-After Same response body as [400](#400-invalid-request). ### 503 Temporarily unavailable; retry with backoff Same response body as [400](#400-invalid-request). ### 504 The query timed out; narrow the date range or retry Same response body as [400](#400-invalid-request). ## Request example Synthesized command template. Replace path placeholders and provide request-body.json matching the schema above; add query parameters as needed. This is not a recorded request or response. ```sh curl --request POST 'https://api.anytrack.io/v1/properties/{propertyId}/reports/campaigns' \ --header 'Authorization: Bearer YOUR_API_KEY' \ --header 'Content-Type: application/json' \ --data @request-body.json ``` [Download the OpenAPI contract](/api/openapi.json).