Skip to main content
PATCH
/
customers
/
{customerId}
curl --request PATCH \
  --url https://{publicHost}/customers/{customerId} \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "fullName": "Patricia Rivera",
  "birthDate": "1992-05-06",
  "nationality": "PH",
  "address": {
    "line1": "200 Updated Street",
    "line2": "Suite 5",
    "city": "Quezon City",
    "state": "NCR",
    "postalCode": "1100",
    "country": "PH"
  },
  "kycStatus": "APPROVED"
}
'
{
  "id": "00000000-0000-4000-8000-000000000001",
  "platformId": "plat_demo_001",
  "platformCustomerId": "partner_cust_9f8b2c7d",
  "customerType": "INDIVIDUAL",
  "fullName": "Patricia Rivera",
  "birthDate": "1992-05-06",
  "nationality": "PH",
  "address": {
    "line1": "200 Updated Street",
    "line2": "Suite 5",
    "city": "Quezon City",
    "state": "NCR",
    "postalCode": "1100",
    "country": "PH"
  },
  "kycStatus": "APPROVED",
  "createdAt": "2026-04-05T12:00:00Z",
  "updatedAt": "2026-04-05T12:15: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.

Body

application/json

Send at least one valid mutable customer-record field in the PATCH body. PATCH updates the customer record itself and does not require resending the full customer payload.

At least one valid mutable customer-record field is required. PATCH updates the customer record itself rather than replacing it.

​
fullName
string

Updated customer full name for the record.

​
kycStatus
enum<string>

Updated KYC status for the customer record when that field should change.

Available options:
PENDING,
APPROVED,
REJECTED
​
birthDate
string<date>

Updated birth date in YYYY-MM-DD format.

​
nationality
string

Updated nationality or citizenship value for the customer record.

​
address
object

Updated address fields for the customer record.

Response

Customer updated.

Bounded public customer-record patch response.

​
id
string
required

BLIPS customer ID.

​
platformId
string
required

Platform owner ID for the customer record.

​
platformCustomerId
string
required

Platform-side customer identifier for this record.

​
customerType
enum<string>
required

Customer type for the existing customer record.

Available options:
INDIVIDUAL,
ENTITY
​
fullName
string
required

Current public customer name on the record.

​
kycStatus
enum<string>
required

Current KYC status for the customer record.

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

Creation timestamp.

​
updatedAt
string<date-time>
required

Last update timestamp.

​
birthDate
string<date> | null

Birth date when present on the customer record.

​
nationality
string | null

Nationality or citizenship when present on the customer record.

​
address
object

Current customer address when present on the record.