GET /v1/companies/{company_id}
Get a company. One company record with its sources.
| Parameter | In | Type | Required |
|---|---|---|---|
company_id | path | string | yes |
language | query | string | no |
Developers
Read-only access to your workspace: company and contact search, company records, saved lists, signals and your usage. Base URL https://api.veysa.ae. Download the OpenAPI spec.
Create a key in Settings > API keys and send it as Authorization: Bearer <key>. API access is included with the Team and Agency plans.
Team includes 5,000 calls a month and Agency 15,000, shared by every key in the workspace. The count resets on the 1st of each month (UTC), and you can see it in Settings > API keys.
Every response carries X-Quota-Limit, X-Quota-Remaining and X-Quota-Reset (Unix seconds). Over the limit the API answers 429 with code: api_quota_exceeded and a Retry-After header. Short bursts are also limited per minute.
It is read-only. It never runs a new reveal or spends enrichment credits: contact emails and phones appear only where your workspace already revealed them in the app. Webhooks are not available yet. A key can call only the endpoints listed below; any other route answers 403 with code: api_key_endpoint_not_allowed.
GET /v1/companies/{company_id}GET /v1/companies/{company_id}/contactsGET /v1/companies/{company_id}/signalsGET /v1/contacts/{contact_id}GET /v1/listsGET /v1/lists/{list_id}GET /v1/lists/{list_id}/itemsGET /v1/search/companiesGET /v1/search/contactsGET /v1/signalsGET /v1/usageGET /v1/companies/{company_id}Get a company. One company record with its sources.
| Parameter | In | Type | Required |
|---|---|---|---|
company_id | path | string | yes |
language | query | string | no |
GET /v1/companies/{company_id}/contactsList a company's contacts. Contacts at one company.
| Parameter | In | Type | Required |
|---|---|---|---|
company_id | path | string | yes |
page | query | integer | no |
per_page | query | integer | no |
GET /v1/companies/{company_id}/signalsList a company's signals. Dated buying signals for one company.
| Parameter | In | Type | Required |
|---|---|---|---|
company_id | path | string | yes |
page | query | integer | no |
per_page | query | integer | no |
GET /v1/contacts/{contact_id}Get a contact. One contact. Email and phone appear only if your workspace already revealed them.
| Parameter | In | Type | Required |
|---|---|---|---|
contact_id | path | string | yes |
language | query | string | no |
GET /v1/listsList saved lists. Your workspace's saved lists.
GET /v1/lists/{list_id}Get a list. One saved list.
| Parameter | In | Type | Required |
|---|---|---|---|
list_id | path | string | yes |
GET /v1/lists/{list_id}/itemsList the items in a list. Companies or contacts saved to a list.
| Parameter | In | Type | Required |
|---|---|---|---|
list_id | path | string | yes |
page | query | integer | no |
per_page | query | integer | no |
GET /v1/search/companiesSearch companies. Filter and page through UAE companies.
| Parameter | In | Type | Required |
|---|---|---|---|
q | query | string | no |
industry | query | string | no |
sub_industry | query | string | no |
employee_min | query | integer | no |
employee_max | query | integer | no |
employee_range | query | string | no |
hq_country | query | string | no |
hq_city | query | string | no |
legal_form | query | string | no |
employee_count_band | query | string | no |
tech_stack | query | string | no |
funding_stage | query | string | no |
revenue_band | query | string | no |
registered_capital_min | query | number | no |
registered_capital_max | query | number | no |
founded_year_min | query | integer | no |
founded_year_max | query | integer | no |
min_completeness_pct | query | integer | no |
actionability_tier | query | string | no |
has_description | query | boolean | no |
has_funding_signal | query | boolean | no |
has_hiring_signal | query | boolean | no |
has_leadership_change | query | boolean | no |
has_expansion_signal | query | boolean | no |
has_renewal_due | query | boolean | no |
has_newly_licensed | query | boolean | no |
license_category | query | string | no |
license_status | query | string | no |
license_authority | query | string | no |
emirate | query | string | no |
free_zone | query | string | no |
isic | query | string | no |
activity | query | string | no |
has_dp_link | query | boolean | no |
has_active_project | query | boolean | no |
project_role | query | string | no |
has_fnb_outlet | query | boolean | no |
deq_permit_status | query | string | no |
listed | query | boolean | no |
sort_by | query | string | no |
include_fit | query | boolean | no |
show_poor_fit | query | boolean | no |
icp_segment | query | string | no |
page | query | integer | no |
per_page | query | integer | no |
GET /v1/search/contactsSearch contacts. Filter and page through contacts. Paid channels stay masked.
| Parameter | In | Type | Required |
|---|---|---|---|
q | query | string | no |
company_id | query | string | no |
seniority_level | query | string | no |
department | query | string | no |
location_country | query | string | no |
hq_country | query | string | no |
has_verified_email | query | boolean | no |
has_verified_phone | query | boolean | no |
has_phone | query | boolean | no |
sort_by | query | string | no |
include_fit | query | boolean | no |
show_poor_fit | query | boolean | no |
icp_segment | query | string | no |
page | query | integer | no |
per_page | query | integer | no |
GET /v1/signalsSignal feed. Ranked insight feed: one card per company, best signal first.
| Parameter | In | Type | Required |
|---|---|---|---|
limit | query | integer | no |
scope | query | string | no |
GET /v1/usageGet usage. Credits, plan and this month's API calls for the workspace.