For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
LearnGraph LoginRequest a Demo
HomeAPIBulk DataSayari LibraryChange Log
  • Key Concepts
    • Introduction
    • Endpoint Overview
    • Authentication
    • Requests
    • Pagination
    • Response Status Codes
    • Data Types
    • Rate Limits
  • API Clients
    • Overview
    • Open API
    • Postman
    • Go
    • Python
    • Node
  • API Reference
      • POSTSearch Entity
      • GETSearch Entity GET
      • POSTSearch Record
      • GETSearch Record GET
  • Guides
    • Getting Started
    • Understanding Project Entity
    • Risk Factors
    • Entity Search
    • Advanced Entity Search
    • Resolution
    • Trade Search - Shipments
    • Trade Search - Suppliers & Buyers
    • v0 Migration
  • Implementation Patterns
    • Project Entity Supply Chain
  • Use Cases
    • Entity Screening & Verification
    • Investigations
LogoLogo
LearnGraph LoginRequest a Demo
API ReferenceSearch

Search Entity GET

GET
/v1/search/entity
GET
/v1/search/entity
$curl -G https://api.sayari.com/v1/search/entity \
>     -H "Authorization: Bearer <token>" \
>     -d limit=1 \
>     --data-urlencode "q=victoria beckham limited"
1{
2  "data": [
3    {
4      "addresses": [
5        "202 HAMMERSMITH ROAD , LONDON , , UNITED KINGDOM , W6 7DN , GB",
6        "Unit 33, Ransomes Dock Business Centre, 35-37 Parkgate Road, London SW11 4NP",
7        "Hammersmith Road, London, W6 7DN"
8      ],
9      "attribute_count": {
10        "company_type": 3,
11        "name": 2,
12        "business_purpose": 4,
13        "identifier": 3,
14        "additional_information": 106,
15        "country": 7,
16        "status": 5,
17        "address": 6
18      },
19      "closed": false,
20      "coordinates": [
21        {
22          "address": "202 HAMMERSMITH ROAD , LONDON , , UNITED KINGDOM , W6 7DN , GB",
23          "lat": 51.49322001798694,
24          "lng": -0.2220315859755715
25        },
26        {
27          "address": "Unit 33, Ransomes Dock Business Centre, 35-37 Parkgate Road, London SW11 4NP",
28          "lat": 51.47911101182882,
29          "lng": -0.16811097048599777
30        },
31        {
32          "address": "Hammersmith Road, London, W6 7DN",
33          "lat": 51.493835014595135,
34          "lng": -0.21932487497451175
35        },
36        {
37          "address": "202 HAMMERSMITH ROAD UNITED KINGDOM",
38          "lat": 53.06030545100003,
39          "lng": -1.4104778399999418
40        },
41        {
42          "address": "202 HAMMERSMITH ROAD"
43        },
44        {
45          "address": "202 HAMMERSMITH ROAD BRITISH ISLES",
46          "lat": 51.490490045109766,
47          "lng": -0.2455951217808129
48        }
49      ],
50      "countries": [
51        "GBR",
52        "USA"
53      ],
54      "degree": 114,
55      "entity_url": "/v1/entity/mGq1lpuqKssNWTjIokuPeA",
56      "id": "mGq1lpuqKssNWTjIokuPeA",
57      "identifiers": [
58        {
59          "value": "06517802",
60          "type": "uk_company_number",
61          "label": "Uk Company Number"
62        },
63        {
64          "value": "6517802",
65          "type": "unknown",
66          "label": "Unknown"
67        },
68        {
69          "value": "04781466",
70          "type": "ca_corporate_id_num",
71          "label": "Ca Corporate Id Num"
72        }
73      ],
74      "label": "VICTORIA BECKHAM LIMITED",
75      "matches": {
76        "name": [
77          "<em>VICTORIA</em> <em>BECKHAM</em> <em>LIMITED</em>",
78          "<em>BECKHAM</em> VENTURES <em>LIMITED</em>",
79          "<em>VICTORIA</em> <em>BECKHAM</em> LIMITED",
80          "<em>BECKHAM</em> VENTURES LIMITED"
81        ]
82      },
83      "pep": false,
84      "psa_count": 4,
85      "related_entities_count": 114,
86      "relationship_count": {
87        "linked_to": 3,
88        "has_officer": 2,
89        "shareholder_of": 1,
90        "has_shareholder": 2,
91        "has_registered_agent": 5,
92        "has_director": 11,
93        "owner_of": 3,
94        "has_founder": 1,
95        "ships_to": 5,
96        "receives_from": 1
97      },
98      "risk": {
99        "basel_aml": {
100          "value": 4.28,
101          "metadata": {
102            "country": [
103              "USA"
104            ]
105          },
106          "level": "relevant"
107        },
108        "cpi_score": {
109          "value": 69,
110          "metadata": {
111            "country": [
112              "USA"
113            ]
114          },
115          "level": "relevant"
116        }
117      },
118      "sanctioned": false,
119      "source_count": {
120        "2b618f1996252fe537a6d998ae14c9b2": {
121          "count": 1,
122          "label": "UK Corporate Registry Confirmation Statements"
123        },
124        "2b788dbdf9194ed5a5c309386a6516b1": {
125          "count": 37,
126          "label": "UK HM Revenue & Customs Traders Database"
127        },
128        "a447a7b622c4ead6e1caf94983dc2337": {
129          "count": 8,
130          "label": "USA California Secretary of State"
131        },
132        "a7829d9c8999fcaa78af55886da9be06": {
133          "count": 43,
134          "label": "Turkey Imports & Exports (January 2024 - Present)"
135        },
136        "ecdfb3f2ecc8c3797e77d5795a8066ef": {
137          "count": 40,
138          "label": "UK Corporate Registry"
139        },
140        "e5de7b52cc88ef4cd1a10e201bdf46ee": {
141          "count": 41,
142          "label": "Vietnam Imports & Exports (January 2023 - Present)"
143        },
144        "2a4fe9a14e332c8f9ded1f8a457c2b89": {
145          "count": 42,
146          "label": "UK Land Commercial and Corporate Ownership Data (CCOD)"
147        },
148        "4ea8bac1bed868e1510ffd21842e9551": {
149          "count": 86,
150          "label": "UK Persons with Significant Control"
151        }
152      },
153      "trade_count": {
154        "sent": 82,
155        "received": 2
156      },
157      "type": "company",
158      "user_attribute_count": {},
159      "user_record_count": 0,
160      "user_related_entities_count": 0,
161      "user_relationship_count": {},
162      "attribute_counts": {
163        "company_type": 3,
164        "name": 2,
165        "business_purpose": 4,
166        "identifier": 3,
167        "additional_information": 106,
168        "country": 7,
169        "status": 5,
170        "address": 6
171      },
172      "company_type": "LADIES FASHION",
173      "latest_status": {
174        "status": "active",
175        "date": "2023-08-29"
176      },
177      "logistics_entity": false,
178      "psa_id": "65455301594691",
179      "reference_id": "ecdfb3f2ecc8c3797e77d5795a8066ef/06517802/1540252800000:4a34442eccf1622995130b194a5d50e7",
180      "registration_date": "Incorporated 2008-02-28",
181      "user_attribute_counts": {}
182    }
183  ],
184  "limit": 1,
185  "next": true,
186  "offset": 0,
187  "size": {
188    "count": 41,
189    "qualifier": "eq"
190  }
191}
Search for an entity. Please note, searches are limited to a maximum of 10,000 results.
Was this page helpful?
Previous

Search Record

Next
Built with

Authentication

AuthorizationBearer

OAuth authentication of the form <token>.

Query parameters

limitintegerOptional
A limit on the number of objects to be returned with a range between 1 and 100. Defaults to 100.
offsetintegerOptional
Number of results to skip before returning response. Defaults to 0.
qstringRequired
Query term. The syntax for the query parameter follows elasticsearch simple query string syntax. The includes the ability to use search operators and to perform nested queries. Must be url encoded.
fieldsenumOptional
Record or entity fields to search against.
facetsbooleanOptional
Whether or not to return search facets in results giving counts by field. Defaults to false.
geo_facetsbooleanOptional
Whether or not to return search geo bound facets in results giving counts by geo tile. Defaults to false.
advancedbooleanOptional

Set to true to enable full elasticsearch query string syntax which allows for fielded search and more complex operators. Note that the syntax is more strict and can result in empty result-sets. Defaults to false.

Response

This endpoint returns an object.
datalist of objects
limitinteger
nextboolean
offsetinteger
sizeobject

Errors

400
Bad Request
401
Unauthorized
405
Method Not Allowed
406
Not Acceptable
429
Rate Limit Exceeded
500
Internal Server Error