This endpoint is in beta and subject to change.
A beta revision header (2026-10-15.pre) is required to use our beta APIs. Klaviyo APIs in beta are not intended for use in production. See our versioning and deprecation policy for more information.
Ask a question about your account data in plain language and get a plain-language answer.
K-SQL turns your question into read-only queries over your account's data, runs them, and summarizes the results. The result sets behind the answer are included so you can see how it was reached.
If the question is too ambiguous to answer, status is clarification and answer contains a question for you. Ask again with more detail.
An answer can only draw on data that your API key or OAuth token has scopes for. Each request uses Composer AI Credits. This API is available to accounts that have been enabled for it.
Answers can take several seconds, so allow for this in your client's request timeout.
Rate limits:
Burst: 1/s
Steady: 15/m
Optional Scopes:
campaigns:read
catalogs:read
events:read
lists:read
metrics:read
profiles:read
segments:read