Get Entity

GET

/v1/entity/:id

GET

/v1/entity/:id

curl -G https://api.sayari.com/v1/entity/mGq1lpuqKssNWTjIokuPeA \
     -H "Authorization: Bearer <token>" \
     -d attributes.name.limit=1 \
     -d attributes.address.limit=1 \
     -d attributes.country.limit=1 \
     -d attributes.additional_information.limit=1 \
     -d attributes.business_purpose.limit=1 \
     -d attributes.company_type.limit=1 \
     -d attributes.identifier.limit=1 \
     -d attributes.status.limit=1 \
     -d relationships.limit=1 \
     -d possibly_same_as.limit=1 \
     -d referenced_by.limit=1

{
  "addresses": [
    "202 HAMMERSMITH ROAD , LONDON , , UNITED KINGDOM , W6 7DN , GB",
    "Unit 33, Ransomes Dock Business Centre, 35-37 Parkgate Road, London SW11 4NP",
    "SAUNDERS BUILDING, 202 HAMMERSMITH ROAD, HAMMERSMITH, LONDON"
  ],
  "attribute_count": {
    "company_type": 2,
    "name": 2,
    "business_purpose": 4,
    "identifier": 3,
    "additional_information": 106,
    "country": 8,
    "status": 5,
    "address": 7
  },
  "closed": false,
  "countries": [
    "GBR",
    "USA"
  ],
  "degree": 67,
  "entity_url": "/v1/entity/mGq1lpuqKssNWTjIokuPeA",
  "id": "mGq1lpuqKssNWTjIokuPeA",
  "identifiers": [
    {
      "value": "06517802",
      "type": "uk_company_number",
      "label": "Uk Company Number"
    },
    {
      "value": "6517802",
      "type": "unknown",
      "label": "Unknown"
    },
    {
      "value": "04781466",
      "type": "ca_corporate_id_num",
      "label": "Ca Corporate Id Num"
    }
  ],
  "label": "VICTORIA BECKHAM LIMITED",
  "pep": false,
  "psa_count": 3,
  "related_entities_count": 67,
  "relationship_count": {
    "linked_to": 3,
    "has_officer": 2,
    "shareholder_of": 1,
    "has_shareholder": 2,
    "has_registered_agent": 5,
    "shipper_of": 41,
    "has_director": 11,
    "owner_of": 3,
    "has_founder": 1,
    "ships_to": 1
  },
  "risk": {
    "basel_aml": {
      "value": 4.63,
      "metadata": {
        "country": [
          "USA"
        ]
      },
      "level": "relevant"
    },
    "cpi_score": {
      "value": 67,
      "metadata": {
        "country": [
          "USA"
        ]
      },
      "level": "relevant"
    }
  },
  "sanctioned": false,
  "source_count": {
    "2b618f1996252fe537a6d998ae14c9b2": {
      "count": 1,
      "label": "UK Corporate Registry Confirmation Statements"
    },
    "2b788dbdf9194ed5a5c309386a6516b1": {
      "count": 28,
      "label": "UK HM Revenue & Customs Traders Database"
    },
    "a447a7b622c4ead6e1caf94983dc2337": {
      "count": 6,
      "label": "USA California Secretary of State"
    },
    "ecdfb3f2ecc8c3797e77d5795a8066ef": {
      "count": 35,
      "label": "UK Corporate Registry"
    },
    "e5de7b52cc88ef4cd1a10e201bdf46ee": {
      "count": 41,
      "label": "Vietnam Imports & Exports (January 2023 - Present)"
    },
    "2a4fe9a14e332c8f9ded1f8a457c2b89": {
      "count": 36,
      "label": "UK Land Commercial and Corporate Ownership Data (CCOD)"
    },
    "4ea8bac1bed868e1510ffd21842e9551": {
      "count": 69,
      "label": "UK Persons with Significant Control"
    }
  },
  "trade_count": {
    "sent": 41,
    "received": 0
  },
  "type": "company",
  "user_attribute_count": {},
  "user_record_count": 0,
  "user_related_entities_count": 0,
  "user_relationship_count": {},
  "attributes": {
    "additional_information": {
      "data": [
        {
          "properties": {
            "type": "Traded Goods"
          },
          "record": [
            "2b788dbdf9194ed5a5c309386a6516b1/22950249e3df0c33ce05bd54850ba9f3/1672444800000"
          ],
          "record_count": 9,
          "editable": false
        }
      ],
      "limit": 1,
      "size": {
        "count": 106,
        "qualifier": "eq"
      },
      "next": "_SjfEipa7hytJ93C1IT_sg"
    },
    "address": {
      "data": [
        {
          "properties": {
            "country": "United Kingdom",
            "house_number": "202",
            "normalized": "202 HAMMERSMITH KINGDOM RD UNITED",
            "precision_code": "G3",
            "road": "Hammersmith Road",
            "value": "202 HAMMERSMITH ROAD UNITED KINGDOM",
            "x": -0.22579,
            "y": 51.49291
          },
          "record": [
            "9139b58de1bdb0157a1a1e54e56df6d3/4781466/1678752000000"
          ],
          "record_count": 5,
          "editable": false
        }
      ],
      "limit": 1,
      "size": {
        "count": 7,
        "qualifier": "eq"
      },
      "next": "5TPSsmsFxea24_QTyk8o1Q"
    },
    "business_purpose": {
      "data": [
        {
          "properties": {
            "code": "9329",
            "standard": "ISIC4",
            "value": "Other amusement and recreation activities n.e.c."
          },
          "record": [
            "9aef3a56aa0ea25404b498dbd8bb447f/06517802/1579014552807"
          ],
          "record_count": 18,
          "editable": false
        }
      ],
      "limit": 1,
      "size": {
        "count": 4,
        "qualifier": "eq"
      },
      "next": "5fZrn5ZbUyo6d_huc6NlAA"
    },
    "company_type": {
      "data": [
        {
          "properties": {
            "value": "Stock Corporation - Out of State - Stock"
          },
          "record": [
            "9139b58de1bdb0157a1a1e54e56df6d3/4781466/1649116800000"
          ],
          "record_count": 6,
          "editable": false
        }
      ],
      "limit": 1,
      "size": {
        "count": 2,
        "qualifier": "eq"
      },
      "next": "iuJ_MCygy24sDCcVkbCATA"
    },
    "country": {
      "data": [
        {
          "properties": {
            "value": "GBR",
            "context": "address"
          },
          "record": [
            "9aef3a56aa0ea25404b498dbd8bb447f/06517802/1579014552807"
          ],
          "record_count": 23,
          "editable": false
        }
      ],
      "limit": 1,
      "size": {
        "count": 8,
        "qualifier": "eq"
      },
      "next": "_ZTsEnhxCbjokYYWu1kMoQ"
    },
    "identifier": {
      "data": [
        {
          "properties": {
            "type": "ca_corporate_id_num",
            "value": "04781466"
          },
          "record": [
            "9139b58de1bdb0157a1a1e54e56df6d3/4781466/1649116800000"
          ],
          "record_count": 6,
          "editable": false
        }
      ],
      "limit": 1,
      "size": {
        "count": 3,
        "qualifier": "eq"
      },
      "next": "07v3Rsu6x-gDuukFa0jEsw"
    },
    "name": {
      "data": [
        {
          "properties": {
            "value": "BECKHAM VENTURES LIMITED",
            "context": "alias",
            "to_date": "2014-09-03"
          },
          "record": [
            "2a4fe9a14e332c8f9ded1f8a457c2b89/NGL944625/1560779151522"
          ],
          "record_count": 30,
          "editable": false
        }
      ],
      "limit": 1,
      "size": {
        "count": 2,
        "qualifier": "eq"
      },
      "next": "5lxpjuZmt31xiCnbDILp0A"
    },
    "status": {
      "data": [
        {
          "properties": {
            "text": "Good"
          },
          "record": [
            "9139b58de1bdb0157a1a1e54e56df6d3/4781466/1649116800000"
          ],
          "record_count": 6,
          "editable": false
        }
      ],
      "limit": 1,
      "size": {
        "count": 5,
        "qualifier": "eq"
      },
      "next": "EdC1n7V2lU0oKTokzO_YLw"
    }
  },
  "company_type": "Stock Corporation - Out of State - Stock",
  "latest_status": {
    "status": "active",
    "date": "2023-08-29"
  },
  "logistics_entity": false,
  "possibly_same_as": {
    "data": [
      {
        "entity": {
          "addresses": [
            "99 WASHINGTON AVE., SUITE 805A, ALBANY, NY, 12201",
            "511 WEST 25TH STREET, SUITE # 701/7TH FLOOR, NEW YORK, NEW YORK, 10001",
            "80 STATE STREET, ALBANY, NEW YORK, 12207-2543"
          ],
          "attribute_count": {
            "company_type": 1,
            "name": 1,
            "identifier": 1,
            "country": 3,
            "status": 1,
            "address": 3
          },
          "closed": false,
          "countries": [
            "USA"
          ],
          "degree": 3,
          "entity_url": "/v1/entity/NGUTEUTI4YZ6R5d56vgNIw",
          "id": "NGUTEUTI4YZ6R5d56vgNIw",
          "identifiers": [
            {
              "value": "4346762",
              "type": "usa_ny_dos_id",
              "label": "Usa Ny Dos Id"
            }
          ],
          "label": "BECKHAM VENTURES INC.",
          "pep": false,
          "psa_count": 3,
          "related_entities_count": 3,
          "relationship_count": {
            "has_officer": 1,
            "has_registered_agent": 2,
            "linked_to": 2
          },
          "risk": {
            "basel_aml": {
              "value": 4.63,
              "metadata": {
                "country": [
                  "USA"
                ]
              },
              "level": "relevant"
            },
            "cpi_score": {
              "value": 67,
              "metadata": {
                "country": [
                  "USA"
                ]
              },
              "level": "relevant"
            }
          },
          "sanctioned": false,
          "source_count": {
            "b4d06d4b77f51fab3c77c9653aabdda4": {
              "count": 8,
              "label": "USA New York Corporate Registry (Active Entities)"
            }
          },
          "trade_count": {
            "sent": 0,
            "received": 0
          },
          "type": "company",
          "user_attribute_count": {},
          "user_record_count": 0,
          "user_related_entities_count": 0,
          "user_relationship_count": {},
          "company_type": "FOREIGN BUSINESS CORPORATION",
          "latest_status": {
            "status": "active",
            "date": "2013-01-16"
          },
          "logistics_entity": false,
          "psa_id": "695785012897",
          "reference_id": "b4d06d4b77f51fab3c77c9653aabdda4/a80e7f4c-c219-437b-9941-32d89ea5885a/1560542045043:15d813b260619393762864f22d3c5b2d",
          "registration_date": " 2013-01-16"
        },
        "matches": {},
        "editable": false
      }
    ],
    "limit": 1,
    "size": {
      "count": 3,
      "qualifier": "eq"
    },
    "next": "eyJ0eXBlIjoic2F5YXJpIiwib2Zmc2V0IjoxfQ"
  },
  "psa_id": "695785012897",
  "reference_id": "ecdfb3f2ecc8c3797e77d5795a8066ef/06517802/1540252800000:4a34442eccf1622995130b194a5d50e7",
  "referenced_by": {
    "data": [
      {
        "record": {
          "id": "e5de7b52cc88ef4cd1a10e201bdf46ee/{D634B9B1-39E2-4273-8F35AE81130E18D7}/1704240000000",
          "label": "Trade Record from Vietnam Imports & Exports (January 2023 - Present)",
          "source": "e5de7b52cc88ef4cd1a10e201bdf46ee",
          "acquisition_date": "2024-01-03",
          "references_count": 3,
          "record_url": "/record/e5de7b52cc88ef4cd1a10e201bdf46ee%2F%7BD634B9B1-39E2-4273-8F35AE81130E18D7%7D%2F1704240000000",
          "publication_date": "2024-01-03"
        },
        "type": "mentions"
      }
    ],
    "limit": 1,
    "size": {
      "count": 216,
      "qualifier": "eq"
    },
    "next": "Vk5NfGdsb2JhbF90cmFkZV90YV92bm18ZnwyMDI0LTAxLTAzfHtENjM0QjlCMS0zOUUyLTQyNzMtOEYzNUFFODExMzBFMThEN318MTcwNDI0MDAwMDAwMA"
  },
  "registration_date": "Incorporated 2008-02-28",
  "relationships": {
    "data": [
      {
        "target": {
          "addresses": [
            "35-37 Parkgate Road, London, SW11 4NP",
            "Hammersmith Road, London",
            "202 HAMMERSMITH ROAD, LONDON, W6 7DN"
          ],
          "attribute_count": {
            "company_type": 1,
            "name": 2,
            "business_purpose": 3,
            "identifier": 1,
            "additional_information": 1,
            "country": 3,
            "status": 2,
            "address": 3
          },
          "closed": false,
          "countries": [
            "GBR"
          ],
          "degree": 17,
          "entity_url": "/v1/entity/zenMMQtpFHx9Cam_2nDndg",
          "id": "zenMMQtpFHx9Cam_2nDndg",
          "identifiers": [
            {
              "value": "11043864",
              "type": "uk_company_number",
              "label": "Uk Company Number"
            }
          ],
          "label": "Victoria Beckham Holdings Limited",
          "pep": false,
          "psa_count": 0,
          "related_entities_count": 17,
          "relationship_count": {
            "shareholder_of": 2,
            "has_shareholder": 5,
            "has_registered_agent": 1,
            "has_director": 9,
            "linked_to": 7
          },
          "risk": {
            "basel_aml": {
              "value": 3.99,
              "metadata": {
                "country": [
                  "GBR"
                ]
              },
              "level": "relevant"
            },
            "cpi_score": {
              "value": 78,
              "metadata": {
                "country": [
                  "GBR"
                ]
              },
              "level": "relevant"
            }
          },
          "sanctioned": false,
          "source_count": {
            "ecdfb3f2ecc8c3797e77d5795a8066ef": {
              "count": 34,
              "label": "UK Corporate Registry"
            },
            "2b618f1996252fe537a6d998ae14c9b2": {
              "count": 1,
              "label": "UK Corporate Registry Confirmation Statements"
            },
            "4ea8bac1bed868e1510ffd21842e9551": {
              "count": 147,
              "label": "UK Persons with Significant Control"
            }
          },
          "trade_count": {
            "sent": 0,
            "received": 0
          },
          "type": "company",
          "user_attribute_count": {},
          "user_record_count": 0,
          "user_related_entities_count": 0,
          "user_relationship_count": {},
          "company_type": "Private Limited Company",
          "latest_status": {
            "status": "active"
          },
          "logistics_entity": false,
          "reference_id": "ecdfb3f2ecc8c3797e77d5795a8066ef/11043864/1540252800000:40ec7b0310d308ebf9006148b53a2802",
          "registration_date": "Incorporated 2017-11-02"
        },
        "types": {
          "has_shareholder": [
            {
              "record": "4ea8bac1bed868e1510ffd21842e9551/56910fae410d43596d5a94fd9405023a/1711843200000",
              "attributes": {},
              "acquisition_date": "2024-03-31",
              "editable": false
            },
            {
              "record": "4ea8bac1bed868e1510ffd21842e9551/06517802/1560176240192",
              "attributes": {
                "position": [
                  {
                    "value": "Has right to appoint and remove directors"
                  },
                  {
                    "value": "Owns 75-100% of shares"
                  },
                  {
                    "value": "Owns 75-100% of voting rights"
                  }
                ],
                "shares": [
                  {
                    "percentage": 75
                  }
                ]
              },
              "acquisition_date": "2019-06-10",
              "editable": false
            }
          ],
          "linked_to": [
            {
              "record": "4ea8bac1bed868e1510ffd21842e9551/56910fae410d43596d5a94fd9405023a/1711843200000",
              "attributes": {},
              "acquisition_date": "2024-03-31",
              "editable": false
            },
            {
              "record": "4ea8bac1bed868e1510ffd21842e9551/06517802/1560176240192",
              "attributes": {
                "position": [
                  {
                    "value": "Has right to appoint and remove directors"
                  },
                  {
                    "value": "Owns 75-100% of shares"
                  },
                  {
                    "value": "Owns 75-100% of voting rights"
                  }
                ]
              },
              "acquisition_date": "2019-06-10",
              "editable": false
            }
          ]
        },
        "dates": [
          "2017-11-16"
        ],
        "first_observed": "2017-11-16",
        "last_observed": "2017-11-16"
      }
    ],
    "limit": 1,
    "size": {
      "count": 67,
      "qualifier": "eq"
    },
    "next": "fzenMMQtpFHx9Cam_2nDndg"
  }
}

