Examples

Copyable requests for the most common integration tasks.

Match a name to a registered entity

curl "https://varosyanllc.com/api/public/v1/companies?country=QA&q=al%20jazeera&page_size=5"

Run this example

Enrich an account with contacts and leadership

const res = await fetch(
  "https://varosyanllc.com/api/public/v1/companies/QA/" + slug,
  { headers: { Authorization: "Bearer " + process.env.VAROSYAN_API_KEY } }
);
const { data } = await res.json();
console.log(data.company.corporate_email, data.people.length, data.branches.length);

Build a research list by city and licence status

curl "https://varosyanllc.com/api/public/v1/companies?country=QA&city=Doha&licence_status=Active&has_email=true&sort=updated&page_size=100" \
  -H "Authorization: Bearer $VAROSYAN_API_KEY"

Run this example

Call an MCP tool directly

curl -X POST "https://varosyanllc.com/api/public/mcp" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_companies","arguments":{"q":"trading","country":"QA","page_size":5}}}'

Run this example

Paging through large result sets

Request page_size=100 and increment page until page > total_pages. Keep requests sequential so a single job stays inside its hourly quota, and cache results you will reuse.