# Euroopahanked.ee

Euroopahanked.ee helps companies find European public procurement opportunities and compare previous contract awards. This file is intended for AI agents and LLM-based tools.

## Public Site

- Home: https://euroopahanked.ee/
- Tenders: https://euroopahanked.ee/hanked
- Contract analysis: https://euroopahanked.ee/lepingud
- Articles: https://euroopahanked.ee/artiklid
- Pricing: https://euroopahanked.ee/hinnad
- Sitemap: https://euroopahanked.ee/sitemap.xml

## Agent API

Euroopahanked provides an authenticated read-only Agent API for customer-owned agents.

- Agent API guide: https://euroopahanked.ee/agents/euroopahanked-agent-api.md
- Health endpoint: https://euroopahanked.ee/api/agent/v1/health
- Capabilities endpoint: https://euroopahanked.ee/api/agent/v1/capabilities
- Auth/discovery guide: https://euroopahanked.ee/auth.md
- Protected resource metadata: https://euroopahanked.ee/.well-known/oauth-protected-resource
- MCP JSON-RPC endpoint: https://euroopahanked.ee/mcp
- API prefix: https://euroopahanked.ee/api/agent/v1

Agents without a token should start the browser-confirmed device flow:

1. POST /api/agent/v1/device/start with a client name.
2. Show verificationUrlComplete to the user.
3. Poll POST /api/agent/v1/device/token with deviceCode.
4. After the logged-in user approves access, the poll response returns a Bearer token.

A logged-in Euroopahanked user can also create an agent token manually in the company profile integrations view. Use:

Authorization: Bearer <agent_token>

## Main Rules For Agents

- Start with GET /api/agent/v1/me to check access and limits.
- Use GET /api/agent/v1/cpv to discover available CPV sectors or codes before CPV-based searches.
- Tender search must include at least keyword or cpv.
- Contract search must include at least cpv, buyer or winner.
- Use search results first; request tender or contract details only when the user selects a specific item.
- Use returned API reference values for selected detail requests. Do not guess or expose internal tender IDs from search results.
- If documentQuestionsSupported is true, use the document-question endpoint instead of trying to download tender documents.
- Do not bulk crawl, scrape or mirror the tender database.
- Do not resell Euroopahanked data.
- If Euroopahanked data is published or quoted outside the service, include a clear reference to Euroopahanked.ee.
- Respect 429 rate-limit responses.

## Relevant API Endpoints

- GET /api/agent/v1/me
- GET /api/agent/v1/capabilities
- POST /api/agent/v1/device/start
- POST /api/agent/v1/device/token
- GET /api/agent/v1/cpv
- GET /api/agent/v1/tenders
- GET /api/agent/v1/tenders/{agentTenderUuid}
- POST /api/agent/v1/tenders/{agentTenderUuid}/document-question
- GET /api/agent/v1/contracts
- GET /api/agent/v1/contracts/{agentContractUuid}
- GET /api/agent/v1/billing/status
- POST /mcp

## Human Support

For commercial API usage or higher limits, contact Euroopahanked support through the website.