---
title: "Traceability Event Revisions"
method: GET
path: "/v1/farm/{farm_id}/traceability-events/{event_id}/revisions"
tags: ["traceability"]
---

# Traceability Event Revisions

`GET /v1/farm/{farm_id}/traceability-events/{event_id}/revisions`

## Request

- Base URL: `https://api.ranch.bot`
- URL: `https://api.ranch.bot/v1/farm/{farm_id}/traceability-events/{event_id}/revisions`
- Auth: HTTP bearer

List every stored revision, including superseded and voided facts. Event/history/suggestion scopes use read:records/write:records; a payload that updates current animal identifiers or status additionally requires write:animals.

## Path parameters

- `farm_id` string, uuid, required
- `event_id` string, uuid, required

## Response `200`

Success

- object
  - `event_id` string, required
  - `current_revision` integer, required
  - `status` string, required
  - `revisions` object[], required

## Other responses

- `400`: Validation failed.
- `401`: Missing/invalid authentication or role.
- `403`: Missing required credential scope.
- `404`: Not found.
- `409`: Conflict (stale version, reused key, or returned/void event).

---

[API](https://skmtc.dev/ranch/apis/ranch-bot-http-api.md) · [All operations](https://skmtc.dev/ranch/apis/ranch-bot-http-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ranch/apis/ranch-bot-http-api/revisions/24109d33fa02?raw)