Query Form Series

post https://a.klaviyo.com/api/form-series-reports/

🚧
This endpoint is in beta and subject to change.
A beta revision header (2024-07-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.

Returns the requested form analytics series data.

Rate limits:
Burst: 1/s
Steady: 2/m
Daily: 225/d

Scopes:
forms:read

Responses

Language

Credentials

Header


xxxxxxxxxx
19
1
curl --request POST \
2
     --url https://a.klaviyo.com/api/form-series-reports/ \
3
     --header 'Authorization: Klaviyo-API-Key your-private-api-key' \
4
     --header 'accept: application/json' \
5
     --header 'content-type: application/json' \
6
     --header 'revision: 2024-07-15.pre' \
7
     --data '
8
{
9
  "data": {
10
    "type": "form-series-report",
11
    "attributes": {
12
      "timeframe": {
13
        "key": "last_12_months"
14
      },
15
      "interval": "daily"
16
    }
17
  }
18
}
19
'


xxxxxxxxxx
48
}
1
{
2
  "data": {
3
    "type": "form-series-report",
4
    "attributes": {
5
      "results": [
6
        {
7
          "groupings": {
8
            "form_id": "abc123"
9
          },
10
          "statistics": {
11
            "viewed_form": [
12
              100,
13
              120,
14
              140
15
            ],
16
            "submits": [
17
              20,
18
              22,
19
              28
20
            ]
21
          }
22
        },
23
        {
24
          "groupings": {
25
            "form_id": "def456"

200Success

4XXClient Error

5XXServer Error