To retrieve a L1 Due Dilligence PDF Report. Include ‘Accept: application/pdf’ in request headers.

Retrieve an entity profile from the database based on the entity ID. This endpoint returns the full profile, entity_summary returns the same payload minus relationships.

<Note>To retrieve a L1 Due Dilligence PDF Report. Include 'Accept: application/pdf' in request headers.</Note> Retrieve an entity profile from the database based on the entity ID. This endpoint returns the full profile, entity_summary returns the same payload minus relationships.

Authentication

AuthorizationBearer

OAuth authentication of the form <token>.

Path parameters

idstringRequired

Unique identifier of the entity

Query parameters

attributes.additional_information.nextstringOptional

The pagination token for the next page of attribute additional_information.

attributes.additional_information.prevstringOptional

The pagination token for the previous page of attribute additional_information.

attributes.additional_information.limitintegerOptional

Limit total values returned for attribute additional_information. Defaults to 100.

attributes.address.nextstringOptional

The pagination token for the next page of attribute address.

attributes.address.prevstringOptional

The pagination token for the previous page of attribute address.

attributes.address.limitintegerOptional

Limit total values returned for attribute address. Defaults to 100.

attributes.business_purpose.nextstringOptional

The pagination token for the next page of attribute business_purpose.

attributes.business_purpose.prevstringOptional

