Skip to main content
GET
/
customers
/
{customerId}
Get customer detail
curl --request GET \
  --url https://{publicHost}/customers/{customerId} \
  --header 'Authorization: Basic <encoded-value>'
{
  "id": "cust_123",
  "platformId": "plat_demo_001",
  "platformCustomerId": "partner_cust_001",
  "customerType": "INDIVIDUAL",
  "fullName": "Demo Customer",
  "birthDate": "1992-05-06",
  "nationality": "PH",
  "address": {
    "line1": "100 Demo Street",
    "line2": "Suite 5",
    "city": "Manila",
    "state": "NCR",
    "postalCode": "1000",
    "country": "PH"
  },
  "ppvAddress": "demo-customer@demo.blips.test",
  "kycStatus": "APPROVED",
  "createdAt": "2026-04-05T12:00:00Z",
  "updatedAt": "2026-04-05T12:00:00Z"
}

Authorizations

​
Authorization
string
header
required

Integration-key Basic Auth (clientId:clientSecret) as documented in docs/public/AUTHENTICATION.md.

Path Parameters

​
customerId
string
required

System-generated customer UUID for the customer record addressed by this endpoint.

Response

Customer detail returned.

Public customer-detail response. ppvAddress is current-state readback only and remains null until a customer payment address is explicitly issued.

​
id
string
required

Stable customer identifier.

​
platformId
string
required

Platform identifier that owns this customer.

​
platformCustomerId
string
required

Platform-provided customer identifier stored for this customer.

​
customerType
enum<string>
required

Customer type for this customer.

Available options:
INDIVIDUAL,
ENTITY
​
fullName
string
required

Public customer name stored for this customer.

​
ppvAddress
string | null
required

Current active PPV address for the customer when one has already been explicitly issued.

​
kycStatus
enum<string>
required

Current KYC status for the customer.

Available options:
PENDING,
APPROVED,
REJECTED
​
createdAt
string<date-time>
required

Creation timestamp.

​
updatedAt
string<date-time>
required

Last update timestamp.

​
birthDate
string<date> | null

Customer birth date in YYYY-MM-DD format when available.

​
nationality
string | null

Customer nationality or citizenship code when available.

​
address
object

Customer address when available.