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.

Generate a short lived access 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>"
}

Provide the received 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.

List instances

curl -sS -G "https://reporting.api.later.com/v2/instances" \
  -H "Authorization: Bearer <JWT>" \
  --data-urlencode "limit=50"

Example success body

{
  "data": {
    "instanceIds": ["instance_abc", "instance_def"]
  },
  "nextCursor": null
}

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=<YOUR_INSTANCE_ID>" \
  --data-urlencode "metrics=engagements" \
  --data-urlencode "metrics=impressions" \
  --data-urlencode "limit=10" \
  --data-urlencode "sortProperty=estimatedRoi" \
  --data-urlencode "sortDirection=DESC"

What’s next?

Authentication - token lifecycle and errors
Querying the API - data hierarchy, filters, cursor pagination
Errors & troubleshooting
API Reference

Overview

Authentication