---
title: "Register an account"
method: POST
path: "/open-api/v3/accounts/register"
tags: ["Accounts"]
---

# Register an account

`POST /open-api/v3/accounts/register`

Account registration interface, used to register a new user account with required information.

## Request body

- AccountRegisterReqDTO
  - `phoneCountryCode` string — The international dialing code of the user's mobile number, numbers only, no "+", length ≤ 3. Example: 86
  - `phoneNumber` string — User's phone number with the country code. Example: 14155552671
  - `email` string, required — User's email address. Example: user@gmail.com
  - `name` string, required — Name of the account holder. Example: John Smith
  - `parentAccountId` string — This field is required for Distributor mode.<br> If the downstream merchant operates in Gateway mode, this field must be the master-merchant account ID.<br> Sub-merchant account IDs are not supported.

## Response `200`

OK

- AccountRegisterDataVO
  - `code` string — Error code
  - `message` string — Error message
  - `data` CommonAccountRegisterVO, required — data
    - `id` string, required — Unique ID generated for the account entity.
    - `type` integer, required — account type 0:api client 1:api client customer
    - `status` string, required — The status of the account object. Possible values: NA – Status not available or not yet assigned. ACTIVE – Account is active and available for use. CONTROL – Account is under control or monitoring due to compliance/risk checks. PENDING – Account is in the process of activation or under review. FROZEN – Account is temporarily disabled and cannot be used. CLEARED – Account has been cleared, closed, or fully settled.
    - `verifiedName` string — account name
    - `verifiedNameEn` string — account name english
    - `displayId` string, required — The unique numeric ID assigned.
    - `createTime` string, required — The create time of the account.

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/interlace/apis/core-resource.md) · [All operations](https://skmtc.net/interlace/apis/core-resource/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/interlace/core-resource/revisions/29c08a4da357/schema)