Quickstart

Make your first request

A shopping agent is about to pay a store whose page looks exactly like the brand’s. Every check it can run says the store is real. This asks a person, and shows exactly what comes back.

Add the server

Make a request

3Read the response

4Handle failures

Send the request

Post the question to the questions endpoint.

curl -X POST $QUORUM_URL/v1/questions \  -H "Content-Type: application/json" \  -d '{    "kind": "verify",    "question": "Is this the brand’s own store?",    "answer_schema": { "type": "boolean" },    "context": { "text": "Nike Official Store, nike-outlet-sale.shop" },    "deadline_ms": 30000,    "cost_of_error": "180.00",    "caller_confidence": 0.9  }'

Parameters

Parameter	Type	Required	Description
`kind`	string	Yes	disambiguate, verify, match, categorise or compare.
`question`	string	Yes	Phrased for someone with no context on your system.
`answer_schema`	object	Yes	boolean, enum with options, or number. Free text is not accepted.
`deadline_ms`	number	Yes	How long you will wait: up to 5 minutes on a held connection, up to 24 hours in callback mode.
`mode`	string	No	blocking (the default) or callback. Callback mode holds the question for a person even when nobody is online, and posts the answer to callback_url.
`callback_url`	string	No	Where the answer is posted in callback mode.
`context`	object	No	Evidence the person needs: image_url, text or extracted. A screenshot needs no hosting: send it as image_base64 (PNG, JPEG, WebP or GIF, up to 5 MB).
`cost_of_error`	string	One of	What acting on a wrong answer would cost you, in dollars. Sets the price, and says when a person is not worth asking.
`max_price`	string	these two	Your ceiling in dollars. Also sets how sure the answer must be.
`caller_confidence`	number	No	How sure you are of your own guess. With cost_of_error, decides whether asking is worth it.

Response

No, it is not the brand’s store. The answer comes back with its confidence and the receipts for every wage.

{  "question_id": "q_9f2a…",  "status": "resolved",  "answer": false,  "confidence": 0.99,  "responders": 2,  "agreement": "unanimous",  "latency_ms": 6120}

Check status before using answer. Anything other than resolved means no answer was reached, and you were refunded.