The pagination token for the previous page of attribute business_purpose.

attributes.business_purpose.limitintegerOptional

Limit total values returned for attribute business_purpose. Defaults to 100.

attributes.company_type.nextstringOptional

The pagination token for the next page of attribute company_type.

attributes.company_type.prevstringOptional

The pagination token for the previous page of attribute company_type.

attributes.company_type.limitintegerOptional

Limit total values returned for attribute company_type. Defaults to 100.

attributes.country.nextstringOptional

The pagination token for the next page of attribute country.

attributes.country.prevstringOptional

The pagination token for the previous page of attribute country.

attributes.country.limitintegerOptional

Limit total values returned for attribute country. Defaults to 100.

attributes.identifier.nextstringOptional

The pagination token for the next page of attribute identifier.

attributes.identifier.prevstringOptional

The pagination token for the previous page of attribute identifier.

attributes.identifier.limitintegerOptional

Limit total values returned for attribute identifier. Defaults to 100.

attributes.name.nextstringOptional

The pagination token for the next page of attribute name.

attributes.name.prevstringOptional

The pagination token for the previous page of attribute name.

attributes.name.limitintegerOptional

Limit total values returned for attribute name. Defaults to 100.

attributes.status.nextstringOptional

The pagination token for the next page of attribute status.

