Decline a KYC Inquiry
1 min
Decline a KYC Inquiry
Declines a KYC or KYB inquiry by its id. A description is required — it is the reason the investor sees in their KYC declined email. The outcome matches a decline in the issuer portal: the inquiry is updated in Persona and the decision is added to the investment's activity history and notes, attributed to the partner API. Returns the inquiry with its new status. Partner-only.
POST
https://equidefi.io/api/v1/inquiries/{inquiryId}/decline
Path Parameters
- inquiryIdstringrequiredDescription
Body Parameters
- descriptionstringrequiredDescription
javascript
const response = await fetch(
"https://equidefi.io/api/v1/inquiries/{inquiryId}/decline",
{
method: "POST",
headers: {
Authorization: `Bearer ${process.env.EQUIDEFI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({ description: "Government ID did not match the submitted name" }),
}
);
const { data } = await response.json();
console.log(data.id, data.attributes.status); // "b7e4d1c0-...", "declined"200
{
"data": {
"type": "inquiries",
"id": "b7e4d1c0-...",
"attributes": {
"type": "KYC",
"status": "declined",
"create_date": "2026-09-01T14:02:11Z",
"modify_date": "2026-09-01T14:25:47Z",
"first_name": "Jane",
"last_name": "Doe",
"company": null
}
}
}404
{ "errors": ["Inquiry not found"] }