Skip to main content
GET
/
persons
List persons
curl --request GET \
  --url https://api.synctera.com/v2/persons
{
  "persons": [
    {
      "ban_status": "ALLOWED",
      "chosen_name": "Annie",
      "creation_time": "2010-05-06T12:23:34.321Z",
      "customer_active": "2010-05-06T12:23:34.321Z",
      "dob": "2000-01-01",
      "email": "alice@example.com",
      "first_name": "Jane",
      "has_accounts": true,
      "id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
      "is_customer": true,
      "is_user": true,
      "last_name": "Smith",
      "last_updated_time": "2010-05-06T12:23:34.321Z",
      "legal_address": {
        "address_line_1": "100 Main St.",
        "address_line_2": "Suite 99",
        "address_type": "SHIPPING",
        "city": "New York",
        "country_code": "US",
        "id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
        "is_registered_agent": true,
        "nickname": "Home",
        "postal_code": "28620",
        "state": "NY"
      },
      "metadata": {},
      "middle_name": "Anne",
      "phone_number": "+14374570680",
      "shipping_address": {
        "address_line_1": "100 Main St.",
        "address_line_2": "Suite 99",
        "address_type": "SHIPPING",
        "city": "New York",
        "country_code": "US",
        "id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
        "is_registered_agent": true,
        "nickname": "Home",
        "postal_code": "28620",
        "state": "NY"
      },
      "ssn": "123-45-6789",
      "ssn_source": "MANUAL",
      "status": "ACTIVE",
      "tenant": "abcdef_ghijkl",
      "verification_last_run": "2010-05-06T12:23:34.321Z",
      "verification_status": "ACCEPTED",
      "personal_ids": [
        {
          "id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
          "id_type": "SSN",
          "identifier": "123-45-6789",
          "system_provided": true,
          "country_code": "<string>",
          "expiry_date": "2020-01-01",
          "issue_date": "2020-01-01"
        }
      ],
      "classifications": [
        "BANK_CUSTOMER"
      ],
      "vendor_info": {
        "vendor_data": {
          "loanpro": {
            "customer_id": 12345
          }
        },
        "vendor_type": "LOANPRO"
      }
    }
  ],
  "next_page_token": "a8937a0d"
}

Query Parameters

​
id
string<uuid>[]

Unique identifier for the resource. Multiple IDs can be provided as a comma-separated list.

Example:

"64438afd-fa20-4010-a573-2bbdca77cdb6,84ef251c-ab8f-47a5-bbfd-a16648f95157"

​
first_name
string

Only return resources where the first_name or chosen_name field matches the specified string. Any * characters in the string are wildcards, and match any characters.

Example:

"Alice"

​
last_name
string

Only return resources where the last_name field matches the specified string. Any * characters in the string are wildcards, and match any characters.

Example:

"Smith"

​
dob
string<date>

Only return resources where the date of birth matches the specified value.

Example:

"1980-12-25"

​
phone_number
string

Only return resources where the phone_number field matches the specified string. Phone numbers use the E.164 format e.g. +19178675309. Any * characters in the string are wildcards, and match any characters.

Example:

"+12065550100"

​
email
string

Only return resources where the email field matches the specified string. Any * characters in the string are wildcards, and match any characters.

Example:

"john.doe@example.com"

​
ssn_last_4
string

Only return resources where the last 4 characters of the SSN match the specified value.

Required string length: 4
Example:

"6789"

​
ban_status
enum<string>[]

Ban status of the person. Multiple values can be provided as a comma-seperated list of the following:

  • ALLOWED – person is not banned or suspended
  • SUSPENDED - person is suspended
  • BANNED – person is banned
​
status
enum<string>

Status of the person. One of the following:

  • ACTIVE – is an integrator defined status. Integrators should set a person to active if they believe the person to be qualified for conducting business. Synctera will combine this status with other statuses such a verification to determine if the person is eligible for specific actions such as initiating transactions or issuing a card.
  • DECEASED – person is deceased.
  • DENIED – customer was turned down.
  • DORMANT – person is no longer active.
  • ESCHEAT – person's assets are abandoned and are property of the state.
  • FROZEN – person's actions are blocked for security, legal, or other reasons.
  • INACTIVE – an inactive status indicating that the person is no longer active.
  • PROSPECT – a potential customer, used for information-gathering and disclosures.
  • SANCTION – person is on a sanctions list and should be carefully monitored.
Available options:
ACTIVE,
DECEASED,
DENIED,
DORMANT,
ESCHEAT,
FROZEN,
INACTIVE,
PROSPECT,
SANCTION
Example:

"ACTIVE"

​
verification_status
enum<string>[]

Verification status of the person. Multiple values can be provided as a comma-seperated list of the following:

  • UNVERIFIED – verification has not been completed for this customer.
  • PENDING – verification is in progress for this customer.
  • PROVISIONAL – partially verified or verified with restrictions.
  • ACCEPTED – the customer has been verified.
  • REVIEW – verification has run and issues have been identified and require review.
  • REJECTED – the customer was rejected and should not be allowed to take certain actions e.g., open an account.
​
is_customer
boolean

If true, show only customers. If false, show non-customer parties.

​
limit
integer
default:100

Maximum number of objects to return per page. If the limit is greater than 100, then it will be set to 100.

Required range: x >= 1
Example:

100

​
page_token
string

Optional pagination token to be provided to retrieve subsequent pages, returned from previous get

Example:

"a8937a0d"

​
sort_by
enum<string>[]

Specifies the sort order for the returned persons.

​
has_accounts
boolean

Filter on resources that have an account(s)

​
include_console_users
boolean

includes the person representations of available console users in the person get respsonse.

​
classifications
enum<string>[]

Specifies the classification of a party for banks. It can contain multiple values.

Response

List of persons.

​
persons
object[]
required

Array of persons.

​
next_page_token
string

If returned, use the next_page_token to query for the next page of results. Not returned if there are no more rows.

Example:

"a8937a0d"