# codai Tools API

**Canonical:** https://apis.io/apis/codai-ro/codai-ro-tools-api/  
**Provider:** codai — https://apis.io/providers/codai-ro/  
**Base URL:** https://ai.codai.ro  
**Documentation:** https://docs.codai.ro/docs/api

codai Tools API is one of 35 APIs that [codai](https://apis.io/providers/codai-ro/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 1 JSON Schema definition. Tagged areas include Tools. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 1 JSON Schema.

Native web tools for agents: verified web search, a server-side page fetch with an SSRF guard and asynchronous deep research (`/v1/research`). The contract (names, JSON schemas, limits, how results render for a model) is shared with every codai agent surface — VS Code, desktop, phone, headless CLI, hosted MCP and the SDKs — and lives in `packages/agent-core/spec/tools-web.json`. None of them is a model call, so no usage row is written; each call is metered separately: $3 per 1,000 fast searches, $8 per 1,000 deep searches, $0.50 per 1,000 fetches and $0.20 per research job (plus the job's own model tokens), charged in EUR from your wallet. The first 1,000 calls per user per UTC month are free, and calls made inside a codai agent turn are never charged; errors and cache hits are never charged either. All of them share the per-key request limiter with `/v1/chat/completions` and pass through your rules (a `deny web_search` / `deny browser_fetch` rule is a 403, never an empty result; `deny web_search` also denies research). The `/v1/cards/*` endpoints return data already shaped as card blocks (weather, places, maps, exchange rates, link previews). Weather, exchange rates and link previews are free; Google-backed places, geocoding and static maps write one usage row per upstream call at Google's list price.

## Operations (16)

| Method | Path | Summary |
|---|---|---|
| POST | `/v1/tools/search` | Verified web search |
| POST | `/v1/tools/fetch` | Fetch and extract a public web page |
| POST | `/v1/research` | Start an asynchronous deep-research job |
| GET | `/v1/research/{id}` | Poll a deep-research job |
| POST | `/v1/tools/ground` | Find a described UI element on a screenshot (GUI grounding) |
| GET | `/v1/cards/weather` | Weather card data (MET Norway) |
| GET | `/v1/cards/places` | Places card data (Google Places) |
| GET | `/v1/cards/geocode` | Geocode an address into a map card block |
| GET | `/v1/cards/static-map` | Static map image for map cards (PNG) |
| GET | `/v1/cards/fx` | Exchange-rate card data (BNR / ECB) |
| GET | `/v1/cards/route` | Travel time card data (Google Routes) |
| GET | `/v1/cards/track` | Parcel tracking card data (Sameday, FAN Courier, Cargus, DPD) |
| GET | `/v1/cards/efactura` | e-Factura status card data (Brivio) |
| POST | `/v1/cards/product` | Product card data (schema.org Product) |
| POST | `/v1/cards/unfurl` | Link preview card data (unfurl) |
| POST | `/v1/cards/render` | Render a card block to an image (SVG / PNG) |

## Machine-readable artifacts (3)

- **OpenAPI** — https://artifacts.apis.io/codai-ro/openapi/codai-ro-tools-api-openapi.yml
- **Documentation** — https://docs.codai.ro/docs/gateway
- **JSONSchema** — https://artifacts.apis.io/codai-ro/json-schema/codai-ro-tool-search-request-schema.json

## Other codai APIs (12)

- [codai Account API](https://apis.io/apis/codai-ro/codai-ro-account-api/)
- [codai Agents API](https://apis.io/apis/codai-ro/codai-ro-agents-api/)
- [codai Attestations API](https://apis.io/apis/codai-ro/codai-ro-attestations-api/)
- [codai Authorization API](https://apis.io/apis/codai-ro/codai-ro-authorization-api/)
- [codai Chat & Completions API](https://apis.io/apis/codai-ro/codai-ro-chat-completions-api/)
- [codai Connect API](https://apis.io/apis/codai-ro/codai-ro-connect-api/)
- [codai Devices API](https://apis.io/apis/codai-ro/codai-ro-devices-api/)
- [codai Discovery API](https://apis.io/apis/codai-ro/codai-ro-discovery-api/)
- [codai Embeddings & Audio API](https://apis.io/apis/codai-ro/codai-ro-embeddings-audio-api/)
- [codai Feed API](https://apis.io/apis/codai-ro/codai-ro-feed-api/)
- [codai Guest chat API](https://apis.io/apis/codai-ro/codai-ro-guest-chat-api/)
- [codai Health API](https://apis.io/apis/codai-ro/codai-ro-health-api/)

## Tags

Tools

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/codai-ro/codai-ro-tools-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/codai-ro/.