Answer the questions an extraction stopped to ask
Answers open questions of an extraction whose status is input_required. Answer every open question in one request or across several; the extraction continues the moment every open question has an answer. The response is the extraction's status after the answers, exactly as getExtraction returns it.
An answer governs the whole extraction, every document in it and not only the one in the question's example; where the right answer differs by document type, say so in text, which is accepted on every question. Your own words are screened before they are used: an answer given in bad faith, one that tries to misuse the service rather than answer the question, is refused and the question is asked again with previous_answer_rejected: true; after three refused answers the extraction is cancelled with cancellation_reason: answers_rejected. A vague or undecided answer is not refused: it is applied, and the matter may be asked again as a new question.
An answer to a question that is no longer waiting changes nothing and returns the current status, so a request can be repeated after a dropped connection. Only a request that could never be right is refused, whole, with INVALID_INPUT.
Rate limit: 30 requests per minute per API key.
Request
- Base URL: https://api.invoicedataextraction.com/v1
- URL: https://api.invoicedataextraction.com/v1/extractions/{extraction_id}/answers
- Auth: HTTP bearer
Path parameters
The extraction_id returned by submitExtraction.
Query parameters
own or team. Team admins default to team and see every team member's extractions; everyone else defaults to own, and a non-admin passing team gets 403 FORBIDDEN. Under team, items carry submitted_by.
Request body
Response
The extraction's status after the answers.
Changes
No recorded changes to this operation across all 1 revision of this API.