curl --request POST \
--url https://api.platform.dakota.xyz/transactions/{transaction_id}/rfi/response \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--header 'x-idempotency-key: <x-idempotency-key>' \
--data '
{
"answer": "This payment settles invoice 4411 from our supplier. The invoice is attached.",
"document_ids": [
"trfidoc_2nGq0Ff1c1qvA3oZb0v8lJr2s9Z"
]
}
'const options = {
method: 'POST',
headers: {
'x-idempotency-key': '<x-idempotency-key>',
'x-api-key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
answer: 'This payment settles invoice 4411 from our supplier. The invoice is attached.',
document_ids: ['trfidoc_2nGq0Ff1c1qvA3oZb0v8lJr2s9Z']
})
};
fetch('https://api.platform.dakota.xyz/transactions/{transaction_id}/rfi/response', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.platform.dakota.xyz/transactions/{transaction_id}/rfi/response"
payload = {
"answer": "This payment settles invoice 4411 from our supplier. The invoice is attached.",
"document_ids": ["trfidoc_2nGq0Ff1c1qvA3oZb0v8lJr2s9Z"]
}
headers = {
"x-idempotency-key": "<x-idempotency-key>",
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.platform.dakota.xyz/transactions/{transaction_id}/rfi/response"
payload := strings.NewReader("{\n \"answer\": \"This payment settles invoice 4411 from our supplier. The invoice is attached.\",\n \"document_ids\": [\n \"trfidoc_2nGq0Ff1c1qvA3oZb0v8lJr2s9Z\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-idempotency-key", "<x-idempotency-key>")
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"id": "trfi_2nGq0Ff1c1qvA3oZb0v8lJr2s9X",
"transactions": [
{
"transaction_id": "2nGq0Ff1c1qvA3oZb0v8lJr2s9Y",
"transaction_type": "auto_account"
}
],
"status": "responded",
"questions": "One of your customers’ transactions (1,250.00 USD, October 23, 2026) is on hold pending review. To release it, please provide: ...",
"requested_at": "2026-10-23T09:30:00Z",
"answer": "This payment settles invoice 4411 from our supplier. The invoice is attached.",
"responded_at": "2026-10-23T11:05:00Z",
"documents": [
{
"id": "trfidoc_2nGq0Ff1c1qvA3oZb0v8lJr2s9Z",
"file_type": "pdf",
"filename": "invoice-4411.pdf",
"size_bytes": 184322
}
]
}{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}Answer a request for information about a transaction
Sends your answer to the pending request for information about a
transaction, with the files you uploaded for it. You can answer once
per request. When the request is about several transactions, the
answer is for all of them. Dakota reviews the answer and then releases or cancels
the transaction; it stays processing until then.
curl --request POST \
--url https://api.platform.dakota.xyz/transactions/{transaction_id}/rfi/response \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--header 'x-idempotency-key: <x-idempotency-key>' \
--data '
{
"answer": "This payment settles invoice 4411 from our supplier. The invoice is attached.",
"document_ids": [
"trfidoc_2nGq0Ff1c1qvA3oZb0v8lJr2s9Z"
]
}
'const options = {
method: 'POST',
headers: {
'x-idempotency-key': '<x-idempotency-key>',
'x-api-key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
answer: 'This payment settles invoice 4411 from our supplier. The invoice is attached.',
document_ids: ['trfidoc_2nGq0Ff1c1qvA3oZb0v8lJr2s9Z']
})
};
fetch('https://api.platform.dakota.xyz/transactions/{transaction_id}/rfi/response', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.platform.dakota.xyz/transactions/{transaction_id}/rfi/response"
payload = {
"answer": "This payment settles invoice 4411 from our supplier. The invoice is attached.",
"document_ids": ["trfidoc_2nGq0Ff1c1qvA3oZb0v8lJr2s9Z"]
}
headers = {
"x-idempotency-key": "<x-idempotency-key>",
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.platform.dakota.xyz/transactions/{transaction_id}/rfi/response"
payload := strings.NewReader("{\n \"answer\": \"This payment settles invoice 4411 from our supplier. The invoice is attached.\",\n \"document_ids\": [\n \"trfidoc_2nGq0Ff1c1qvA3oZb0v8lJr2s9Z\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-idempotency-key", "<x-idempotency-key>")
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"id": "trfi_2nGq0Ff1c1qvA3oZb0v8lJr2s9X",
"transactions": [
{
"transaction_id": "2nGq0Ff1c1qvA3oZb0v8lJr2s9Y",
"transaction_type": "auto_account"
}
],
"status": "responded",
"questions": "One of your customers’ transactions (1,250.00 USD, October 23, 2026) is on hold pending review. To release it, please provide: ...",
"requested_at": "2026-10-23T09:30:00Z",
"answer": "This payment settles invoice 4411 from our supplier. The invoice is attached.",
"responded_at": "2026-10-23T11:05:00Z",
"documents": [
{
"id": "trfidoc_2nGq0Ff1c1qvA3oZb0v8lJr2s9Z",
"file_type": "pdf",
"filename": "invoice-4411.pdf",
"size_bytes": 184322
}
]
}{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}Headers
Unique key (UUID) to ensure request idempotency on POST, PUT and PATCH requests.
A key is scoped to your client, the HTTP method and the path, and is remembered for 24 hours after a
successful (below 400) response. Repeating the same request (same JSON body, whatever the key order or
whitespace) with the same key within that window returns the original response with
X-Idempotent-Replayed: true instead of executing the request again. Using the same key on the same
endpoint with a different body returns 422 with problem type idempotency-key-reused; the request is
not executed. Error responses (4xx and 5xx) are not remembered, so a request refused for a fixable reason
can be corrected and retried under the same key. Request bodies that are not JSON (for example file
uploads) are not compared.
Path Parameters
Unique identifier of the transaction. KSUID is a 27-character globally unique ID that combines a timestamp with a random component. Used for all entity identifiers in the Dakota platform.
27^[0-9A-Za-z]{27}$"1NFHrqBHb3cTfLVkFSGmHZqdDPi"
Body
Response
The answer was recorded.
A request for information about one or more transactions of one of your customers.
pending: Dakota waits for your answer. responded: you answered and
Dakota is reviewing it. closed: the request was about transactions
on hold, none of them is on hold any more, and the request needs no
answer. A request about transactions that were not on hold stays
pending until you answer.
pending, responded, closed Was this page helpful?

