Skip to content
Try free for 7 days
English
Open in Claude Ask questions about this pageOpen in ChatGPT Ask questions about this page

Make your first call

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

You need an API key with Quotes — View. See Create an 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.

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.

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

A good answer looks like this:

{
"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.

Terminal window
curl "https://quote.samita.io/api/public/v1/quotes?limit=5" \
-H "X-SAMITA-API-KEY: sqt_your_key_here"
{
"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.

Terminal window
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.

  • 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.

Was this helpful?