---
title: "Get all parties"
method: GET
path: "/parties"
tags: ["Parties"]
---

# Get all parties

`GET /parties`

Retrieve a paginated collection of all parties recorded in VegBank.

## Query parameters

- `search` string
- `sort` 'default' | '+default' | '-default' | 'surname' | '+surname' | '-surname' | 'organization_name' | '+organization_name' | '-organization_name' | 'obs_count' | '+obs_count' | '-obs_count'
- `limit` integer
- `offset` integer
- `create_parquet` boolean

## Response `200`

Matching party or parties

- Party
  - `py_code` string — VegBank party identifier
  - `party_label` string — Name/label for the party
  - `salutation` string — Salutation used in addressing an individual with a particular title
  - `given_name` string — All names, except the surname, of the individual associated with the resource. Possible usages include: first name and middle name, first name and middle initials, first name, etc.
  - `middle_name` string — Middle name or initial, if any
  - `surname` string — Name shared in common to identify the members of a family, as distinguished the given name
  - `organization_name` string — Full name of the organization, which may be the party itself if this is an organization-type party record, or else is the organization that the party is associated with if this is a person-type party record
  - `contact_instructions` string — Instructions for contacting a party
  - `obs_count` integer — Number of plot observations associated with this entity

## Other responses

- `400` — Invalid Parameters

## Changes

> 50 revisions in range; 1 not diffed.

- **2026-01-18** `2e123831df6e` — 3 breaking, 4 warning, 8 info
  - for the `query` request parameter `limit`, default value `1000` was added
  - for the `query` request parameter `offset`, default value `0` was added
  - the response's body type/format changed from `object`/`` to ``/`` for status `200`
  - for the `query` request parameter `limit`, the min was set to `0.00`
  - …11 more
- **2025-05-24** `16a2946a00d0` — 1 info
  - endpoint added
- **2025-04-29** `c9e23cb778c9` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/nceas/apis/vegbankapi/changes/parties/get.md)

---

[API](https://skmtc.dev/nceas/apis/vegbankapi.md) · [All operations](https://skmtc.dev/nceas/apis/vegbankapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nceas/vegbankapi/revisions/852fd165e202/schema)