---
title: "Claim Attribution"
method: POST
path: "/api/attribution/claim"
tags: ["Access codes"]
---

# Claim Attribution

`POST /api/attribution/claim`

## Request

- Base URL: `https://api.earmarkiq.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.earmarkiq.app/api/attribution/claim`
- Auth: HTTP bearer

Record who sent this user, within 7 days of sign-up. Never unlocks
anything, whatever the batch's policy is — the app ignores the body on
purpose (Apple 3.1.1).

200 {"outcome": "recorded" | "already_recorded"}
404 invalid_code · 410 window_closed · 429 rate limited

## Request body

- AppApiCodesClaimRequest
  - `code` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-19** `4a2c41907105`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/earmarkiq/apis/earmark-api/changes/api/attribution/claim/post.md)

---

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