attributes.status.prevstringOptional

The pagination token for the previous page of attribute status.

attributes.status.limitintegerOptional

Limit total values returned for attribute status. Defaults to 100.

relationships.nextstringOptional

The pagination token for the next page of relationship results

relationships.prevstringOptional

The pagination token for the previous page of relationship results

relationships.limitintegerOptional

Limit total relationship values. Defaults to 50.

relationships.typeenumOptional

Filter relationships to relationship type, e.g. director_of or has_shareholder

relationships.sortstringOptional

Sorts relationships by As Of date or Shareholder percentage, e.g. date or -shares

relationships.startDatedateOptional

Filters relationships to after a date

relationships.endDatedateOptional

Filters relationships to before a date

relationships.minSharesintegerOptional

Filters relationships to greater than or equal to a Shareholder percentage

relationships.countryenumOptional

Filters relationships to a list of countries

relationships.arrivalCountryenumOptional

Filters shipment relationships to a list of arrival countries

relationships.arrivalStatestringOptional

Filters shipment relationships to an arrival state

relationships.arrivalCitystringOptional

Filters shipment relationships to an arrival city

relationships.departureCountryenumOptional

Filters shipment relationships to a list of departure countries

relationships.departureStatestringOptional

Filters shipment relationships to a departure state

relationships.departureCitystringOptional

