Zum Inhalt springen
7 Tage kostenlos testen
Deutsch
English简体中文繁體中文ČeštinaBald verfügbarDanskBald verfügbarNederlandsSuomiBald verfügbarFrançaisDeutschItaliano日本語한국어Norsk bokmålBald verfügbarPolskiPortuguêsEspañolSvenskaTürkçe
In Claude öffnen Fragen zu dieser Seite stellenIn ChatGPT öffnen Fragen zu dieser Seite stellen

Make your first call

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

Dieser Inhalt ist noch nicht in deiner Sprache verfügbar.

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.

War diese Seite hilfreich?