Skip to content

Forms API

List the ids of a form's versions

GEThttps://email.growthdept.ai/api/forms/{id}/relationships/form-versions

Sort by created_at, updated_at, ascending or descending (put - in front).

Rate limits

Burst: 3/s

Steady: 60/m

Tier S. See rate limits for how requests are counted.

Scopes

forms:read

Operation id

get_version_ids_for_form The same operation as in Klaviyo's API. OpenAPI document

Path parameters

stringrequired

Query parameters

string

Filter expression.

Filtering guide

Fields and the operators each one takes:

  • form_type: any, equals
  • status: equals
  • created_at: greater-or-equal, greater-than, less-or-equal, less-than
  • updated_at: greater-or-equal, greater-than, less-or-equal, less-than

string

From links.next or links.prev of the previous page.

Pagination guide

integer1 to 100default 20

Default 20, at most 100.

Pagination guide

string

Default created_at.

Sorting guide

Headers

stringrequireddefault 2026-10-15

API revision, YYYY-MM-DD. This server implements 2026-10-15.

Revisions guide

Responses

200Success

Response body

object

  • dataarray of objectsrequired

    data: 2 fields
    • typestringrequired

      form-version
    • idstringrequired

  • linksobject

    links: 3 fields
    • selfstring (uri)required

    • prevstring (uri)

    • nextstring (uri)

  • metaobject

4XXClient error

Response body

object

  • errorsarray of objectsrequired

    errors: 8 fields
    • idstringrequired

    • statusintegerrequired

    • codestringrequired

    • titlestringrequired

    • detailstringrequired

    • sourceobject

      source: 2 fields
      • pointerstring

      • parameterstring

    • linksobject

    • metaobject

See status codes for each code.

5XXServer error

Response body

object

  • errorsarray of objectsrequired

    errors: 8 fields
    • idstringrequired

    • statusintegerrequired

    • codestringrequired

    • titlestringrequired

    • detailstringrequired

    • sourceobject

      source: 2 fields
      • pointerstring

      • parameterstring

    • linksobject

    • metaobject