https://api.milda.ai/v1/tender-awards/candidatesTender Award Candidates
application/jsonDescription
Tender Awards — Candidates
POST /v1/tender-awards/candidates
Step 1 of tender awards. Tender awards are linked to registered legal entities, so a company ID first resolves to its candidates: the registered companies behind it, such as a parent and its national subsidiaries. If you already pass the exact target company ID, a single matching candidate is returned.
Request
company_id(required) — Company ID.
Response
List of candidates:
- candidate_id — pass this to the endpoints below.
- registration_number, name, country_code, url, age, size
Candidate IDs are the same as in risk assessment, so a candidate_id from either group works in both.
Returns 204 No Content if nothing matches.
Flow & credits
Pick a candidate_id and call overview, buyers, partners or awards. A candidate with no awards returns 204 No Content there, at no cost, so try the next one. This candidates step is free.
Headers
Request body
CompanyRequestResponses
Returns a JSON array. Each item: