---
title: "Get party"
method: GET
path: "/parties/{py_code}"
tags: ["Parties"]
---

# Get party

`GET /parties/{py_code}`

Retrieve a single party using its `py_code`.

## Path parameters

- `py_code` string, required

## Query parameters

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