---
title: "Instance performance summary"
method: GET
path: "/v2/instances/performance"
tags: ["Instance Level"]
---

# Instance performance summary

`GET /v2/instances/performance`

## Request

- Base URL: `https://reporting.api.later.com`
- URL: `https://reporting.api.later.com/v2/instances/performance`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/later/apis/later-influence-reporting-api/docs/v2/instances/performance/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns aggregated performance metrics across all content for the given instances and date range.

**Response shape:**
Metrics are nested under `data.metrics` so the envelope matches the other reporting endpoints (campaigns, creators, posts, networks) and leaves room to add non-metric top-level fields later without breaking existing clients.

**What is included:**
- Metrics requested via the `metrics` query parameter (returned inside `data.metrics`)

Supported metric groups:
- Organic engagement metrics (engagements, impressions, reach, views)
- Paid media metrics (paid engagements, impressions, ad spend, ROAS)
- Cost and ROI estimates
- Tracking link and affiliate link conversion data

## Query parameters

- `startDate` string, date-time, required
- `endDate` string, date-time, required
- `metrics` string[], required
- `instanceIds` string[]
- `campaignIds` number[]
- `platform` string[]
- `contentType` string[]
- `dateBasis` 'post_date' | 'performance_date'

## Response `200`

Aggregated performance summary

- object
  - `data` PerformanceSummaryResponseDto, required
    - `metrics` PerformanceSummaryMetricsDto, required
      - `affiliateLinksClicks` number, nullable, required
      - `affiliateLinksConversions` number, nullable, required
      - `affiliateLinksSales` number, nullable, required
      - `campaignsCost` number, nullable, required
      - `cpe` number, nullable, required
      - `cpm` number, nullable, required
      - `engagementRate` number, nullable, required
      - `engagements` number, nullable, required
      - `estimatedContentCost` number, nullable, required
      - `estimatedValueGenerated` number, nullable, required
      - `impressions` number, nullable, required
      - `organicReach` number, nullable, required
      - `paidAdSpend` number, nullable, required
      - `paidCpe` number, nullable, required
      - `paidCpm` number, nullable, required
      - `paidEngagementRate` number, nullable, required
      - `paidEngagements` number, nullable, required
      - `paidImpressions` number, nullable, required
      - `paidPostsCount` number, nullable, required
      - `paidReach` number, nullable, required
      - `paidReturnOnAdSpend` number, nullable, required
      - `paidViews` number, nullable, required
      - `postsCount` number, nullable, required
      - `reach` number, nullable, required
      - `returnOnInvestment` number, nullable, required
      - `trackingLinksClicks` number, nullable, required
      - `trackingLinksConversionValue` number, nullable, required
      - `trackingLinksConversions` number, nullable, required
      - `views` number, nullable, required
  - `nextCursor` string, nullable, required

## Other responses

- `400`: One or more query parameters failed validation (`ANL_00400`)
- `401`: Authentication failed — the JWT is missing, malformed, invalid, or expired (`ANL_00401`). Request a new token via `POST /oauth/token` before retrying.
- `403`: Authorization failed — the JWT is valid but the requested scope is not accessible with this token (`ANL_00403`). Typically one or more `instanceIds` are not bound to the client.
- `500`: An unexpected error occurred while processing the request (`ANL_00500`). The request was not processed and the credentials are not implicated — retry with exponential backoff.

---

[API](https://skmtc.dev/later/apis/later-influence-reporting-api.md) - [All operations](https://skmtc.dev/later/apis/later-influence-reporting-api/llms.txt) - [OpenAPI document](https://skmtc.dev/later/apis/later-influence-reporting-api/revisions/690357ea985d?raw)