Filters shipment relationships to a departure city

relationships.partnerNamestringOptional

Filters shipment relationships to a trade partner name

relationships.partnerRiskenumOptional

Filters shipment relationships to a trade partner risk tag

relationships.hsCodestringOptional

Filters shipment relationships to an HS code

possibly_same_as.nextstringOptional

The pagination token for the next page of possibly same entities.

possibly_same_as.prevstringOptional

The pagination token for the previous page of possibly same entities.

possibly_same_as.limitintegerOptional

Limit total possibly same as entities. Defaults to 100.

referenced_by.nextstringOptional

The pagination token for the next page of the entity's referencing records

referenced_by.prevstringOptional

The pagination token for the previous page of the entity's referencing records

referenced_by.limitintegerOptional

Limit totals values returned for entity's referencing records. Defaults to 100.

Response

This endpoint returns an object.

addresseslist of strings

List of physical addresses associated with the entity. See more here

attribute_countmap from enums to integers

Count of attributes for a given attribute type

closedboolean

True if the entity existed in the past but not at the present time, otherwise false. Always false for data curation.

countrieslist of enums

Entity country

degreeinteger

Number of outgoing relationships

entity_urlstring

Convenience URL to the entity in the API.

idstring

Unique identifier of the entity

identifierslist of objects

