1. Customers
Artha Payments API
  • Introduction
  • Customers
    • Create Customer
      POST
    • List Customers
      GET
    • Get Customer
      GET
    • Update Customer
      PATCH
  • Manage Account
    • Get Payout Currencies
      GET
    • Save Payout Currency
      POST
    • Update Payout Currency State
      PUT
  • Payees
    • Get Fiat Payees List (Grid)
      GET
    • View Fiat Payee Details
      GET
    • Get Recipient Form Fields
      GET
    • Get Payees Lookup Data
      GET
    • Get Phone Codes Lookup
      GET
    • Get Countries With States Lookup
      GET
    • Get Payee Countries
      GET
    • Get Currencies With Countries
      GET
    • Create Fiat Payee
      POST
    • Update Fiat Payee
      PUT
    • Update Payee State (Admin)
      PUT
  • Payout Screen
    • Get Merchant Crypto Payout Config
      GET
    • Get Active Fiat Payout Currencies
      GET
    • Get Fiat Payees
      GET
    • Get Payment Purposes
      GET
    • Get Source Of Funds
      GET
    • Payments Lookup (Core)
      GET
    • Get Transfer Types
      GET
    • Get Crypto Payout Fee
      POST
    • Create Crypto Payout
      POST
    • Payments Order Creation (Provider)
      POST
    • Get Crypto Payout Transactions
      GET
  1. Customers

Update Customer

PATCH
/baseurl/api/v1/Customers/{customerId}
Last modified:2026-07-17 05:19:15
Partially updates a customer's profile.
Optional Fields
FieldTypeDescriptionConstraints
firstNamestring-Max: 100 · Nullable
middleNamestring-Max: 100 · Nullable
lastNamestring-Max: 100 · Nullable
emailstring (email)-Nullable
phoneCodestring-Nullable
phoneNumberstring-Nullable
countrystring-Min: 2 · Max: 2 · Nullable
statestring-Nullable
dateOfBirthstring (date)-Nullable
genderstring-Nullable
addressobjectaddressLine1, addressLine2, city, state, postalCode, country-
businessobjectbusinessName, registrationNumber, taxId, incorporationDate, website, industry, companyType-

Request

Path Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200
application/json
Customer updated successfully.
Bodyapplication/json

🟠401
🟠404
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PATCH '/baseurl/api/v1/Customers/' \
--header 'X-API-Key;' \
--header 'X-Signature;' \
--header 'X-Timestamp;' \
--header 'X-Nonce;' \
--header 'X-Body-Hash;' \
--header 'Content-Type: application/json' \
--data '{
    "firstName": "Janet",
    "phoneNumber": "7700999888",
    "address": {
        "addressLine1": "10 Downing Street",
        "city": "London",
        "postalCode": "SW1A 2AA",
        "country": "GB"
    }
}'
Response Response Example
{
    "id": "cst_789012",
    "type": "business",
    "firstName": null,
    "lastName": null,
    "email": "contact@acme.com",
    "phoneCode": "+91",
    "phoneNumber": "9123456789",
    "country": "India",
    "status": "Active",
    "businessName": "Acme Pvt Ltd",
    "createdAt": "2026-03-30T11:45:00Z"
}
Modified at 2026-07-17 05:19:15
Previous
Get Customer
Next
Get Payout Currencies
Built with