---
title: "Transport Suggestions"
method: GET
path: "/v1/farm/{farm_id}/traceability-events/transport-suggestions"
tags: ["traceability"]
---

# Transport Suggestions

`GET /v1/farm/{farm_id}/traceability-events/transport-suggestions`

## Request

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

Bounded recent transporter/vehicle suggestions from current nonvoid revisions. The strict `take` limit is 1-100 and defaults to 20; offset pagination (`skip`) is not supported. Event, history, and suggestion reads use read:records; writes use write:records; a payload that updates current animal identifiers or status additionally requires write:animals.

## Path parameters

- `farm_id` string, uuid, required

## Query parameters

- `take` integer

## Response `200`

Success

- object
  - `suggestions` 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)