CalvingWatch Public knowledge API

Read-only, non-personal CalvingWatch facts.

Operations 6

GET /api/public/v1/knowledge Get the complete public knowledge record #
HEAD /api/public/v1/knowledge Inspect public knowledge response metadata #
OPTIONS /api/public/v1/knowledge CORS preflight #
GET /api/public/v1/pages/{key} Get one canonical public-page record #
HEAD /api/public/v1/pages/{key} Inspect page-record response metadata #
OPTIONS /api/public/v1/pages/{key} CORS preflight #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/calvingwatch-com:calvingwatch-com-public-knowledge-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

calvingwatch-com-public-knowledge-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: CalvingWatch Public knowledge API
  version: 1.0.0
  summary: Read-only public product, safety, privacy and page facts.
  description: This API returns facts already published on calvingwatch.com. It does not expose farmer accounts, cameras, frames, credentials, tester submissions or veterinary advice.
  contact:
    name: CalvingWatch
    email: info@calvingwatch.com
    url: https://calvingwatch.com/ai/
  license:
    name: CalvingWatch public content-use policy
    url: https://calvingwatch.com/ai-use/
servers:
- url: https://calvingwatch.com
  description: Production public website
tags:
- name: Public knowledge
  description: Read-only, non-personal CalvingWatch facts.
paths:
  /api/public/v1/knowledge:
    get:
      operationId: getPublicKnowledge
      summary: Get the complete public knowledge record
      tags:
      - Public knowledge
      responses:
        '200':
          description: Current public CalvingWatch knowledge
          headers:
            Access-Control-Allow-Origin:
              schema:
                type: string
                const: '*'
            Cache-Control:
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicKnowledge'
    head:
      operationId: headPublicKnowledge
      summary: Inspect public knowledge response metadata
      tags:
      - Public knowledge
      responses:
        '200':
          description: Knowledge metadata without a response body
    options:
      operationId: optionsPublicKnowledge
      summary: CORS preflight
      tags:
      - Public knowledge
      responses:
        '204':
          description: Allowed cross-origin methods and headers
  /api/public/v1/pages/{key}:
    get:
      operationId: getPublicPageRecord
      summary: Get one canonical public-page record
      tags:
      - Public knowledge
      parameters:
      - name: key
        in: path
        required: true
        description: Stable public-page key from the knowledge record.
        schema:
          type: string
          enum:
          - overview
          - ireland
          - camera
          - how_it_works
          - about
          - privacy
          - terms
          - dpa
          - subprocessors
          - ai
          - ai_use
      responses:
        '200':
          description: Canonical page record
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicPage'
        '404':
          description: Unknown page key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
    head:
      operationId: headPublicPageRecord
      summary: Inspect page-record response metadata
      tags:
      - Public knowledge
      parameters:
      - name: key
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Page-record metadata without a body
        '404':
          description: Unknown page key
    options:
      operationId: optionsPublicPageRecord
      summary: CORS preflight
      tags:
      - Public knowledge
      parameters:
      - name: key
        in: path
        required: true
        schema:
          type: string
      responses:
        '204':
          description: Allowed cross-origin methods and headers
components:
  schemas:
    Error:
      type: object
      required:
      - error
      properties:
        error:
          type: string
      additionalProperties: false
    PublicPage:
      type: object
      required:
      - title
      - url
      - purpose
      properties:
        title:
          type: string
        url:
          type: string
          format: uri
        purpose:
          type: string
      additionalProperties: false
    PublicKnowledge:
      $ref: https://calvingwatch.com/ai/knowledge.schema.json