Documentation for the Every Farm Developer API. This API allows 3rd-party developers to access farm and dataset data programmatically using API tokens.

Overview

The Developer API provides authenticated, rate-limited access to farm data, datasets, and GeoJSON files. Developers generate API tokens through the application UI, then use those tokens to make HTTP requests from their own servers or scripts.

Base URL

<https://api.every.farm>

API Discovery

GET /v1 returns a self-describing JSON manifest of the entire API — every endpoint with a one-line summary and required scope, the authentication scheme, conventions (signed-URL TTLs, rate limits, timestamp shape), and a link back to this documentation. It requires no authentication and exposes no farm data.

This is the recommended first call for an AI agent: hand the agent a token and the base URL, and it can discover everything else from GET <https://api.every.farm/v1>.

Authentication

API Tokens

All data-access endpoints require a Bearer token in the Authorization header:

Authorization: Bearer efv_abc12345_...

Tokens are generated from the API Tokens panel in the app (open your account menu → API Tokens). Each token:

• Has a prefix efv_ for easy identification
• Is shown once at creation — it cannot be retrieved again
• Can be scoped to read, write, or both
• Can optionally be restricted to specific farms
• Can be set to expire after 30, 90, 180, or 365 days (or never)