Get Customer

curl --request GET \
  --url https://api-sandbox.synctera.com/v0/customers/{customer_id} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api-sandbox.synctera.com/v0/customers/{customer_id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api-sandbox.synctera.com/v0/customers/{customer_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api-sandbox.synctera.com/v0/customers/{customer_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api-sandbox.synctera.com/v0/customers/{customer_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api-sandbox.synctera.com/v0/customers/{customer_id}")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api-sandbox.synctera.com/v0/customers/{customer_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "vendor_info": {
    "vendor_data": {
      "loanpro": {
        "customer_id": 12345
      }
    },
    "vendor_type": "LOANPRO"
  },
  "addresses": [
    {
      "address_line_1": "100 Main St.",
      "country_code": "US",
      "address_line_2": "Suite 99",
      "address_type": "SHIPPING",
      "city": "New York",
      "id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
      "is_registered_agent": true,
      "nickname": "Home",
      "postal_code": "28620",
      "state": "NY"
    }
  ],
  "ban_status": "ALLOWED",
  "classifications": [],
  "creation_time": "2010-05-06T12:23:34.321Z",
  "email": "alice@example.com",
  "has_accounts": true,
  "id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
  "kyc_exempt": true,
  "kyc_last_run": "2010-05-06T12:23:34.321Z",
  "last_updated_time": "2010-05-06T12:23:34.321Z",
  "legal_address": {
    "address_line_1": "100 Main St.",
    "country_code": "US",
    "address_line_2": "Suite 99",
    "address_type": "SHIPPING",
    "city": "New York",
    "id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
    "is_registered_agent": true,
    "nickname": "Home",
    "postal_code": "28620",
    "state": "NY"
  },
  "metadata": {},
  "middle_name": "Anne",
  "phone_number": "+14374570680",
  "related_customers": [
    {
      "id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
      "relationship_role": "CUSTODIAN"
    }
  ],
  "shipping_address": {
    "address_line_1": "100 Main St.",
    "country_code": "US",
    "address_line_2": "Suite 99",
    "address_type": "SHIPPING",
    "city": "New York",
    "id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
    "is_registered_agent": true,
    "nickname": "Home",
    "postal_code": "28620",
    "state": "NY"
  },
  "spend_control_ids": [
    "7d943c51-e4ff-4e57-9558-08cab6b963c7"
  ],
  "ssn": "123-45-6789",
  "tenant": "abcdef_ghijkl",
  "dob": "2000-01-01",
  "first_name": "Jane",
  "last_name": "Smith"
}

{
  "code": "BAD_REQUEST_BODY",
  "detail": "missing required fields: first_name, dob",
  "status": 400,
  "title": "Bad Request Body",
  "type": "https://dev.synctera.com/errors/bad-request-body"
}

{
  "code": "BAD_REQUEST_BODY",
  "detail": "missing required fields: first_name, dob",
  "status": 400,
  "title": "Bad Request Body",
  "type": "https://dev.synctera.com/errors/bad-request-body"
}

{
  "code": "BAD_REQUEST_BODY",
  "detail": "missing required fields: first_name, dob",
  "status": 400,
  "title": "Bad Request Body",
  "type": "https://dev.synctera.com/errors/bad-request-body"
}

{
  "code": "BAD_REQUEST_BODY",
  "detail": "missing required fields: first_name, dob",
  "status": 400,
  "title": "Bad Request Body",
  "type": "https://dev.synctera.com/errors/bad-request-body"
}

{
  "code": "BAD_REQUEST_BODY",
  "detail": "missing required fields: first_name, dob",
  "status": 400,
  "title": "Bad Request Body",
  "type": "https://dev.synctera.com/errors/bad-request-body"
}

GET

customers

{customer_id}

Get Customer

curl --request GET \
  --url https://api-sandbox.synctera.com/v0/customers/{customer_id} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api-sandbox.synctera.com/v0/customers/{customer_id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api-sandbox.synctera.com/v0/customers/{customer_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api-sandbox.synctera.com/v0/customers/{customer_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api-sandbox.synctera.com/v0/customers/{customer_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api-sandbox.synctera.com/v0/customers/{customer_id}")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api-sandbox.synctera.com/v0/customers/{customer_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "vendor_info": {
    "vendor_data": {
      "loanpro": {
        "customer_id": 12345
      }
    },
    "vendor_type": "LOANPRO"
  },
  "addresses": [
    {
      "address_line_1": "100 Main St.",
      "country_code": "US",
      "address_line_2": "Suite 99",
      "address_type": "SHIPPING",
      "city": "New York",
      "id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
      "is_registered_agent": true,
      "nickname": "Home",
      "postal_code": "28620",
      "state": "NY"
    }
  ],
  "ban_status": "ALLOWED",
  "classifications": [],
  "creation_time": "2010-05-06T12:23:34.321Z",
  "email": "alice@example.com",
  "has_accounts": true,
  "id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
  "kyc_exempt": true,
  "kyc_last_run": "2010-05-06T12:23:34.321Z",
  "last_updated_time": "2010-05-06T12:23:34.321Z",
  "legal_address": {
    "address_line_1": "100 Main St.",
    "country_code": "US",
    "address_line_2": "Suite 99",
    "address_type": "SHIPPING",
    "city": "New York",
    "id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
    "is_registered_agent": true,
    "nickname": "Home",
    "postal_code": "28620",
    "state": "NY"
  },
  "metadata": {},
  "middle_name": "Anne",
  "phone_number": "+14374570680",
  "related_customers": [
    {
      "id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
      "relationship_role": "CUSTODIAN"
    }
  ],
  "shipping_address": {
    "address_line_1": "100 Main St.",
    "country_code": "US",
    "address_line_2": "Suite 99",
    "address_type": "SHIPPING",
    "city": "New York",
    "id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
    "is_registered_agent": true,
    "nickname": "Home",
    "postal_code": "28620",
    "state": "NY"
  },
  "spend_control_ids": [
    "7d943c51-e4ff-4e57-9558-08cab6b963c7"
  ],
  "ssn": "123-45-6789",
  "tenant": "abcdef_ghijkl",
  "dob": "2000-01-01",
  "first_name": "Jane",
  "last_name": "Smith"
}

