---
title: "Get Affiliation"
method: GET
path: "/api/v1/identities/{agent_handle}/domain-affiliation"
tags: ["Identities"]
---

# Get Affiliation

`GET /api/v1/identities/{agent_handle}/domain-affiliation`

## Request

- Base URL: `https://api.inkbox.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.inkbox.ai/api/v1/identities/{agent_handle}/domain-affiliation`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Path parameters

- `agent_handle` string, required

## Response `200`

Successful Response

- IdentityDomainAffiliationResponse
  - `domain_claim_id` string, nullable
  - `domain` string, nullable
  - `affiliation` DomainAffiliationAssertion
    - `domain` string, required
    - `verifier` 'Inkbox'
    - `last_success_at` string, date-time, required
    - `valid_until` string, date-time, required

## Other responses

- `422`: Validation Error
- `4XX`: Client error with Support Agent information.
- `5XX`: Server error with Support Agent information.

## Changes

- **2026-10-03** `7e1cc96d89d7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/inkbox/apis/inkbox-api/changes/api/v1/identities/:agent_handle/domain-affiliation/get.md)

---

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