---
title: "Apply for a USD IBAN"
method: POST
path: "/v1/apply-usd-payin"
tags: ["Managed Custody Mode"]
---

# Apply for a USD IBAN

`POST /v1/apply-usd-payin`

Request a USD deposit IBAN for a Live user. The call is synchronous; UR creates the USD IBAN immediately and it then appears under the USD key of depositBank in the BR profile. The user is identified by urId in the request body.

## Headers

- `X-Api-Signature` string, required
- `X-Api-Deadline` string, required
- `X-Api-PublicKey` string, required

## Request body

- McApplyUsdPayinRequest
  - `urId` integer, required — The user's URID (numeric token ID of the URID NFT).
  - `remark` string, required — Free-text remark for the USD IBAN application.

## Response `200`

Standard envelope. Business errors return HTTP 200 with a non-zero code.

- McApplyUsdPayinResponse — Standard UR OpenAPI response envelope. code 0 means success; a non-zero code is a business error described by message.
  - `code` integer, required — 0 on success; non-zero business error code.
  - `message` string, required — Human-readable explanation. May be empty on success.
  - `data` McApplyUsdPayinData
    - `applyId` integer — Identifier of the USD IBAN application.

---

[API](https://skmtc.net/ur/apis/ur-api.md) · [All operations](https://skmtc.net/ur/apis/ur-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ur/ur-api/revisions/087dcf516ce2/schema)