How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
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.2.0, 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.2.0
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 PostFormValuesResponseDTO (2 properties), SeriesData (2 properties), RelationshipLinks (2 properties), FlowSeriesRequestDTOResourceObject (2 properties). Each schema is shown below with its type and property counts.

Timeframe
object
1 property 1 required
PostSegmentValuesResponseDTO
object
2 properties 1 required
CustomTimeframe
object
2 properties 2 required
PostCampaignValuesResponseDTO
object
2 properties 1 required
FlowValuesRequestDTOResourceObject
object
2 properties 2 required
FlowEnum
string
CampaignValuesReportEnum
string
FlowSeriesRequestDTO
object
1 property 1 required
FormValuesRequestDTOResourceObject
object
2 properties 2 required
CampaignValuesRequestDTO
object
1 property 1 required
PostSegmentSeriesResponseDTO
object
2 properties 1 required
SegmentSeriesRequestDTO
object
1 property 1 required
SegmentValuesRequestDTO
object
1 property 1 required
CampaignValuesRequestDTOResourceObject
object
2 properties 2 required
RelationshipLinks
object
2 properties 2 required
FlowSeriesRequestDTOResourceObject
object
2 properties 2 required
CampaignEnum
string
FormValuesRequestDTO
object
1 property 1 required
FormSeriesRequestDTOResourceObject
object
2 properties 2 required
PostFormValuesResponseDTO
object
2 properties 1 required
SegmentValuesReportEnum
string
FlowSeriesReportEnum
string
SegmentValuesRequestDTOResourceObject
object
2 properties 2 required
FlowMessageEnum
string
SegmentSeriesReportEnum
string
FormSeriesReportEnum
string
ValuesData
object
2 properties 2 required
SegmentSeriesRequestDTOResourceObject
object
2 properties 2 required
FlowValuesRequestDTO
object
1 property 1 required
PostFormSeriesResponseDTO
object
2 properties 1 required
FormValuesReportEnum
string
PostFlowValuesResponseDTO
object
2 properties 1 required
FlowValuesReportEnum
string
SeriesData
object
2 properties 2 required
FormSeriesRequestDTO
object
1 property 1 required
PostFlowSeriesResponseDTO
object
2 properties 1 required
ObjectLinks
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
Where this information came from

This is an independent, third-party profile of Klaviyo Reporting API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.