HomeBook a Demo

Reports

Partner API v1 reference for the daily revenue report endpoint.

The Partner API is in private preview and available by invitation. If you're a partner interested in early access, contact support@getinline.io.

Base URL: https://partner-api.getinline.tech (production). Every request needs Authorization: Bearer <token>; see authentication. This page is generated from the OpenAPI spec, version 1.0.0; download it at /openapi/partner-api.yaml.

Gross and net revenue by day

GET /v1/reports/revenue

Required scope: reporting:read.

Your organization's revenue: one row per date and publisher. Gross revenue is what ad partners paid; net revenue is your share of it. Refreshed about every four hours. Ad partner data for dates two or more UTC days old is final (is_final), but a revenue share change can still restate net revenue for any date, so re-pull the whole range you reconcile. Ranges are capped at 92 days.

Query parameters

start_dateQuerystring (date)Required

First UTC date, inclusive (YYYY-MM-DD).

end_dateQuerystring (date)Required

Last UTC date, inclusive (YYYY-MM-DD). Must not be before start_date.

publisher_idQuerystring (uuid)

Only this publisher. 404 if the token cannot reach it.

limitQueryintegerdefault: 1000

From 1 to 1000.

cursorQuerystring

The meta.next_cursor of the previous page. Opaque; do not construct it.

Response

  • 200: A page of revenue rows.

Headers: X-Request-Id.

dataarray of RevenueRowRequired

See RevenueRow.

metaRevenueReportMetaRequired

See RevenueReportMeta.

Errors

Every error uses the error envelope.

StatusMeaning
400The request is malformed or a parameter is invalid.
401The token is missing, malformed, unknown, revoked, or expired.
403The token lacks the required scope, or the organization may not perform this action.
404The resource does not exist or the token cannot reach it.
429Too many requests. Limits are 300 requests per 5 minutes per token and a per-IP limit. Honor Retry-After when present, otherwise back off exponentially.
503The report could not be produced in time. Retry with backoff or narrow the range.

Example

curl "https://partner-api.getinline.tech/v1/reports/revenue?start_date=2026-10-01&end_date=2026-10-07" \
  -H "Authorization: Bearer $INLINE_API_TOKEN"