Skip to main content
GET
/
relationships
List relationships
curl --request GET \
  --url https://api.synctera.com/v2/relationships
{
  "relationships": [
    {
      "additional_data": {
        "title": "OFFICER"
      },
      "creation_time": "2010-05-06T12:23:34.321Z",
      "from_person_id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
      "id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
      "last_updated_time": "2010-05-06T12:23:34.321Z",
      "metadata": {},
      "relationship_type": "BENEFICIAL_OWNER_OF",
      "tenant": "abcdef_ghijkl",
      "to_business_id": "7d943c51-e4ff-4e57-9558-08cab6b963c7"
    }
  ],
  "next_page_token": "a8937a0d"
}

Query Parameters

​
id
string<uuid>[]

Unique resource identifier

​
from_person_id
string<uuid>[]

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

Example:

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

​
from_business_id
string<uuid>[]

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

Example:

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

​
to_business_id
string<uuid>[]

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

Example:

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

​
relationship_type
enum<string>[]

The relationship type, any of the following. All direct businesses customers need at least one beneficial owner or controlling person.

  • BENEFICIAL_OWNER_OF – a person who directly or indirectly owns a portion of the business.
  • MANAGING_PERSON_OF – a person who is an officer, director, or controlling person of an organization.
  • OWNER_OF – a business with ownership of another business.
​
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"

Response

Relationship representation.

​
relationships
object[]
required

Array of business/person relationships.

  • Option 1
  • Option 2
  • Option 3
  • Option 4
​
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"