---
title: "Get a party by ID"
method: GET
path: "/contracts/{contract_id}/parties/{party_id}"
tags: ["Contract - Parties and Participants"]
---

# Get a party by ID

`GET /contracts/{contract_id}/parties/{party_id}`

Use this endpoint to retrieve a party from a contract.

## Path parameters

- `contract_id` integer, required
- `party_id` integer, required

## Headers

- `x-oneflow-api-token` string, required
- `x-oneflow-user-email` string, email

## Response `200`

Returns the requested party.

- union
  - object — The participants are signing on behalf of this company. See [Company party](https://developer.oneflow.com/docs/party#company).
    - `_links` object — Links to related endpoints.
      - `comments` object
        - `href` string, nullable
      - `contracts` object
        - `href` string, nullable
      - `contract` object
        - `href` string, nullable
      - `create` object
        - `href` string, nullable
      - `data_field` object
        - `href` string, nullable
      - `data_fields` object
        - `href` string, nullable
      - `events` object
        - `href` string, nullable
      - `event` object
        - `href` string, nullable
      - `files` object
        - `href` string, nullable
      - `file` object
        - `href` string, nullable
      - `next` object
        - `href` string, nullable
      - `parties` object
        - `href` string, nullable
      - `party` object
        - `href` string, nullable
      - `previous` object
        - `href` string, nullable
      - `publish` object
        - `href` string, nullable
      - `self` object
        - `href` string, nullable
      - `template_types` object
        - `href` string, nullable
      - `template_type` object
        - `href` string, nullable
      - `template` object
        - `href` string, nullable
      - `templates` object
        - `href` string, nullable
      - `workspaces` object
        - `href` string, nullable
      - `workspace` object
        - `href` string, nullable
      - `playbooks` object
        - `href` string, nullable
    - `_private_ownerside` object, nullable, required — Party data that is private to the ownerside.
      - `created_time` string, datetime, required
      - `custom_id` string, nullable, required
      - `updated_time` string, datetime, nullable, required
    - `country_code` string, country_code, required
    - `id` integer, required
    - `identification_number` string, required
    - `my_party` boolean, required
    - `name` string, required
    - `participants` object[], required — The maximum number of participants per contract across all parties is 40.
      - `_links` object — Links to related endpoints.
        - `comments` object
          - `href` string, nullable
        - `contracts` object
          - `href` string, nullable
        - `contract` object
          - `href` string, nullable
        - `create` object
          - `href` string, nullable
        - `data_field` object
          - `href` string, nullable
        - `data_fields` object
          - `href` string, nullable
        - `events` object
          - `href` string, nullable
        - `event` object
          - `href` string, nullable
        - `files` object
          - `href` string, nullable
        - `file` object
          - `href` string, nullable
        - `next` object
          - `href` string, nullable
        - `parties` object
          - `href` string, nullable
        - `party` object
          - `href` string, nullable
        - `previous` object
          - `href` string, nullable
        - `publish` object
          - `href` string, nullable
        - `self` object
          - `href` string, nullable
        - `template_types` object
          - `href` string, nullable
        - `template_type` object
          - `href` string, nullable
        - `template` object
          - `href` string, nullable
        - `templates` object
          - `href` string, nullable
        - `workspaces` object
          - `href` string, nullable
        - `workspace` object
          - `href` string, nullable
        - `playbooks` object
          - `href` string, nullable
      - `_permissions` object, required — This attribute contains the permissions for the participant/creator on the contract.
        - `contract:update` boolean, required
      - `_private_ownerside` object, nullable, required — Participant data that is private to the ownerside.
        - `created_time` string, datetime, required
        - `custom_id` string, nullable, required
        - `first_visited_time` string, datetime, nullable, required
        - `last_visited_time` string, datetime, nullable, required
        - `updated_time` string, datetime, nullable, required
        - `visits` integer, required
      - `delivery_channel` 'email' | 'sms' | 'email_and_sms' | 'same_device' | 'none' | 'unknown', required — One of the contract [delivery channels](contract#delivery-channels).
      - `delivery_status` 'not_sent' | 'pending' | 'failure' | 'bounce' | 'success' | 'opened' | 'unknown', required — One of the contract [delivery status](contract-participant#delivery-status).
      - `draft_approver` boolean — A flag to indicate if the participant is a draft approver.
      - `email` string, email, required
      - `id` integer, required
      - `identification_number` string, required
      - `my_participant` boolean, required
      - `name` string, nullable, required
      - `organizer` boolean, required — A flag to indicate if the participant is an organizer combined with the permissions.
      - `pending_approver` boolean — A flag to indicate if the participant is a pending approver.
      - `phone_number` string, nullable, required
      - `sign_method` 'standard_esign' | 'sms' | 'swedish_bankid' | 'norwegian_bankid' | 'danish_mitid' | 'finnish_bankid' | 'handwritten_signature' | 'eid_sign' | 'unknown', required — One of the [sign methods](contract#sign-methods).
      - `sign_state` 'undecided' | 'signed' | 'declined' | 'unknown', required — One of the [sign states](contract-participant#sign-state).
      - `sign_state_updated_time` string, datetime, nullable, required
      - `signatory` boolean, required — A flag to indicate if the participant is an signatory combined with the permissions.
      - `title` string, required
      - `two_step_authentication_method` 'email' | 'sms' | 'personal_identification' | 'none' | 'unknown', required — One of the [two step authentication methods](contract#two-step-authentication-methods).
    - `type` 'company', required — Can only be `company`.
  - object — An individual party, where a single participant is signing on behalf of him- or herself. See [Individual party](https://developer.oneflow.com/docs/party#individual)
    - `_links` object — Links to related endpoints.
      - `comments` object
        - `href` string, nullable
      - `contracts` object
        - `href` string, nullable
      - `contract` object
        - `href` string, nullable
      - `create` object
        - `href` string, nullable
      - `data_field` object
        - `href` string, nullable
      - `data_fields` object
        - `href` string, nullable
      - `events` object
        - `href` string, nullable
      - `event` object
        - `href` string, nullable
      - `files` object
        - `href` string, nullable
      - `file` object
        - `href` string, nullable
      - `next` object
        - `href` string, nullable
      - `parties` object
        - `href` string, nullable
      - `party` object
        - `href` string, nullable
      - `previous` object
        - `href` string, nullable
      - `publish` object
        - `href` string, nullable
      - `self` object
        - `href` string, nullable
      - `template_types` object
        - `href` string, nullable
      - `template_type` object
        - `href` string, nullable
      - `template` object
        - `href` string, nullable
      - `templates` object
        - `href` string, nullable
      - `workspaces` object
        - `href` string, nullable
      - `workspace` object
        - `href` string, nullable
      - `playbooks` object
        - `href` string, nullable
    - `_private_ownerside` object, nullable, required — Party data that is private to the ownerside.
      - `created_time` string, datetime, required
      - `custom_id` string, nullable, required
      - `updated_time` string, datetime, nullable, required
    - `country_code` string, country_code, required
    - `id` integer, required
    - `identification_number` string, required
    - `my_party` boolean, required
    - `name` string, nullable, required
    - `participant` object, required — See [Participant](https://developer.oneflow.com/docs/participant).
      - `_links` object — Links to related endpoints.
        - `comments` object
          - `href` string, nullable
        - `contracts` object
          - `href` string, nullable
        - `contract` object
          - `href` string, nullable
        - `create` object
          - `href` string, nullable
        - `data_field` object
          - `href` string, nullable
        - `data_fields` object
          - `href` string, nullable
        - `events` object
          - `href` string, nullable
        - `event` object
          - `href` string, nullable
        - `files` object
          - `href` string, nullable
        - `file` object
          - `href` string, nullable
        - `next` object
          - `href` string, nullable
        - `parties` object
          - `href` string, nullable
        - `party` object
          - `href` string, nullable
        - `previous` object
          - `href` string, nullable
        - `publish` object
          - `href` string, nullable
        - `self` object
          - `href` string, nullable
        - `template_types` object
          - `href` string, nullable
        - `template_type` object
          - `href` string, nullable
        - `template` object
          - `href` string, nullable
        - `templates` object
          - `href` string, nullable
        - `workspaces` object
          - `href` string, nullable
        - `workspace` object
          - `href` string, nullable
        - `playbooks` object
          - `href` string, nullable
      - `_permissions` object, required — This attribute contains the permissions for the participant/creator on the contract.
        - `contract:update` boolean, required
      - `_private_ownerside` object, nullable, required — Participant data that is private to the ownerside.
        - `created_time` string, datetime, required
        - `custom_id` string, nullable, required
        - `first_visited_time` string, datetime, nullable, required
        - `last_visited_time` string, datetime, nullable, required
        - `updated_time` string, datetime, nullable, required
        - `visits` integer, required
      - `delivery_channel` 'email' | 'sms' | 'email_and_sms' | 'same_device' | 'none' | 'unknown', required — One of the contract [delivery channels](contract#delivery-channels).
      - `delivery_status` 'not_sent' | 'pending' | 'failure' | 'bounce' | 'success' | 'opened' | 'unknown', required — One of the contract [delivery status](contract-participant#delivery-status).
      - `draft_approver` boolean — A flag to indicate if the participant is a draft approver.
      - `email` string, email, required
      - `id` integer, required
      - `identification_number` string, required
      - `my_participant` boolean, required
      - `name` string, nullable, required
      - `organizer` boolean, required — A flag to indicate if the participant is an organizer combined with the permissions.
      - `pending_approver` boolean — A flag to indicate if the participant is a pending approver.
      - `phone_number` string, nullable, required
      - `sign_method` 'standard_esign' | 'sms' | 'swedish_bankid' | 'norwegian_bankid' | 'danish_mitid' | 'finnish_bankid' | 'handwritten_signature' | 'eid_sign' | 'unknown', required — One of the [sign methods](contract#sign-methods).
      - `sign_state` 'undecided' | 'signed' | 'declined' | 'unknown', required — One of the [sign states](contract-participant#sign-state).
      - `sign_state_updated_time` string, datetime, nullable, required
      - `signatory` boolean, required — A flag to indicate if the participant is an signatory combined with the permissions.
      - `title` string, required
      - `two_step_authentication_method` 'email' | 'sms' | 'personal_identification' | 'none' | 'unknown', required — One of the [two step authentication methods](contract#two-step-authentication-methods).
    - `type` 'individual', required — Can only be `individual`.

## Other responses

- `400` — Invalid format or content of the request.
- `401` — The API token or the user email is invalid.
- `404` — A required entity is missing.

---

[API](https://skmtc.net/oneflow/apis/public-api-for-oneflow.md) · [All operations](https://skmtc.net/oneflow/apis/public-api-for-oneflow/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oneflow/public-api-for-oneflow/versions/0e73a45dec15/schema)