# Make your first call

> Check your key with /ping, then list your quotes. A working request in a minute.

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

You need an API key with **Quotes — View**. See [Create an API key](https://docs.samita.io/sa-request-a-quote/public-api/create-api-key).

In the examples below, replace `sqt_your_key_here` with your key. Run them from a terminal or a server, not from a browser.

## 1. Check the key with /ping

`GET /ping` needs no permission, so it works with any valid key. It is the quickest way to find out whether a key is right.

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

A good answer looks like this:

```json
{
  "shop": {
    "domain": "your-store.myshopify.com",
    "name": "Your store",
    "plan": "PRO_PLUS"
  },
  "key": {
    "name": "HubSpot sync",
    "last4": "w978",
    "scopes": ["quotes:read", "quotes:create", "quotes:update", "quotes:delete", "form:read"],
    "expires_at": "2027-02-16T08:00:00Z"
  }
}
```

It confirms the store, the key's name, the last four characters, the permissions it carries and when it expires (`null` for a key that never expires).

If you get an error instead, see [Errors](https://docs.samita.io/sa-request-a-quote/public-api/errors).

## 2. List your quotes

```bash
curl "https://quote.samita.io/api/public/v1/quotes?limit=5" \
  -H "X-SAMITA-API-KEY: sqt_your_key_here"
```

```json
{
  "quotes": [
    {
      "id": 29238181,
      "number": 1002,
      "status": "unread",
      "customer": { "email": "lan@example.com", "name": "Lan Le" },
      "item_count": 2,
      "subtotal": "98.00",
      "currency": "USD",
      "created_at": "2026-11-18T07:21:10Z",
      "updated_at": "2026-11-18T07:21:10Z"
    }
  ],
  "page": { "has_next": false, "next_cursor": null }
}
```

`id` is the one you use in URLs. `number` is the quote number your customers and your team see.

## 3. Read one quote

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

This returns the full quote: customer, form answers, attachments, line items and notes. See [Quotes](https://docs.samita.io/sa-request-a-quote/public-api/quotes).

## What to do next

* Mark a quote as handled — `PATCH /quotes/{id}` with `{"status": "read"}`
* Create a quote from another system — `POST /quotes`
* Sync only what changed — `GET /quotes?updated_at_min=...`

All are covered in [Quotes](https://docs.samita.io/sa-request-a-quote/public-api/quotes).

> **Note**
>
> Build and test against a store you can afford to change. `POST`, `PATCH` and `DELETE` change real quotes, and a deleted quote cannot be restored.
