Skip to content

Ready job

Who won a public contract

The latest public contract awards in one European country, and the person to reach at each winner, with a work email you can trust.

5 single lookups

The lookups it runs

  1. List the latest contract awardsprocurement.awards.search
  2. Look up each winnercompanies.enrich
  3. Find each winner's websitecompanies.domain.find
  4. Find the person in that rolepeople.search
  5. Find and check each work emailpeople.email.find

What it gives.One table, one run.

You get a table: winner, contract, buyer, value, the winner's website, the person in that role and their work email, with whether it checks out.

Use Ahel to find who won public contracts in <country> lately, and the work email of the <role, such as CEO> at each winner.

Paste this into ChatGPT or Claude connected to Ahel.

What you give

country
a two-letter code: an EU country, Iceland, Liechtenstein or Norway
sinceoptional
awarded on or after this day, YYYY-MM-DD
wordsoptional
words in the contract
roleoptional
the job title to reach, CEO unless given
countoptional
how many, 1 to 25

The lookups.Run in this order.

  1. Step 1List the latest contract awardsprocurement.awards.search
  2. Step 2Look up each winnercompanies.enrich
  3. Step 3Find each winner's websitecompanies.domain.find
  4. Step 4Find the person in that rolepeople.search
  5. Step 5Find and check each work emailpeople.email.find

In Official Registers and Company Data.

For developers
Recipe id
contract-winners
Inputs
  • country: a two-letter code: an EU country, Iceland, Liechtenstein or Norway
  • since (optional): awarded on or after this day, YYYY-MM-DD
  • words (optional): words in the contract
  • role (optional): the job title to reach, CEO unless given
  • count (optional): how many, 1 to 25
HTTP call
curl -s https://ahel.ai/api/platform/v2/recipes/contract-winners/runs \
  -H "X-Ahel-Token: $AHEL_TOKEN" -H "Content-Type: application/json" \
  -d '{"inputs":{"country":"<country>"},"max_cost_usd":"<your cap>"}'

Send it without max_cost_usd first. Nothing runs without it.

On a schedule
curl -s https://ahel.ai/api/platform/v2/recipes/contract-winners/schedules \
  -H "X-Ahel-Token: $AHEL_TOKEN" -H "Content-Type: application/json" \
  -d '{"inputs":{"country":"<country>"},"max_cost_usd":"<cap per run>","every":"day","webhook_url":"https://<your server>/ahel","run_now":true}'

Each finished run is posted to webhook_url as JSON. To check it is from Ahel, read X-Ahel-Signature: t=<unix seconds>,v1=<hex>. v1 must equal the hex HMAC-SHA256 of "<t>.<raw body>", keyed with the signing_secret the call answered, whsec_ included. Refuse a t more than 5 minutes off. Answer 2xx within 10 seconds.

API reference