Customers
Use this API to create a customer, update their details, and get their details.
Upon successful customer creation, a hosted KYC link requesting the required information to fill in will be generated. This may be distributed to your end-user for completion, or it can be completed on the customer's behalf by your team.
Authorizations
Body
Request payload for creating a new customer account
customerTypeany ofRequired
The type of customer - either individual or business
string · enumOptionalPossible values:
string · enumOptionalPossible values:
firstNamestringOptionalExample:
First name of the customer
John
lastNamestringOptionalExample:
Last name of the customer
Doe
businessNamestringOptionalExample:
Name of the business
John Doe Inc.
emailstring · emailRequiredExample:
Email of the customer
john.doe@example.com
Responses
201
Response schema for a customer retrieval request
application/json
400
Bad Request
application/json
401
Unauthorized
application/json
403
Forbidden
application/json
404
Not Found
application/json
500
Internal Server Error
application/json
post
Get details about a customer
Authorizations
Path parameters
customerIdstring · uuidRequiredExample:
Unique identifier of the customer
03b7030f-6da1-4d76-9352-cdebd82112c8
Responses
200
Response schema for a customer retrieval request
application/json
400
Bad Request
application/json
401
Unauthorized
application/json
403
Forbidden
application/json
404
Not Found
application/json
500
Internal Server Error
application/json
get
List all customers
Authorizations
Query parameters
pageTokenstringOptionalExample:
Page token to fetch entries after
abc
pageSizeinteger · min: 1 · max: 100OptionalExample:
Number of entries to fetch
10
Responses
200
Default Response
application/json
400
Bad Request
application/json
401
Unauthorized
application/json
403
Forbidden
application/json
404
Not Found
application/json
500
Internal Server Error
application/json
get
Last updated