---
title: "Deny counterparty account"
method: POST
path: "/counterparty_accounts/{id}/deny"
tags: ["Counterparty Accounts"]
deprecated: true
---

# Deny counterparty account

`POST /counterparty_accounts/{id}/deny`

## Request

- Base URL: `https://sandbox.numeral.io/v1`
- URL: `https://sandbox.numeral.io/v1/counterparty_accounts/{id}/deny`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/numeral/apis/payments/docs/counterparty_accounts/:id/deny/post.ts> (a function with typed inputs; its response is checked against the schema)

> **Deprecated.**

Deny a counterparty account. A counterparty account can be denied from the `pending_approval` and `approved` statuses. Denying a counterparty account updates its status to `denied`.

## Path parameters

- `id` string, required

## Request body

- CounterpartyAccountsDenyCounterpartyAccount
  - `reason` string: The reason for the denial.

## Response `200`

200

- CounterpartyAccountsCounterpartyAccount
  - `id` string, uuid, required: The UUID of the counterparty account.
  - `object` string, required: Type of the object, `counterparty_account`.
  - `type` 'individual' | 'legal_entity': The type of the counterparty account.
  - `name` string: The name of the counterparty account.
  - `holder_name` string, required: The name of the legal entity or individual holding the account.
  - `account_number` string, required: The account number.
  - `counterparty_id` string, required: The ID of the related counterparty.
  - `company_registration_number` string: The company registration number of the counterparty account, when `type` = `legal_entity`.
  - `company_registration_number_type` 'eu_vat' | 'fr_siren' | 'fr_siret' | 'nl_kvk' | 'nl_kvk_branch' | 'other' | 'uk_crn': The type of the counterparty account's company registration number, when `type` = `legal_entity`.
  - `bank_code` string, required: The bank code, for instance BIC / Swift code, UK sort code, or US routing number.
  - `holder_address` CounterpartyAccountsHolderAddress, required: The address of the account holder, as an address object.
    - `line_1` string: Line 1.
    - `line_2` string: Line 2.
    - `building_number` string: Building number.
    - `street_name` string: Street name.
    - `postal_code` string: Postal / zip code.
    - `region_state` string: Region or state.
    - `city` string: City.
    - `country` string: ISO 3166 alpha-2 country code.
  - `status` 'pending_approval' | 'approved' | 'denied' | 'disabled', required: The status of this counterparty account.
  - `status_details` string, required: The details of the status of this counterparty account.
  - `account_verification` CounterpartyAccountsAccountVerification: The result of the latest verification ran against the counterparty account.
    - `result` 'valid' | 'invalid' | 'pending_verification', required: The overall result of the specific verification.
    - `created_at` string, date-time: The UTC timestamp the verification was performed at.
    - `valid_account_number` CounterpartyAccountsAccountVerificationItem: The result of a specific verification.
      - `result` 'valid' | 'invalid' | 'impossible_to_verify' | 'not_verified', required: The result of this specific verification.
      - `details` CounterpartyAccountsAccountVerificationItemDetails: The details of a specific verification.
        - `reason` string: A specific code that gives additional information on what caused the failure.
        - `expected_value` string: When available, the value that was expected in order to pass the validation.
        - `message` string: A user friendly message describing the failure.
    - `matching_account_number_and_bank_code` CounterpartyAccountsAccountVerificationItem: The result of a specific verification.
      - `result` 'valid' | 'invalid' | 'impossible_to_verify' | 'not_verified', required: The result of this specific verification.
      - `details` CounterpartyAccountsAccountVerificationItemDetails: The details of a specific verification.
        - `reason` string: A specific code that gives additional information on what caused the failure.
        - `expected_value` string: When available, the value that was expected in order to pass the validation.
        - `message` string: A user friendly message describing the failure.
    - `matching_account_holder` CounterpartyAccountsAccountVerificationItem: The result of a specific verification.
      - `result` 'valid' | 'invalid' | 'impossible_to_verify' | 'not_verified', required: The result of this specific verification.
      - `details` CounterpartyAccountsAccountVerificationItemDetails: The details of a specific verification.
        - `reason` string: A specific code that gives additional information on what caused the failure.
        - `expected_value` string: When available, the value that was expected in order to pass the validation.
        - `message` string: A user friendly message describing the failure.
    - `active_account` CounterpartyAccountsAccountVerificationItem: The result of a specific verification.
      - `result` 'valid' | 'invalid' | 'impossible_to_verify' | 'not_verified', required: The result of this specific verification.
      - `details` CounterpartyAccountsAccountVerificationItemDetails: The details of a specific verification.
        - `reason` string: A specific code that gives additional information on what caused the failure.
        - `expected_value` string: When available, the value that was expected in order to pass the validation.
        - `message` string: A user friendly message describing the failure.
  - `created_at` string, date-time, required: The UTC timestamp of the creation of this counterparty account.
  - `disabled_at` string, date-time: The UTC timestamp of the disabling of this counterparty account.
  - `metadata` object: Additional client data in JSON format. See [Metadata](https://docs.numeral.io/reference/metadata).
  - `custom_fields` CommonCustomFields, required: Custom fields in JSON `key:value` format. See [Custom fields](https://docs.numeral.io/reference/custom-fields).

## Other responses

- `400`: Validation error.
- `404`: The specified resource was not found.
- `409`: Conflict.

---

[API](https://skmtc.dev/numeral/apis/payments.md) - [All operations](https://skmtc.dev/numeral/apis/payments/llms.txt) - [OpenAPI document](https://skmtc.dev/numeral/apis/payments/revisions/220f101cc2ef?raw)