Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Klaviyo Reporting API

reporting

Klaviyo Reporting API is one of 23 APIs that Klaviyo publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

Tagged areas include Reporting. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an AsyncAPI specification, an API reference, authentication docs, and rate-limit docs.

This API exposes 7 operations across 7 paths, and defines 37 schemas. It is described by OpenAPI 3.0.2, at version 2026-04-15.

Requests are made against a single base URL, https://a.klaviyo.com.

7 operations 7 paths 37 schemas 7 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.2
API Version
2026-04-15
Base URL
https://a.klaviyo.com
Authentication
API Key
License
Terms of Service
Resource Areas
1

Authentication & Security 1

Klaviyo Reporting API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (Klaviyo-API-Key). By default, every request must be authenticated.

  • Klaviyo-API-Key — Private key authentication for /api/ endpoints is performed by setting the Authorization header to Klaviyo-API-Key your-private-api-key For more information pl…

Paths & Operations 7

Across 7 paths, the API surfaces 7 operations — 7 POST. Each is listed below with its method, path, parameters, and response codes.

Reporting 7

reporting

POST
/api/campaign-values-reports
Query Campaign Values
query_campaign_values 2 params body → 2004XX5XX
POST
/api/flow-values-reports
Query Flow Values
query_flow_values 2 params body → 2004XX5XX
POST
/api/flow-series-reports
Query Flow Series
query_flow_series 2 params body → 2004XX5XX
POST
/api/form-values-reports
Query Form Values
query_form_values 1 param body → 2004XX5XX
POST
/api/form-series-reports
Query Form Series
query_form_series 1 param body → 2004XX5XX
POST
/api/segment-values-reports
Query Segment Values
query_segment_values 1 param body → 2004XX5XX
POST
/api/segment-series-reports
Query Segment Series
query_segment_series 1 param body → 2004XX5XX

Schemas 37

The contract defines 37 schemas that model the data the API accepts and returns. The most detailed are FormValuesRequestDTOResourceObject (2 properties), CustomTimeframe (2 properties), FlowSeriesRequestDTOResourceObject (2 properties), PostCampaignValuesResponseDTO (2 properties). Each schema is shown below with its type and property counts.

PostFlowValuesResponseDTO
object
2 properties 1 required
FlowValuesRequestDTO
object
1 property 1 required
SeriesData
object
2 properties 2 required
RelationshipLinks
object
2 properties 2 required
PostFormSeriesResponseDTO
object
2 properties 1 required
CampaignValuesRequestDTOResourceObject
object
2 properties 2 required
SegmentValuesRequestDTO
object
1 property 1 required
FormSeriesRequestDTOResourceObject
object
2 properties 2 required
FormValuesReportEnum
string
SegmentSeriesRequestDTOResourceObject
object
2 properties 2 required
CampaignValuesReportEnum
string
FormSeriesReportEnum
string
ValuesData
object
2 properties 2 required
FlowValuesRequestDTOResourceObject
object
2 properties 2 required
PostSegmentSeriesResponseDTO
object
2 properties 1 required
FlowSeriesReportEnum
string
PostSegmentValuesResponseDTO
object
2 properties 1 required
SegmentValuesRequestDTOResourceObject
object
2 properties 2 required
PostFormValuesResponseDTO
object
2 properties 1 required
PostFlowSeriesResponseDTO
object
2 properties 1 required
PostCampaignValuesResponseDTO
object
2 properties 1 required
FlowEnum
string
FlowSeriesRequestDTOResourceObject
object
2 properties 2 required
CampaignEnum
string
FormValuesRequestDTO
object
1 property 1 required
FlowMessageEnum
string
FormSeriesRequestDTO
object
1 property 1 required
SegmentValuesReportEnum
string
CustomTimeframe
object
2 properties 2 required
ObjectLinks
object
1 property 1 required
SegmentSeriesReportEnum
string
SegmentSeriesRequestDTO
object
1 property 1 required
Timeframe
object
1 property 1 required
FlowSeriesRequestDTO
object
1 property 1 required
FlowValuesReportEnum
string
FormValuesRequestDTOResourceObject
object
2 properties 2 required
CampaignValuesRequestDTO
object
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

klaviyo-reporting-api-openapi.yml Raw ↑

Other APIs Klaviyo publishes across the network.

Klaviyo Accounts API
Klaviyo Campaigns API
Klaviyo Catalogs API
Klaviyo Client API
Klaviyo Conversations API
Klaviyo Coupons API
Klaviyo Custom Objects API
Klaviyo Data Privacy API
Klaviyo Events API
Klaviyo Flows API
Klaviyo Forms API
Klaviyo Images API