Developers

Veysa API

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.

Authentication

Create a key in Settings > API keys and send it as Authorization: Bearer <key>. API access is included with the Team and Agency plans.

Monthly quota

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.

What the API does not do

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.

Endpoints

GET /v1/companies/{company_id}

Get a company. One company record with its sources.

ParameterInTypeRequired
company_idpathstringyes
languagequerystringno

GET /v1/companies/{company_id}/contacts

List a company's contacts. Contacts at one company.

ParameterInTypeRequired
company_idpathstringyes
pagequeryintegerno
per_pagequeryintegerno

GET /v1/companies/{company_id}/signals

List a company's signals. Dated buying signals for one company.

ParameterInTypeRequired
company_idpathstringyes
pagequeryintegerno
per_pagequeryintegerno

GET /v1/contacts/{contact_id}

Get a contact. One contact. Email and phone appear only if your workspace already revealed them.

ParameterInTypeRequired
contact_idpathstringyes
languagequerystringno

GET /v1/lists

List saved lists. Your workspace's saved lists.

GET /v1/lists/{list_id}

Get a list. One saved list.

ParameterInTypeRequired
list_idpathstringyes

GET /v1/lists/{list_id}/items

List the items in a list. Companies or contacts saved to a list.

ParameterInTypeRequired
list_idpathstringyes
pagequeryintegerno
per_pagequeryintegerno

GET /v1/search/companies

Search companies. Filter and page through UAE companies.

ParameterInTypeRequired
qquerystringno
industryquerystringno
sub_industryquerystringno
employee_minqueryintegerno
employee_maxqueryintegerno
employee_rangequerystringno
hq_countryquerystringno
hq_cityquerystringno
legal_formquerystringno
employee_count_bandquerystringno
tech_stackquerystringno
funding_stagequerystringno
revenue_bandquerystringno
registered_capital_minquerynumberno
registered_capital_maxquerynumberno
founded_year_minqueryintegerno
founded_year_maxqueryintegerno
min_completeness_pctqueryintegerno
actionability_tierquerystringno
has_descriptionquerybooleanno
has_funding_signalquerybooleanno
has_hiring_signalquerybooleanno
has_leadership_changequerybooleanno
has_expansion_signalquerybooleanno
has_renewal_duequerybooleanno
has_newly_licensedquerybooleanno
license_categoryquerystringno
license_statusquerystringno
license_authorityquerystringno
emiratequerystringno
free_zonequerystringno
isicquerystringno
activityquerystringno
has_dp_linkquerybooleanno
has_active_projectquerybooleanno
project_rolequerystringno
has_fnb_outletquerybooleanno
deq_permit_statusquerystringno
listedquerybooleanno
sort_byquerystringno
include_fitquerybooleanno
show_poor_fitquerybooleanno
icp_segmentquerystringno
pagequeryintegerno
per_pagequeryintegerno

GET /v1/search/contacts

Search contacts. Filter and page through contacts. Paid channels stay masked.

ParameterInTypeRequired
qquerystringno
company_idquerystringno
seniority_levelquerystringno
departmentquerystringno
location_countryquerystringno
hq_countryquerystringno
has_verified_emailquerybooleanno
has_verified_phonequerybooleanno
has_phonequerybooleanno
sort_byquerystringno
include_fitquerybooleanno
show_poor_fitquerybooleanno
icp_segmentquerystringno
pagequeryintegerno
per_pagequeryintegerno

GET /v1/signals

Signal feed. Ranked insight feed: one card per company, best signal first.

ParameterInTypeRequired
limitqueryintegerno
scopequerystringno

GET /v1/usage

Get usage. Credits, plan and this month's API calls for the workspace.