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

# Get party

`GET /parties/me`

Get the current party

## Headers

- `X-Instance-ID` string, nullable

## Response `200`

Successful Response

- object
  - `data` object, required
    - `id` string, required — Party ID (pty_*).
    - `type` 'party', required — Resource type. Always `party`.
    - `attributes` object, required
      - `partyType` 'PERSON' | 'ORG', required — Party type.
      - `legalName` string, nullable, required — Legal business name for `ORG` parties.
      - `firstName` string, nullable, required — Legal first name for `PERSON` parties.
      - `lastName` string, nullable, required — Legal last name for `PERSON` parties.
      - `status` 'PROVISIONAL' | 'ACTIVE' | 'SUSPENDED' | 'INACTIVE', required — Party status.
      - `createdAt` string, date-time, required — RFC 3339 timestamp when the party was created.
      - `updatedAt` string, date-time, required — RFC 3339 timestamp when the party was last updated.
      - `displayName` string, nullable, required — Display name for the party.
      - `handle` string, nullable, required — Party handle, such as @acme, or null when none is set.
      - `avatarUrl` string, nullable, required — Public avatar URL, or null when none is set.
      - `persona` 'INDIVIDUAL' | 'DEVELOPER', nullable, required — Party persona, when available.
      - `email` string, nullable, required — Party's primary contact email.
      - `primaryPhone` string, nullable, required — Party's primary phone number.
      - `addressLine1` string, nullable, required — Street address line 1.
      - `addressCity` string, nullable, required — City.
      - `addressState` string, nullable, required — State or province.
      - `addressPostalCode` string, nullable, required — Postal or ZIP code.
      - `addressCountry` string, nullable, required — Country code (e.g., US).
      - `createdBy` string, nullable, required — User who created this party (usr_*).

## Other responses

- `400` — Validation Error
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found. Returned when the resource does not exist, or when it exists but is not accessible to your account. The two cases are intentionally indistinguishable, so that resource IDs cannot be enumerated by probing.
- `409` — Conflict
- `422` — Validation Error. The response contains one error object for each invalid request value.
- `428` — Precondition Required
- `429` — Too Many Requests
- `500` — Internal Server Error
- `501` — Not Implemented
- `502` — Bad Gateway
- `503` — Service Unavailable

## Changes

- **2026-09-02** `c7c12da5915f` — 12 info
  - added the optional property `errors/items/meta/limitScope` to the response with the `400` status
  - added the optional property `errors/items/meta/limitScope` to the response with the `401` status
  - added the optional property `errors/items/meta/limitScope` to the response with the `403` status
  - added the optional property `errors/items/meta/limitScope` to the response with the `404` status
  - …8 more
- **2026-08-27** `359d267dca88` — 1 info
  - deleted the `header` request parameter `X-Agent-ID` with deprecation
- **2026-08-23** `b1ad79e918ac` — 1 info
  - `header` request parameter `X-Agent-ID` was deprecated
- **2026-07-14** `8cc2aed45847` — 1 info
  - added the required property `data/attributes/avatarUrl` to the response with the `200` status

[Change history](https://skmtc.dev/natural/apis/natural-api/changes/parties/me/get.md)

---

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