Farm Machinery and Equipment API Farm Machinery API

openapi: 3.1.0
info:
  title: APIFarmer and Equipment Farm Machinery API
  description: REST API exposing a database of agricultural machinery and equipment - technical specifications, manufacturer details, horsepower, fuel capacity, weights, dimensions, operating parameters, features, warranty terms, maintenance schedules, and compatibility data. The Farm Machinery endpoint is part of the broader APIFarmer platform at api.apifarmer.com, authenticated with a per-request api-key query parameter issued after subscribing to a plan.
  version: 0.0.0
  contact:
    name: APIFarmer
    url: https://apifarmer.com/
servers:
- url: https://api.apifarmer.com/v0
  description: APIFarmer production API
security:
- ApiKeyQuery: []
tags:
- name: Farm Machinery
paths:
  /farm_machinery:
    get:
      tags:
      - Farm Machinery
      summary: Search farm machinery and equipment records
      description: Retrieve farm machinery records. Records can be filtered by equipment id, manufacturer, model, equipment type, and a range of technical specifications. Supports JSON, XML, and HTML response formats. Rate limited to 600 calls per minute on paid plans.
      parameters:
      - in: query
        name: api-key
        required: true
        schema:
          type: string
        description: API key issued by APIFarmer after subscription
      - in: query
        name: equipment_id
        schema:
          type: string
      - in: query
        name: manufacturer
        schema:
          type: string
      - in: query
        name: model
        schema:
          type: string
      - in: query
        name: type
        schema:
          type: string
        description: Equipment type (tractor, harvester, etc.)
      - in: query
        name: engine_power_hp
        schema:
          type: number
          format: float
      - in: query
        name: horsepower
        schema:
          type: number
          format: float
      - in: query
        name: fuel_capacity_liters
        schema:
          type: number
          format: float
      - in: query
        name: weight_kg
        schema:
          type: number
          format: float
      - in: query
        name: dimensions_mm
        schema:
          type: string
      - in: query
        name: operating_speed_kph
        schema:
          type: number
          format: float
      - in: query
        name: format
        schema:
          type: string
          enum:
          - json
          - xml
          - html
          default: json
      responses:
        '200':
          description: Matching farm machinery records
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/FarmMachinery'
        '401':
          description: Missing or invalid API key
        '429':
          description: Rate limit exceeded
components:
  schemas:
    FarmMachinery:
      type: object
      properties:
        equipment_id:
          type: string
        manufacturer:
          type: string
        model:
          type: string
        type:
          type: string
        engine_power_hp:
          type: number
          format: float
        horsepower:
          type: number
          format: float
        fuel_capacity_liters:
          type: number
          format: float
        weight_kg:
          type: number
          format: float
        dimensions_mm:
          type: string
        operating_speed_kph:
          type: number
          format: float
        features:
          type: array
          items:
            type: string
        warranty:
          type: string
        maintenance_schedule:
          type: string
        compatibility:
          type: array
          items:
            type: string
  securitySchemes:
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api-key