curl --request DELETE \
--url 'https://gateway.amana.io/kyc/{formId}/documents/{field}' \
--header 'Authorization: Bearer <token>'
import requests
url = "https://gateway.amana.io/kyc/{formId}/documents/{field}"
headers = {"Authorization": "Bearer <token>"}
response = requests.request("DELETE", url, headers=headers)
print(response.json())
const response = await fetch('https://gateway.amana.io/kyc/{formId}/documents/{field}', {
method: 'DELETE',
headers: {"Authorization": "Bearer <token>"},
});
console.log(await response.json());
{}
{
"error": "<string>",
"message": "<string>",
"details": {}
}
{
"error": "<string>",
"message": "<string>",
"details": {}
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
Onboarding & KYC
Delete KYC document
Remove an uploaded verification document from a KYC form field.
DELETE
/
kyc
/
{formId}
/
documents
/
{field}
curl --request DELETE \
--url 'https://gateway.amana.io/kyc/{formId}/documents/{field}' \
--header 'Authorization: Bearer <token>'
import requests
url = "https://gateway.amana.io/kyc/{formId}/documents/{field}"
headers = {"Authorization": "Bearer <token>"}
response = requests.request("DELETE", url, headers=headers)
print(response.json())
const response = await fetch('https://gateway.amana.io/kyc/{formId}/documents/{field}', {
method: 'DELETE',
headers: {"Authorization": "Bearer <token>"},
});
console.log(await response.json());
{}
{
"error": "<string>",
"message": "<string>",
"details": {}
}
{
"error": "<string>",
"message": "<string>",
"details": {}
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
Path parameters
string
required
ID of the KYC form.
string
required
Response
204 Success.
Possible Errors
| Error | Possible cause | What to do |
|---|---|---|
| 400 | Invalid or missing field | Check the request against the schema. |
| 401 | Token missing or expired | Log in again or use the refresh token. |
| 403 | IP not whitelisted, or account restricted | Confirm your IP is whitelisted; otherwise contact Amana. |
| 429 / 5xx | Rate limit, or temporary issue on our side | Retry with backoff; contact support if it persists. |
curl --request DELETE \
--url 'https://gateway.amana.io/kyc/{formId}/documents/{field}' \
--header 'Authorization: Bearer <token>'
import requests
url = "https://gateway.amana.io/kyc/{formId}/documents/{field}"
headers = {"Authorization": "Bearer <token>"}
response = requests.request("DELETE", url, headers=headers)
print(response.json())
const response = await fetch('https://gateway.amana.io/kyc/{formId}/documents/{field}', {
method: 'DELETE',
headers: {"Authorization": "Bearer <token>"},
});
console.log(await response.json());
{}
{
"error": "<string>",
"message": "<string>",
"details": {}
}
{
"error": "<string>",
"message": "<string>",
"details": {}
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}
Last modified on October 8, 2026
