---
title: "GET /parties/{partyId}/farms"
method: GET
path: "/parties/{partyId}/farms"
tags: ["Farms"]
---

# GET /parties/{partyId}/farms

`GET /parties/{partyId}/farms`

## Request

- Base URL: `{endpoint}`
- URL: `{endpoint}/parties/{partyId}/farms`
- Auth: API key in header `Authorization`

Returns a paginated list of farm resources under a particular party.

## Path parameters

- `partyId` string, required

## Query parameters

- `ids` string[]
- `names` string[]
- `propertyFilters` string[]
- `statuses` string[]
- `minCreatedDateTime` string, date-time
- `maxCreatedDateTime` string, date-time
- `minLastModifiedDateTime` string, date-time
- `maxLastModifiedDateTime` string, date-time
- `maxPageSize` integer
- `skipToken` string
- `api-version` string, required

## Response `200`

Success

- FarmListResponse: Paged response contains list of requested objects and a URL link to get the next set of results.
  - `value` Farm[], required: List of requested objects.
    - `partyId` string: Party Id.
    - `id` string: Unique resource ID.
    - `eTag` string: The ETag value to implement optimistic concurrency.
    - `status` string: Status of the resource.
    - `createdDateTime` string, date-time: Date-time when resource was created, sample format: yyyy-MM-ddTHH:mm:ssZ.
    - `modifiedDateTime` string, date-time: Date-time when resource was last modified, sample format: yyyy-MM-ddTHH:mm:ssZ.
    - `source` string: Source of the resource.
    - `name` string: Name to identify resource.
    - `description` string: Textual description of the resource.
    - `createdBy` string: Created by user/tenant id.
    - `modifiedBy` string: Modified by user/tenant id.
    - `properties` object: A collection of key value pairs that belongs to the resource. Each pair must not have a key greater than 50 characters and must not have a value greater than 150 characters. Note: A maximum of 25 key value pairs can be provided for a resource and only string, numeral and datetime (yyyy-MM-ddTHH:mm:ssZ) values are supported.
  - `skipToken` string: Token used in retrieving the next page. If null, there are no additional pages.
  - `nextLink` string: Continuation link (absolute URI) to the next page of results in the list.

## Other responses

- `default`: Error

## Changes

- **2026-07-13** (2021-03-31-preview) `aae0a90ec457`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/azure/apis/agrifood-agfoodplatform/changes/parties/:partyId/farms/get.md)

---

[API](https://skmtc.dev/azure/apis/agrifood-agfoodplatform.md) - [All operations](https://skmtc.dev/azure/apis/agrifood-agfoodplatform/llms.txt) - [OpenAPI document](https://skmtc.dev/azure/apis/agrifood-agfoodplatform/revisions/33cf1de6e0c4?raw)
