---
title: Decline a KYC Inquiry
slug: decline-a-kyc-inquiry
icon: {"apiMethod":"POST"}
createdAt: 2026-10-01T13:42:53.315Z
---

:::ApiMethodV2
```json
{
  "name": "Decline a KYC Inquiry",
  "method": "POST",
  "url": "https://equidefi.io/api/v1/inquiries/{inquiryId}/decline",
  "description": "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.",
  "tab": "examples",
  "examples": {
    "languages": [
      {
        "id": "qusfhV8d6aym4PkNje-JI",
        "language": "javascript",
        "code": "const response = await fetch(\n  \"https://equidefi.io/api/v1/inquiries/{inquiryId}/decline\",\n  {\n    method: \"POST\",\n    headers: {\n      Authorization: `Bearer ${process.env.EQUIDEFI_API_KEY}`,\n      \"Content-Type\": \"application/json\",\n    },\n    body: JSON.stringify({ description: \"Government ID did not match the submitted name\" }),\n  }\n);\n\nconst { data } = await response.json();\nconsole.log(data.id, data.attributes.status); // \"b7e4d1c0-...\", \"declined\"",
        "customLabel": ""
      }
    ],
    "selectedLanguageId": "qusfhV8d6aym4PkNje-JI"
  },
  "results": {
    "languages": [
      {
        "id": "ub1DcZm0tSYrukFhhi_PR",
        "language": "200",
        "code": "{\n  \"data\": {\n    \"type\": \"inquiries\",\n    \"id\": \"b7e4d1c0-...\",\n    \"attributes\": {\n      \"type\": \"KYC\",\n      \"status\": \"declined\",\n      \"create_date\": \"2026-09-01T14:02:11Z\",\n      \"modify_date\": \"2026-09-01T14:25:47Z\",\n      \"first_name\": \"Jane\",\n      \"last_name\": \"Doe\",\n      \"company\": null\n    }\n  }\n}",
        "customLabel": ""
      },
      {
        "id": "R2dot4qDfL0loAaBFkFc1",
        "language": "404",
        "code": "{ \"errors\": [\"Inquiry not found\"] }",
        "customLabel": ""
      }
    ],
    "selectedLanguageId": "ub1DcZm0tSYrukFhhi_PR"
  },
  "request": {
    "pathParameters": [
      {
        "name": "inquiryId",
        "kind": "required",
        "type": "string",
        "description": "EquiDeFi inquiry id (the id from the List Investment Inquiries endpoint).",
        "": "required"
      }
    ],
    "queryParameters": [],
    "headerParameters": [],
    "bodyDataParameters": [
      {
        "name": "description",
        "kind": "required",
        "type": "string",
        "description": " Required, non-blank. The reason sent to the investor in their KYC declined email.",
        "": " Required, non-blank. The reason sent to the investor in their KYC declined email."
      }
    ],
    "formDataParameters": []
  },
  "currentNewParameter": {
    "label": "Body Parameter",
    "value": "bodyDataParameters"
  },
  "hasTryItOut": false,
  "autoGeneratedAnchorSlug": "decline-a-kyc-inquiry",
  "legacyHash": "1BUCLDOslSKyJM69vn3VB"
}
```
:::

