Create a new customer

POST/customers

Create a new customer by providing their profile information. We recommend to provide as much information as possible to ensure accurate results and prevent false rejections.

Body application/json

namestringrequired

Name of the customer

genderstring

Gender of the customer

country_codestring

Country Code

emailstring<email>required

Email of the customer

dobstring<date>

Date of birth of the customer in format YYYY-MM-DD

Response

New Customer successfully created

idstring<uuid>

Unique ID for the Customer KYC record created

namestring

Name of the Customer

emailstring<email>

Email of the customer

dobstring<date>

Date of Birth of the customer

genderstring

Gender of the Customer

country_codestring

Country Code for the Country of Customer

kyc_statusstring

KYC status of the Customer after the details are inspected. verified or blocked

kyc_tiernumber

Tier of the customer set based on KYC details provided

retries_leftinteger

poiobject[]

Show poi properties

idstring<uuid>

created_atstring<date-time>

statusstring

declined_reasonstring

transaction_limitstring

Amount allowed in each transaction (in SGD)

Invalid Input

messagestring

errorsobject[]

Show errors properties

pathstring

messagestring

errorCodestring

Invalid/Expired Access Token

messagestring

errorsobject[]

Show errors properties

pathstring

messagestring

A Customer with provided Email already exists

messagestring

Server Error

messagestring

curl -X POST "https://api.triple-a.work/kyc-api/v1/customers" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer <token>" \ -d '{ "name": "John Doe", "gender": "Male", "country_code": "US", "email": "johndoe@example.com", "dob": "1992-10-10" }'

const response = await fetch(`https://api.triple-a.work/kyc-api/v1/customers`, { method: 'POST', headers: { 'Content-Type': 'application/json', 'Authorization': 'Bearer <token>' }, body: JSON.stringify({ "name": "John Doe", "gender": "Male", "country_code": "US", "email": "johndoe@example.com", "dob": "1992-10-10" }) }); const data = await response.json();

import requests response = requests.request( "POST", "https://api.triple-a.work/kyc-api/v1/customers", headers={ "Authorization": "Bearer <token>" }, json={ "name": "John Doe", "gender": "Male", "country_code": "US", "email": "johndoe@example.com", "dob": "1992-10-10" }, ) data = response.json()

<?php $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, "https://api.triple-a.work/kyc-api/v1/customers"); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST"); curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json", "Authorization: Bearer <token>"]); curl_setopt($ch, CURLOPT_POSTFIELDS, '{ "name": "John Doe", "gender": "Male", "country_code": "US", "email": "johndoe@example.com", "dob": "1992-10-10" }'); $response = curl_exec($ch); curl_close($ch);

package main import ( "fmt" "io" "net/http" "strings" ) func main() { req, _ := http.NewRequest("POST", "https://api.triple-a.work/kyc-api/v1/customers", strings.NewReader(`{ "name": "John Doe", "gender": "Male", "country_code": "US", "email": "johndoe@example.com", "dob": "1992-10-10" }`)) req.Header.Set("Content-Type", "application/json") req.Header.Set("Authorization", "Bearer <token>") resp, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer resp.Body.Close() data, _ := io.ReadAll(resp.Body) fmt.Println(string(data)) }

HttpClient client = HttpClient.newHttpClient(); HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://api.triple-a.work/kyc-api/v1/customers")) .header("Content-Type", "application/json") .header("Authorization", "Bearer <token>") .method("POST", HttpRequest.BodyPublishers.ofString("{\n \"name\": \"John Doe\",\n \"gender\": \"Male\",\n \"country_code\": \"US\",\n \"email\": \"johndoe@example.com\",\n \"dob\": \"1992-10-10\"\n}")) .build(); HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body());

require "net/http" require "uri" uri = URI("https://api.triple-a.work/kyc-api/v1/customers") http = Net::HTTP.new(uri.host, uri.port) http.use_ssl = uri.scheme == "https" request = Net::HTTP::Post.new(uri) request["Content-Type"] = "application/json" request["Authorization"] = "Bearer <token>" request.body = "{\n \"name\": \"John Doe\",\n \"gender\": \"Male\",\n \"country_code\": \"US\",\n \"email\": \"johndoe@example.com\",\n \"dob\": \"1992-10-10\"\n}" response = http.request(request) puts response.body

{ "id": "9598bb1a-4ce8-485b-a093-387656560624", "name": "John Doe", "email": "johndoe@example.com", "dob": "1992-10-10", "gender": "Male", "country_code": "US", "kyc_status": "verified", "kyc_tier": 1, "retries_left": 2, "poi": [], "transaction_limit": "1500 SGD" }

{ "message": "error message about wrong data in request.body", "errors": [ { "path": "parameter with error", "message": "description of error", "errorCode": "openapi validation error code" } ] }