Get Customer

Retrieves detailed information about a specific customer including balances, contact information, and status.

Endpoint

POST/v2/customer/{customerId}

Link

Gateway APIstagep.tst-apidmndelss.com

Request

Path Parameters

Parameter	Type	Description	Required	Example
customerId	string	Customer ID to retrieve.	Yes	"DqCsgSE-4e95-ViYbNI"

Headers

Key	Value	Required
Authorization	Bearer <JWT>	Yes
Accept	application/json	Yes

---

Response (200 OK)

Returns a customer object with complete details.

Response Fields

Field	Type	Description	Example
cuid	string	Customer unique ID.	"DqCsgSE-4e95-ViYbNI"
puid	string	Partner/user ID.	"127c9ea7-3ea7-4063-9fa4-c69e796c55e4"
status	string	Current status: - NEW - READY_FOR_MODERATION - MODERATED - VERIFY - ACCEPT - REJECT - BANNED	"ACCEPT"
createAt	string	Creation timestamp (ISO 8601).	"2024-01-15T10:30:00Z"
updateAt	string	Last update timestamp (ISO 8601).	"2024-05-20T14:45:00Z"
name	string	First name or company name.	"John" or "Acme Inc."
lastname	string	Last name (individuals only).	"Doe"
comment	string	Internal notes/comments.	"VIP client"
company	string	Company name (if corporate).	"Acme Corporation"
type	string	CORPORATE or INDIVIDUAL.	"INDIVIDUAL"
balance	object	Available balance (Money Object).	-
balanceHold	object	Held/restricted balance (Money Object).	-
phone	string	Contact phone number.	"[phone]"
email	string	Contact email address.	"[email protected]"

Money Object

Field	Type	Description	Example
currencyCode	string	Currency code (ISO 4217).	"USD"
units	string	Whole units.	"1500"
nanos	integer	Fractional units (10^-9).	500000000 (= $0.50)

Example Response:

json

{
  "item": {
    "cuid": "DqCsgSE-4e95-ViYbNI",
    "puid": "127c9ea7-3ea7-4063-9fa4-c69e796c55e4",
    "status": "ACCEPT",
    "createAt": "2024-01-15T10:30:00Z",
    "updateAt": "2024-05-20T14:45:00Z",
    "name": "John",
    "lastname": "Doe",
    "comment": "VIP client",
    "company": "",
    "type": "INDIVIDUAL",
    "balance": {
      "currencyCode": "USD",
      "units": "1500",
      "nanos": 500000000
    },
    "balanceHold": {
      "currencyCode": "USD",
      "units": "250",
      "nanos": 0
    },
    "phone": "[phone]",
    "email": "[email protected]"
  }
}

Translation: $1500.50 available, $250.00 on hold

---

Examples

Request

bash

curl -X GET 'https://stagep.tst-apidmndelss.com/v2/customer/cust_12345' \
  -H 'Authorization: Bearer eyJhbGci...wNLGA' \
  -H 'Accept: application/json'

Corporate Customer Example

Response:

json

{
  "item": {
    "cuid": "DqCsgSE-4e95-ViYbNI",
    "puid": "127c9ea7-3ea7-4063-9fa4-c69e796c55e4",
    "status": "ACCEPT",
    "createAt": "2024-02-20T09:15:00Z",
    "updateAt": "2024-05-18T16:20:00Z",
    "name": "Tech Solutions Ltd",
    "lastname": "",
    "comment": "Enterprise account",
    "company": "Tech Solutions Group",
    "type": "CORPORATE",
    "balance": {
      "currencyCode": "EUR",
      "units": "50000",
      "nanos": 0
    },
    "balanceHold": {
      "currencyCode": "EUR",
      "units": "10000",
      "nanos": 0
    },
    "phone": "[phone]",
    "email": "[email protected]"
  }
}

---

Error Responses

1. Customer Not Found:

   json

   { "error": "Customer not found: DqCsgSE-4e95-ViYbNI" }

2. Unauthorized:

   json

   { "error": "Unauthorized" }

---

Notes

• Balance Types:

  • balance: Available for transactions
  • balanceHold: Temporarily locked (pending transactions, reserves)
• Status Flow:

  • NEW → MODERATED → ACCEPT (typical flow)
  • BANNED accounts cannot perform transactions
• Contact Info: Phone/email may be masked for privacy ("j***@example.com")

Real request example

Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOjE2NCwiZXhwIjoxNzYxNTYzMDE4LCJrZXkiOiI1Y2ZiOGZjN2RmYjk4ZjVkYmIyZTgwNTVkZWFhN2U2Zjk4MzEyYmE3Iiwib3RwX3ZlcmlmaWVkIjpmYWxzZX0.ya9eUQUvAB1OROjjinA36fULCTAWCLengiPCxXVMsrU
customerId*: D7k3xbc-ERrj-lde9k1t3XuaE

Real response example

200 OK

{
  "item": {
    "customerId": "D7k3xbc-ERrj-lde9k1t3XuaE",
    "partnerId": "3354815d-1a23-4b1c-81ec-306388cddfa4",
    "status": "ACCEPT",
    "createAt": "2025-09-16T11:33:11Z",
    "updateAt": "2025-10-02T09:03:23Z",
    "name": "SIRIUS SOLUTIONS LTD",
    "lastname": "",
    "comment": "",
    "company": "SIRIUS SOLUTIONS LTD",
    "type": "CORPORATE",
    "balance": {
      "currencyCode": "USD",
      "units": "2835",
      "nanos": 800000002
    },
    "balanceHold": {
      "currencyCode": "USD",
      "units": "3144",
      "nanos": 199999998
    },
    "phone": "[phone]",
    "email": "[email protected]"
  }
}