{
  "code": "BAD_REQUEST_BODY",
  "detail": "missing required fields: first_name, dob",
  "status": 400,
  "title": "Bad Request Body",
  "type": "https://dev.synctera.com/errors/bad-request-body"
}

{
  "code": "BAD_REQUEST_BODY",
  "detail": "missing required fields: first_name, dob",
  "status": 400,
  "title": "Bad Request Body",
  "type": "https://dev.synctera.com/errors/bad-request-body"
}

{
  "code": "BAD_REQUEST_BODY",
  "detail": "missing required fields: first_name, dob",
  "status": 400,
  "title": "Bad Request Body",
  "type": "https://dev.synctera.com/errors/bad-request-body"
}

{
  "code": "BAD_REQUEST_BODY",
  "detail": "missing required fields: first_name, dob",
  "status": 400,
  "title": "Bad Request Body",
  "type": "https://dev.synctera.com/errors/bad-request-body"
}

{
  "code": "BAD_REQUEST_BODY",
  "detail": "missing required fields: first_name, dob",
  "status": 400,
  "title": "Bad Request Body",
  "type": "https://dev.synctera.com/errors/bad-request-body"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

customer_id

string<uuid>

required

The customer's unique identifier

Example:

"7d943c51-e4ff-4e57-9558-08cab6b963c7"

Response

Customer

Prospect
Customer

Details of a prospect

status

enum<string>

required

Customer's status

Available options:

ACTIVE,

DECEASED,

DENIED,

DORMANT,

ESCHEAT,

FROZEN,

INACTIVE,

PROSPECT,

SANCTION

vendor_info

object

Vendor information for external account management systems

Show child attributes

addresses

object[]

read-only

All of the customer's addresses

Show child attributes

ban_status

enum<string>

(beta) Ban status of the person. One of the following:

ALLOWED – person is not banned or suspended
SUSPENDED - person is manually suspended due to fraud
BANNED – person is banned due to matching ban rules Note: changing the ban status to or from BANNED can only be performed by the Synctera platform based on ban rules.

Available options:

ALLOWED,

BANNED,

SUSPENDED

Example:

"ALLOWED"

classifications

enum<string>[]

read-only

Specifies the classification of a party for banks. This may contain multiple values for a combined classifications list of customers.

Specifies the classification of a party.

Available options:

AUTHORIZED_USER,

BANK_CUSTOMER,

INACTIVE_BANK_CUSTOMER,

PROSPECT

creation_time

string<date-time>

read-only

The date and time the resource was created.

Example:

"2010-05-06T12:23:34.321Z"

string

Customer's email

Example:

"alice@example.com"

has_accounts

boolean

read-only

This flag indicates whether the person or business has accounts.

string<uuid>

read-only

Customer unique identifier

Example:

"7d943c51-e4ff-4e57-9558-08cab6b963c7"

kyc_exempt

boolean

read-only

Customer's KYC exemption

kyc_last_run

string<date-time>

read-only

Date and time KYC was last run on the customer

Example:

"2010-05-06T12:23:34.321Z"

kyc_status

enum<string>

read-only

Customer's KYC status

Available options:

ACCEPTED,

PENDING,

PROVIDER_FAILURE,

PROVISIONAL,

REJECTED,

REVIEW,

UNVERIFIED

last_updated_time

string<date-time>

read-only

The date and time the resource was last updated.

Example:

"2010-05-06T12:23:34.321Z"

legal_address

object

Legal address

Show child attributes

metadata

object

User-supplied metadata. Do not use to store PII.

middle_name

string

Customer's middle name

Example:

"Anne"

phone_number

string

Customer's mobile phone number with country code in E.164 format. Must have a valid country code. Area code and local phone number are not validated.

Pattern: ^\+[1-9]\d{1,14}$

Example:

"+14374570680"

Customer's relationships with other accounts eg. guardian. This property is no longer supported. Setting it will return an error.

Show child attributes

shipping_address

object

Shipping address

Show child attributes

spend_control_ids

string<uuid>[]

List of spend control IDs to control spending for the customer

Maximum array length: 100

ssn

string

Customer's full tax ID eg SSN formatted with hyphens. This optional parameter is required when running KYC on a customer. Input must match the pattern ^\d{3}-\d{2}-\d{4}$. The response contains the last 4 digits only (e.g. 6789).

Example:

"123-45-6789"

ssn_source

enum<string>

read-only

Describes the collection method for the customer's SSN:

MANUAL – the full 9 digits of the customer's SSN was collected.
PREFILL – the customer's SSN was collected using SSN Prefill.

Available options:

MANUAL,

PREFILL

tenant

string

The id of the tenant containing the resource. This is relevant for Fintechs that have multiple workspaces.

Example:

"abcdef_ghijkl"

dob

string<date>

Customer's date of birth in RFC 3339 full-date format (YYYY-MM-DD)

Example:

"2000-01-01"

first_name

string

Customer's first name

Example:

"Jane"

last_name

string

Customer's last name

Example:

"Smith"

Create a Customer Patch Customer

⌘I

Synctera API

Customers

Accounts

Cards

Money Movement

Transactions

Platform

Simulations

Deprecated

Get Customer

Authorizations

Path Parameters

Response