---
title: "Get parties by ob"
method: GET
path: "/plot-observations/{ob_code}/parties"
tags: ["Parties"]
---

# Get parties by ob

`GET /plot-observations/{ob_code}/parties`

Retrieve a paginated and sorted collection of parties associated with the specified plot observation (using its `ob_code`), or a subset thereof based on a specified `search` query.

## Path parameters

- `ob_code` string, required

## 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

---

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