Make your first call
Check your key with /ping, then list your quotes. A working request in a minute.
Bu içerik henüz dilinizde mevcut değil.
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.
1. Check the key with /ping
Section titled “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.
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.
2. List your quotes
Section titled “2. List your quotes”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.
3. Read one quote
Section titled “3. Read one quote”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.
What to do next
Section titled “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.