---
title: "Get partner management"
method: GET
path: "/api/v1/account/partner-management/{id}"
tags: ["account"]
---

# Get partner management

`GET /api/v1/account/partner-management/{id}`

## Request

- Base URL: `https://point11.ai`
- URL: `https://point11.ai/api/v1/account/partner-management/{id}`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://auth.point11.ai/oauth2/authorize`, token URL `https://auth.point11.ai/oauth2/token`)

Read the organization's account-management partner, by the organization's id: the partner firm it designated, if any, who designated it, when it took effect, and whether the organization's owner or admin designated it here or Point11 recorded the organization's written confirmation. Lists the firms it may designate (partner firms that work in it, or that brought it to Point11) and the standard confirmation a designation acknowledges, with its sha256 for account_partner_management_designate. A designation lets Point11 compensate the firm; it grants no access.

## Path parameters

- `id` string, required: The organization id

## Headers

- `Point11-Organization` string, uuid

## Response `200`

Success.

- AccountPartnerManagementGetResponse
  - `designation` object, nullable, required: The firm designated now; null when none is
    - `id` string, uuid, required: The designation's id, for account_partner_management_revoke
    - `managerId` string, uuid, required
    - `name` string, required: The partner firm's name
    - `partnerId` string, required: The firm's 10-digit Partner ID, bare digits
    - `source` 'customer' | 'written_confirmation', required: customer: the organization's own owner or admin designated it here; written_confirmation: Point11 recorded the organization's written confirmation
    - `representativeName` string, required: Who designated the firm for the organization
    - `receivedAt` string, date-time, required: When Point11 received the designation
    - `effectiveAt` string, date-time, required: When it took, or takes, effect
  - `candidates` object[], required: The firms the organization may designate: partner firms that can work in it, or that brought it to Point11
    - `managerId` string, uuid, required
    - `name` string, required: The partner firm's name
    - `partnerId` string, required: The firm's 10-digit Partner ID, bare digits
  - `acknowledgment` object, required
    - `text` string, required: The standard confirmation a designation acknowledges
    - `sha256` string, required: Its SHA-256, for account_partner_management_designate

## Other responses

- `400`: The input, query, or Idempotency-Key is invalid.
- `401`: The bearer is missing, expired, or not accepted.
- `403`: The credential lacks the operation's scope or role, or the operation needs a different door.
- `404`: The resource or organization does not exist for this caller.
- `405`: This path takes another HTTP method, named in `Allow`.
- `409`: The request conflicts with current state or with prior use of its Idempotency-Key.
- `413`: The request, or the answer it asks for, is too large; narrow it.
- `429`: The credential's rate budget is spent; retry after `Retry-After` seconds.
- `500`: An unexpected server failure; retry later. Only `request_id` identifies it.
- `503`: A dependency is temporarily unavailable; retry after `Retry-After` seconds.
- `default`: Another status a product answers for its own refusal (for example `415` for an unsupported attachment); branch on `code`.

---

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