---
title: "List parties"
method: GET
path: "/parties"
tags: ["party"]
---

# List parties

`GET /parties`

## Request

- Base URL: `https://localhost:4410/api/v1`
- URL: `https://localhost:4410/api/v1/parties`
- Auth: HTTP bearer

## Query parameters

- `role` 'investor' | 'director' | 'manager' | 'officer' | 'signer' | 'counterparty' | 'employee' | 'founder' | 'contractor' | 'candidate' | 'advisor' | 'holder'
- `query` string
- `include_archived` boolean
- `cursor` string
- `limit` integer

## Response `200`

The result.

- object
  - `items` object[], required
    - `id` string, required
    - `kind` 'individual' | 'entity' | 'joint', required
    - `legal_name` string, required
    - `emails` string[], required
    - `roles` string[], required
    - `address` object, nullable, required
      - `lines` string[], required
      - `country` string, required: ISO 3166-1 alpha-2
      - `region` string
    - `signatories` object[], required
      - `name` string, required
      - `title` string, required
      - `email` string, email, required
    - `member_id` string, nullable, required
    - `entered_by_agent` boolean, required
    - `source_quote` string, nullable, required
    - `archived` boolean, required
    - `created_at` string, date-time, required
  - `next_cursor` string, nullable, required

## Other responses

- `default`: An RFC 9457 problem.

---

[API](https://skmtc.dev/binderwork/apis/binderwork-api.md) · [All operations](https://skmtc.dev/binderwork/apis/binderwork-api/llms.txt) · [OpenAPI document](https://skmtc.dev/binderwork/apis/binderwork-api/revisions/f8fab0ebee53?raw)