labelstring

Display name of the entity

pepboolean

True if the entity has the “Politically Exposed Person (PEP)” risk factor, otherwise false.

psa_countinteger

Number of entities that are Possibly the Same As (PSA) the entity.

related_entities_countinteger

relationship_countmap from enums to integers

Count of related entities for a given relationship type.

riskmap from enums to objects

Risk factors associated with the entity.

sanctionedboolean

True if the entity has the “Sanctioned” risk factor, otherwise false.

source_countmap from strings to objects

Number of records associated with the entity, grouped by source.

trade_countmap from strings to integers

typeenum

The entity type.

user_attribute_countmap from enums to integers

Count of user-created attributes for a given attribute type

user_record_countinteger

user_related_entities_countinteger

user_relationship_countmap from enums to integers

Count of related entities for a given relationship type.

attribute_countsmap from enums to integersOptional

Count of attributes for a given attribute type

attributesobjectOptional

Detailed information about the entity’s attributes.

company_typestringOptional

A type of legal entity in a given jurisdiction (e.g. ‘LLC,’ ‘Sociedad Anonima,’ ‘Private Company Limited by Shares’)

date_of_birthstringOptional

Birth date of a person. See more here

hs_codestringOptional

Harmonized Tariff Schedule Code associated with the entity/shipment

latest_statusobjectOptional

The most recent status of an entity and when that status was observed.

logistics_entitybooleanOptional

possibly_same_asobjectOptional

This property is deprecated.

List of entities that are Possibly the Same As (PSA) the entity.

psa_idstringOptional

reference_idstringOptional

referenced_byobjectOptional

List of records that reference the entity.

registration_datestringOptional

Type (registered/incorporated/active) and date of the earliest significant activity associated with the entity. Will appear as ‘Registered YYYY-MM-DD’

relationshipsobjectOptional

Detailed information about the entity’s relationships.

shipment_arrivalstringOptional

Arrival date of a shipment.

shipment_departurestringOptional

Departure date of a shipment.

translated_labelstringOptional

Label in English if available. Translation performed by Sayari.

user_attribute_countsmap from enums to integersOptional

Count of user-created attributes for a given attribute type

Errors

400

Bad Request

401

Unauthorized

404

Not Found

405

Method Not Allowed

429

Rate Limit Exceeded

500

Internal Server Error