COconversion

List Forms

List tracked, published Conversion-native forms with basic metadata. External forms (custom HTML) and ad lead-gen forms (LinkedIn, Meta) are excluded, as are untracked, archived, and never-published forms.

Results are paginated with an opaque cursor returned as pagination.nextCursor. Pass it back as the cursor query parameter to fetch the next page. A null cursor means there are no more results.

get/v2/forms

Request

  • Base URL
    https://pub-api.conversion.ai/api
  • Auth
    • API key in header X-API-Key
    • or API key in query parameter api_key

Query parameters

limitinteger

The maximum number of forms to return per page. Defaults to 50. Values are clamped to the range [1, 100] rather than rejected; values above 100 return 100 results.

cursorstring

The opaque pagination cursor returned as pagination.nextCursor by a previous call. Omit to fetch the first page. An invalid or malformed cursor returns an invalid_cursor error.

Response

Forms retrieved successfully.

Example response

{
  "data": {
    "forms": [
      {
        "id": "9f3c1a2e-6b7d-4e2a-9c1f-1a2b3c4d5e6f",
        "name": "Demo Request",
        "submissionCount": 412
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.