# Verdant

- [Climate data with its evidence intact](https://docs.verdant-ai.com/index.md): Query versioned climate data through one contract, directly from HTTP or an agent.
- [Query real data](https://docs.verdant-ai.com/quickstart.md): Discover coverage and get values directly in the response.
- [Data meaning and reproducibility](https://docs.verdant-ai.com/concepts/data-contract.md): The scientific guarantees behind each request and response.
- [Representation and delivery](https://docs.verdant-ai.com/concepts/delivery.md): Direct values, files and asynchronous work share one data contract.
- [Errors and compatibility](https://docs.verdant-ai.com/concepts/errors.md): Machine-readable failures, limits and retry rules.
- [Request and acquisition lifecycle](https://docs.verdant-ai.com/concepts/request-lifecycle.md): How a request for data that is not published yet becomes a validated dataset version.
- [Connect through MCP](https://docs.verdant-ai.com/agents/mcp.md): Search the docs with Mintlify; query live data with Verdant.
- [Backtesting skills](https://docs.verdant-ai.com/agents/skills.md): Install service-backed workflows for finding evidence and reproducing agricultural backtests.
- [Check process health](https://docs.verdant-ai.com/api-reference/service/check-process-health.md): Process/configuration status only. This does not verify database or source-provider connectivity.
- [Discover capabilities](https://docs.verdant-ai.com/api-reference/discovery/discover-capabilities.md): Discover the implemented variables, sources, representations, limits and feature availability. This does not check current source coverage.
- [List datasets](https://docs.verdant-ai.com/api-reference/discovery/list-datasets.md): List published catalog metadata. Published public datasets can be read without payment. Restricted datasets are omitted.
- [Inspect a dataset](https://docs.verdant-ai.com/api-reference/discovery/inspect-a-dataset.md): Inspect an immutable dataset version, including units, actual coverage, source hashes, license, attribution and spatial support.
- [Validate query structure](https://docs.verdant-ai.com/api-reference/queries/validate-query-structure.md): Validate shape, calendar dates and ordered bounds only. A valid request is not a coverage guarantee, quote or purchase. Bounds must be west < east and south < north; period start must not follow end. These cross-field constraints are enforced at runtime.
- [Resolve coverage](https://docs.verdant-ai.com/api-reference/queries/resolve-coverage.md): Check complete published coverage for a structured climate query. Returns the selected immutable version and row count, or an explicit unavailable reason; acquisitionEnabled reports whether POST /api/v1/data/requests can acquire a miss. Does not acquire data or charge.
- [Query data directly](https://docs.verdant-ai.com/api-reference/queries/query-data-directly.md): Return climate data directly in the response, with provenance. JSON includes a manifest and data array; CSV returns rows with version, digest and metadata-link headers. Only published public data is admitted. No charging, acquisition or missing-to-zero conversion.
- [Request data, acquiring a cache miss](https://docs.verdant-ai.com/api-reference/queries/request-data-acquiring-a-cache-miss.md): Get data that may not be published yet. Published coverage returns ready (free). An identical acquisition already running returns its request (free). Otherwise the request is acquired from the source for a fixed MPP price: the first call returns a payment challenge, and the paid retry returns a requ…
- [Poll an acquisition](https://docs.verdant-ai.com/api-reference/queries/poll-an-acquisition.md): Acquisition state (queued → acquiring → normalizing → validating → publishing → ready, or failed), attempts, sanitized tool and validation events, payments, and the published datasetVersion once ready. Failed paid acquisitions are refunded. Polling never charges.
- [Read observations](https://docs.verdant-ai.com/api-reference/observations/read-observations.md): Read public observations in stable ID order. Native dates and season labels remain distinct; a missing value is null, not zero. Follow nextCursor until null.
- [Read a raster index or tile](https://docs.verdant-ai.com/api-reference/raster/read-a-raster-index-or-tile.md): Only public data. Cells are top-down row-major: cells[row * width + col]. NULL is preserved. Affine [a,b,c,d,e,f] maps pixel centers to x=a*(col+.5)+b*(row+.5)+c and y=d*(col+.5)+e*(row+.5)+f.
- [Read one raster cell](https://docs.verdant-ai.com/api-reference/raster/read-one-raster-cell.md): Return one native cell and its spatial metadata. A null value means missing, and its unit and evidence class do not change.

## OpenAPI Specs

- [openapi](/openapi.json)

## Optional

- [Website](https://verdant-ai.com)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.