Getting started
This guide walks through obtaining a token and calling the Reporting API. See the API Reference for full parameter details.
Prerequisites
- Later Influence access with Reporting API credentials (
clientId,clientSecret). Request access through your account team or urvash.chheda@later.com (subject: Reporting API access). - curl or any HTTPS client.
Examples use the public base https://reporting.api.later.com/v2. Staging or private gateways may use a different host; paths stay the same after the version prefix.
Step 1 — Token
curl -sS -X POST "https://reporting.api.later.com/oauth/token" \
-H "Content-Type: application/json" \
-d '{
"clientId": "YOUR_CLIENT_ID",
"clientSecret": "YOUR_CLIENT_SECRET"
}'
Example success body
{
"jwt": "<JWT>"
}
Send the jwt value as Authorization: Bearer <jwt> on all API requests. The token has a fixed expiry embedded in its exp claim; re-authenticate when you receive a 401.
Step 2 — List instances
curl -sS -G "https://reporting.api.later.com/v2/instances" \
-H "Authorization: Bearer <JWT>" \
--data-urlencode "pageNumber=1" \
--data-urlencode "pageSize=50"
Use a real JWT in place of <JWT>. Pick an instanceId from the response for the next step.
Example success body (trimmed)
{
"data": {
"instanceIds": ["instance_abc", "instance_def"]
},
"pagination": {
"page": 1,
"pageSize": 50,
"totalPages": 1,
"totalItems": 2
}
}
Step 3 — Campaign performance
curl -sS -G "https://reporting.api.later.com/v2/campaigns/performance" \
-H "Authorization: Bearer <JWT>" \
--data-urlencode "startDate=2025-01-01" \
--data-urlencode "endDate=2025-01-31" \
--data-urlencode "instanceIds=instance_abc" \
--data-urlencode "pageNumber=1" \
--data-urlencode "pageSize=10" \
--data-urlencode "sortProperty=estimatedRoi" \
--data-urlencode "sortDirection=DESC"
Replace instance_abc, dates, and <JWT> with your values.
What’s next?
- Authentication — token lifecycle and errors
- Querying the API — filters,
dateBasis, pagination - Errors & troubleshooting
- API Reference