---
title: "Get conversation forms"
method: GET
path: "/ccaas/2/conversation-forms/forms"
tags: ["customer-engagement", "conversations", "conversation-forms"]
---

# Get conversation forms

`GET /ccaas/2/conversation-forms/forms`

## Request

- Base URL: `https://api.infobip.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.infobip.com/ccaas/2/conversation-forms/forms`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`
  - API key in header `Authorization`
  - API key in header `Authorization`
  - HTTP basic

Use this method to get a list of forms with pagination and filtering options. Using a filter is optional. The result can be filtered by one or many optional filters described in the parameters.

## Query parameters

- `title` string
- `isEnabled` string
- `isDefault` string
- `limit` integer
- `page` integer
- `orderBy` string

## Response `200`

OK

- 9620629c173fbd1e947e2693ffe57e0c353c3961ef0ef2018c058c14e6f698abFormApiResultPage
  - `items` 9620629c173fbd1e947e2693ffe57e0c353c3961ef0ef2018c058c14e6f698abFormApiResponse[]
    - `id` string: Form id.
    - `title` string: Form title.
    - `isEnabled` boolean: Is form enabled.
    - `isDefault` boolean: Is form marked as default one.
    - `fields` 9620629c173fbd1e947e2693ffe57e0c353c3961ef0ef2018c058c14e6f698abFormFieldApiResponse[]: List of fields attached to a form
      - `field` 9620629c173fbd1e947e2693ffe57e0c353c3961ef0ef2018c058c14e6f698abFieldApiResponse
        - `id` string: Field id.
        - `title` string: Field title.
        - `type` 'TEXT' | 'MULTILINE' | 'CHECKBOX' | 'DROPDOWN' | 'INTNUMBER' | 'DECIMALNUMBER' | 'REGEX' | 'DATE' | 'CARD': Field type.
        - `regex` string: Regular expression. Valid only for REGEX field type.
        - `isEnabled` boolean: Is field enabled
        - `isDefault` boolean
        - `options` string[]: List of available options.
        - `createdAt` string
        - `updatedAt` string
        - `operators` 9620629c173fbd1e947e2693ffe57e0c353c3961ef0ef2018c058c14e6f698abFieldOperatorApiResponse[]: List of available operators based on field type.
      - `isRequired` boolean: Is a field mandatory
      - `conditions` 9620629c173fbd1e947e2693ffe57e0c353c3961ef0ef2018c058c14e6f698abFieldConditionApiResponse[]: List of conditions
        - `id` string: Id of the condition.
        - `value` string: Condition value.
        - `fields` 9620629c173fbd1e947e2693ffe57e0c353c3961ef0ef2018c058c14e6f698abConditionalFieldApiResponse[]: List of fields to present if agent input matches condition value.
          - `field` 9620629c173fbd1e947e2693ffe57e0c353c3961ef0ef2018c058c14e6f698abFieldApiResponse
            - `id` string: Field id.
            - `title` string: Field title.
            - `type` 'TEXT' | 'MULTILINE' | 'CHECKBOX' | 'DROPDOWN' | 'INTNUMBER' | 'DECIMALNUMBER' | 'REGEX' | 'DATE' | 'CARD': Field type.
            - `regex` string: Regular expression. Valid only for REGEX field type.
            - `isEnabled` boolean: Is field enabled
            - `isDefault` boolean
            - `options` string[]: List of available options.
            - `createdAt` string
            - `updatedAt` string
            - `operators` 9620629c173fbd1e947e2693ffe57e0c353c3961ef0ef2018c058c14e6f698abFieldOperatorApiResponse[]: List of available operators based on field type.
          - `isRequired` boolean: Is the conditional field required to fill?
    - `createdAt` string
    - `updatedAt` string
  - `pagination` 9620629c173fbd1e947e2693ffe57e0c353c3961ef0ef2018c058c14e6f698abPagination
    - `totalItems` integer
    - `page` integer
    - `limit` integer
    - `orderBy` string

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `500`: Internal Server Error

---

[API](https://skmtc.dev/infobip/apis/infobip-openapi-specification.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification/revisions/9dcbbaf902de?raw)