# Quote form

> Read the fields of your quote form and the key of each field, so you can create quotes through the API.

App: SA Request a Quote, Hide Price (Shopify app by Samita)
Source: https://docs.samita.io/sa-request-a-quote/public-api/quote-form
Last updated: 2026-11-18

`GET /form` returns the fields of your quote form. You need it before creating a quote through the API, because `POST /quotes` identifies each answer by the field's **key**.

**Permission:** `form:read` (shown as **Quote form — View**).

```bash
curl https://quote.samita.io/api/public/v1/form \
  -H "X-SAMITA-API-KEY: sqt_your_key_here"
```

## Response

The example below is illustrative. Your sections, field keys and labels come from your own form.

```json
{
  "form": {
    "sections": [
      {
        "key": "contact_info",
        "title": "Contact information",
        "fields": [
          { "key": "contact_info[first_name]", "label": "First name", "type": "text", "required": true },
          { "key": "contact_info[email]", "label": "Email address", "type": "text", "required": true },
          { "key": "contact_info[phone]", "label": "Phone number", "type": "phone", "required": true }
        ]
      },
      {
        "key": "company_info",
        "title": "Company information",
        "fields": [
          { "key": "company_info[name]", "label": "Company name", "type": "text", "required": true }
        ]
      },
      {
        "key": "payment_terms",
        "title": "Payment terms",
        "fields": [
          {
            "key": "payment_terms[type]",
            "label": "Payment terms",
            "type": "select",
            "required": false,
            "options": [
              { "label": "Net 30", "value": "net30" },
              { "label": "Net 60", "value": "net60" }
            ]
          }
        ]
      }
    ]
  }
}
```

A field `key` can contain square brackets, such as `contact_info[email]`. Use it exactly as shown, as the name of a property in the `fields` object.

| Field | Meaning |
| --- | --- |
| sections[].key , title | The section as set up in the form builder. |
| fields[].key | The identifier to use in fields when you create a quote. |
| label | The text customers see. |
| type | The field type, such as text , email , select , textarea or file . |
| required | true if the form requires an answer. A required field must be sent when you create a quote. |
| options | For choice fields, the allowed value s, each with its label . |

Only fields customers fill in are listed. Headings, paragraphs, dividers, HTML blocks and hidden fields are left out.

> **Note**
>
> The API reads the form you built in **Quote settings** > **Customize** > **Quote form**, so changes you make there show up here straight away. See [Build a standard form](https://docs.samita.io/sa-request-a-quote/quote-form/build-standard-form).

## Next steps

* [Quotes](https://docs.samita.io/sa-request-a-quote/public-api/quotes#create-a-quote) — create a quote using these keys
