Skip to main content
POST
Submit Info Request Answers
Send a requested tax identification number in tin_value, separate from question answers. Omit answers when the request has no questions. Omit tin_value to retain a number saved through the customer form. Submission freezes the number. To correct a submitted number, ask for a new information request. Read responses never return the saved number.

Authorizations

x-api-key
string
header
required

Your Meow API key, sent in the x-api-key header for authentication.

Scopes

entity:create

Path Parameters

request_id
string<uuid>
required

The information request, as returned in next_step.info_requests[].request_id.

entity_id
string
required

The entity being onboarded.

Body

application/json
tin_value
string<password> | null

The requested tax identification number. Omit to retain a saved draft.

answers
Answers · object | null

Answers keyed by the element name in the request's form schema. Validated against that schema, so send them complete. This submits, it does not save a draft. Omit it when the request asks no questions.

unavailable_proof_explanations
Unavailable Proof Explanations · object | null

Why the business cannot provide a requested document, keyed by its proof_type. An accepted explanation settles that document the same way an upload does, so use it when no upload will ever satisfy the request. Send every explanation the request should keep: this replaces the set on file rather than adding to it, and an explanation for a document you have since uploaded is dropped.

Response

Successful Response

request_completed
boolean
required

Whether the information request is now satisfied in full. False while it still owes documents.

outstanding
PublicOutstandingItem · object[]
required

What the request is still waiting on after this submission.