---
title: "Generate a crypto address"
method: POST
path: "/addresses/take"
tags: ["Deposit addresses"]
---

# Generate a crypto address

`POST /addresses/take`

Generate a deposit address for a user.

## Headers

- `X-Processing-Signature` string, required

## Request body

- object
  - `currency` string, required — The currency to receive. For a list of all available currencies, see [API currency codes](/api-reference/currency-codes).
  - `convert_to` string — Automatically convert all deposits to this currency. If omitted, no automatic conversion is applied.
  - `foreign_id` string, required — The unique ID of the customer who will be depositing to this address. It will be returned with every callback to make it easy for you to identify the customer within your system. The same `foreign_id` can be reused across multiple addresses that belong to the same customer. This parameter must not include any personal data.
  - `end_user_reference` string, required — Permanent ID of the customer in your system. Used to group, track, and analyze transactions made by a specific customer. Must not contain personal data, such as the user's name or email address.
  - `sender_type` 'natural' | 'legal', required — Type of the merchant's customer who sends the funds. Use `natural` if the sender is an individual person and `legal` if the sender is a legal entity. The selected type determines which fields must be included in `sender_data`.
  - `sender_data` SenderData, required — Must contain the details of the merchant's customer who sends the funds. - If `sender_type` is `natural`, include `first_name`, `last_name`, and `date_of_birth`. Do not include `legal_name` or `country_of_registration`. - If `sender_type` is `legal`, include `legal_name` and `country_of_registration`. Do not include `first_name`, `last_name`, or `date_of_birth`.
    - `first_name` string, required — The sender's first name. This is required for a natural person. For a legal entity, do not include this parameter.
    - `last_name` string, required — The sender's last name. This is required for a natural person. For a legal entity, do not include this parameter.
    - `date_of_birth` string, required — The sender's date of birth, YYYY-MM-DD. This is required for a natural person. For a legal entity, do not include this parameter.
    - `legal_name` string, required — The company's name. This is required for a legal entity. For a natural person, do not include this parameter.
    - `country_of_registration` string, required — The company's country of registration (ISO alpha-3 format, three characters). This is required for a legal entity. For a natural person, do not include this parameter.

## Response `201`

Created

- object
  - `data` object
    - `id` integer — Address ID.
    - `currency` string — Currency code.
    - `convert_to` string — The currency all deposits to this address will be converted to. It is only returned if you included `convert_to` in the request.
    - `address` string — The generated address.
    - `tag` string — Destination tag/memo for currencies that require it. `Null` for currencies that do not require tags.
    - `foreign_id` string — ID of the customer who will be depositing to this address.
    - `end_user_reference` string — Permanent ID of the customer in your system.

## Other responses

- `400` — Bad Request.
- `403` — Forbidden
- `422` — Unprocessable entity. An infrastructure or blockchain-related error occurred while issuing the address.

---

[API](https://skmtc.dev/cryptoprocessing/apis/merchant-backend-v2.md) · [All operations](https://skmtc.dev/cryptoprocessing/apis/merchant-backend-v2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cryptoprocessing/merchant-backend-v2/revisions/623a41f26c6b/schema)