---
title: "Assign virtual account to counterparty"
method: POST
path: "/virtual_accounts/{virtual_account_id}/counterparties/{counterparty_id}/assign"
tags: ["Virtual Accounts"]
deprecated: true
---

# Assign virtual account to counterparty

`POST /virtual_accounts/{virtual_account_id}/counterparties/{counterparty_id}/assign`

## Request

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

> **Deprecated.**

Assign a virtual account to a counterparty.

## Path parameters

- `virtual_account_id` string, uuid, required
- `counterparty_id` string, uuid, required

## Response `200`

200

- VirtualAccountsVirtualAccount
  - `id` string, uuid, required: The UUID of the virtual account.
  - `object` 'virtual_account', required: The object, here `virtual_account`.
  - `name` string, required: The name of the virtual account.
  - `virtual_account_number` string, required: The virtual account number.
  - `connected_account_id` string, uuid, required: The ID of the connected account to which the virtual account refers.
  - `counterparty_id` string, uuid, nullable, required: The ID of the counterparty to which the virtual account refers to.
  - `metadata` object, required: Additional client data in JSON format. See [Metadata](https://docs.numeral.io/reference/metadata).
  - `disabled_at` string, date-time, required: The UTC timestamp of the disabling of this virtual account.
  - `created_at` string, date-time, required: The UTC timestamp of the creation of this virtual account.

## Other responses

- `400`: Validation error.

---

[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)