Update customer

curl --request PATCH \
  --url https://public-test.blips.network/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"
}

{
  "status": 400,
  "code": "INVALID_REQUEST",
  "message": "Invalid customer patch request.",
  "details": {
    "request": "At least one public patch field required"
  }
}

{
  "status": 401,
  "code": "UNAUTHORIZED",
  "message": "Unauthorized",
  "details": null
}

{
  "status": 404,
  "code": "NOT_FOUND",
  "message": "Customer not found",
  "details": null
}

{
  "status": 410,
  "code": "GONE",
  "message": "Customer already deleted",
  "details": null
}

{
  "status": 500,
  "code": "INTERNAL_ERROR",
  "message": "Internal service error.",
  "details": null
}

PATCH

customers

{customerId}

curl --request PATCH \
  --url https://public-test.blips.network/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"
}

{
  "status": 400,
  "code": "INVALID_REQUEST",
  "message": "Invalid customer patch request.",
  "details": {
    "request": "At least one public patch field required"
  }
}

{
  "status": 401,
  "code": "UNAUTHORIZED",
  "message": "Unauthorized",
  "details": null
}

{
  "status": 404,
  "code": "NOT_FOUND",
  "message": "Customer not found",
  "details": null
}

{
  "status": 410,
  "code": "GONE",
  "message": "Customer already deleted",
  "details": null
}

{
  "status": 500,
  "code": "INTERNAL_ERROR",
  "message": "Internal service error.",
  "details": null
}

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.

Show child attributes

Response

Customer updated.

Bounded public customer-record patch response.

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 | null

Current customer address when present on the record.

Show child attributes

Reference Overview

Platform Setup / Credentials

Customers

Accounts

Same-Currency Transfers

Cross-Currency Transfers

Transactions

Sandbox APIs

Authorizations

Path Parameters

Body

Response