POST
Ask a question about a document
Answers a question against one document and quotes the exact lines the answer came from, so an engineer can check it rather than trust it.

When the document does not say

answered comes back false and answer says what is missing. Nothing is filled in from general knowledge, and a safety-relevant answer is never softened.
Branch on answered rather than parsing the prose.

One file at a time

This endpoint reads the document you send it. Indexing a whole archive (drawings, standards, maintenance history, on an offline site) is a deployment rather than an API call. See Deployment options.

Limits and cost

PDF, PNG, JPEG or WebP, up to 8 MB. Questions are truncated at 2,000 characters. Four cents a question, whether or not the document had the answer.

Authorizations

Authorization
string
header
required

API token from the Voho console. Begins with voho_sk_live_.

Body

Send multipart/form-data with the file attached, or JSON with the file base64 encoded.

file
file
required

The file itself. Accepted types: application/pdf, image/png, image/jpeg, image/webp.

question
string
required

Truncated at 2,000 characters.

Example:

"What is the torque spec for the pump on line three, and which revision is this?"

Response

The answer.

answer
string
quotes
string[]

Verbatim lines from the document, in its own language.

answered
boolean

False when the document does not contain the answer. answer then says what is missing.

cost_cents
integer

What this call cost, in cents. Also returned as the X-Voho-Cost-Cents header.