curl -X PUT 'https://api.yativo.com/api/v1/business/rfis/42/draft-responses' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: rfi-reply-42-v1' \
-d '{
"responses": {
"2095d3da-2761-4d30-93e6-b46018bf576a": {
"free_text_explanation": "Customer explanation here."
}
}
}'
{
"status": "success",
"status_code": 200,
"message": "<string>",
"data": {
"id": 42,
"provider_rfi_id": "<string>",
"state": "on_developer",
"response_required": true,
"requested_items": [
{}
],
"draft_responses": {},
"draft_responses_at": "2023-11-07T05:31:56Z",
"submitted_to_provider_at": "2023-11-07T05:31:56Z",
"deadline": "2023-11-07T05:31:56Z",
"dashboard_url": "<string>"
}
}{
"status": "failed",
"status_code": 123,
"message": "Insufficient wallet balance",
"data": {
"error": "Insufficient wallet balance"
},
"error": {
"code": "invalid_argument",
"message": "<string>",
"request_id": "req_5f2c9a1e7b3d4c8a6e0f1b2d"
},
"error_details": {
"code": "validation_error",
"message": "The amount field is required.",
"http_status": 422,
"fields": {},
"retryable": false,
"retry_after": 123
}
}Compliance RFIs
Reply to RFI
Send a complete answer for an open RFI in one request
PUT
/
business
/
rfis
/
{id}
/
draft-responses
curl -X PUT 'https://api.yativo.com/api/v1/business/rfis/42/draft-responses' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: rfi-reply-42-v1' \
-d '{
"responses": {
"2095d3da-2761-4d30-93e6-b46018bf576a": {
"free_text_explanation": "Customer explanation here."
}
}
}'
{
"status": "success",
"status_code": 200,
"message": "<string>",
"data": {
"id": 42,
"provider_rfi_id": "<string>",
"state": "on_developer",
"response_required": true,
"requested_items": [
{}
],
"draft_responses": {},
"draft_responses_at": "2023-11-07T05:31:56Z",
"submitted_to_provider_at": "2023-11-07T05:31:56Z",
"deadline": "2023-11-07T05:31:56Z",
"dashboard_url": "<string>"
}
}{
"status": "failed",
"status_code": 123,
"message": "Insufficient wallet balance",
"data": {
"error": "Insufficient wallet balance"
},
"error": {
"code": "invalid_argument",
"message": "<string>",
"request_id": "req_5f2c9a1e7b3d4c8a6e0f1b2d"
},
"error_details": {
"code": "validation_error",
"message": "The amount field is required.",
"http_status": 422,
"fields": {},
"retryable": false,
"retry_after": 123
}
}Submit your answers for an open RFI in one request. The body must include every
Yativo reviews your reply before anything is sent upstream.
You can also use
Returns
requested_items[].id, each with at least one valid field from that item’s response_types.
A reply is final. You can’t send a partial reply or change answers later on the same open period. After a successful call,
responses_submitted_at is set and response_required becomes false while Yativo reviews. To answer again, wait until Yativo reopens the RFI (response_required is true and status is action_required again).PUT https://api.yativo.com/api/v1/business/rfis/{id}/draft-responses
POST /business/rfis/{id}/responses with the same JSON body and the same rules.
curl -X PUT 'https://api.yativo.com/api/v1/business/rfis/42/draft-responses' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: rfi-reply-42-v1' \
-d '{
"responses": {
"2095d3da-2761-4d30-93e6-b46018bf576a": {
"free_text_explanation": "Customer explanation here."
}
}
}'
422 if the RFI is closed, if a reply was already submitted and Yativo hasn’t reopened it, or if any requested item is missing or incomplete.Authorizations
Your API key (yativo_pk_...) from Developers → API Keys. Send together with X-Api-Secret.
Your API secret (yativo_sk_...), shown once when the key is created.
Headers
A unique string per request to ensure idempotent processing.
Path Parameters
Body
application/json
Map of requested_items[].id to response fields (e.g. free_text_explanation).
Show child attributes
Show child attributes