---
title: "Get promoter revenue over time"
method: GET
path: "/promoters/{promoterId}/performance/revenue"
tags: ["Promoter Performance"]
---

# Get promoter revenue over time

`GET /promoters/{promoterId}/performance/revenue`

## Request

- Base URL: `https://api.session.services`
- URL: `https://api.session.services/promoters/{promoterId}/performance/revenue`
- Auth: API key in header `x-tenant-id`

Time-series data for revenue and tickets sold for a single promoter

## Path parameters

- `promoterId` string, required: Promoter identifier

## Query parameters

- `granularity` 'HOUR' | 'DAY' | 'WEEK' | 'MONTH': Time granularity
- `currency` string: Currency filter
- `startDate` string, date, required: Start date (YYYY-MM-DD)
- `endDate` string, date, required: End date (YYYY-MM-DD)
- `timeZone` string: IANA time zone for interpreting date ranges

## Response `200`

OK

- object
  - `meta` object, required
    - `promoterId` string, required
    - `dateRange` object, required
      - `start` string, required: Period start date
      - `end` string, required: Period end date
    - `granularity` 'HOUR' | 'DAY' | 'WEEK' | 'MONTH', required
  - `currencies` object[], required: Time-series data grouped by currency
    - `currency` string, required: Currency code (e.g., USD, EUR)
    - `series` object[], required
      - `date` string, required: Date (YYYY-MM-DD)
      - `revenue` number, required: Revenue in cents
      - `tickets` number, required: Tickets sold
    - `totals` object, required
      - `revenue` number, required: Total revenue for period in cents
      - `tickets` number, required: Total tickets for period

## Other responses

- `400`: 400
- `401`: 401
- `403`: 403
- `404`: 404
- `409`: 409
- `412`: 412
- `422`: 422
- `429`: 429
- `500`: 500
- `501`: 501
- `503`: 503

## Changes

> 221 revisions in range; 4 not diffed.

- **2026-08-02** `84f157e4443a`: 1 info
  - added the non-success response with the status `412`

[Operation history](https://skmtc.dev/session/apis/session-services-api/changes/promoters/:promoterId/performance/revenue/get.md)

---

[API](https://skmtc.dev/session/apis/session-services-api.md) · [All operations](https://skmtc.dev/session/apis/session-services-api/llms.txt) · [OpenAPI document](https://skmtc.dev/session/apis/session-services-api/revisions/f48ca68f37a4?raw)