PasturePath API

v1.0.0

Farm management and marketplace API. Manage farms, fields, crops, harvests, livestock, products, and tasks.

Interactive Docs

Explore all endpoints, try requests, and see response schemas with our Swagger UI documentation.

Open Swagger UI

OpenAPI Schema

Download the raw OpenAPI 3.0 schema for code generation, Postman import, or other tooling.

Download Schema

Authentication

JWT Bearer Google OAuth

Use JWT tokens via /api/auth/login/ or Google Sign-In via /api/auth/google/. Send the access token as Authorization: Bearer <token>.

Endpoints Overview

Authentication

POST/api/auth/register/Create account
POST/api/auth/login/Login (JWT)
POST/api/auth/google/Google Sign-In
POST/api/auth/token/refresh/Refresh token
POST/api/auth/logout/Logout

Farms & Fields

GET/api/farms/List farms
POST/api/farms/Create farm
GET/api/fields/List fields
POST/api/fields/Create field

Crops & Harvests

GET/api/crops/List crops
GET/api/harvests/List harvests
POST/api/harvests/Record harvest

Products & Orders

GET/api/products/List products
POST/api/products/Create product

Livestock

GET/api/livestock/List livestock
GET/api/livestock-productions/Production records

Tasks

GET/api/tasks/List tasks
POST/api/tasks/Create task
View Full Documentation