---
title: "Record Matter Attribution"
method: POST
path: "/v1/matters/{matter_id}/attribution"
tags: ["matter-attribution"]
---

# Record Matter Attribution

`POST /v1/matters/{matter_id}/attribution`

## Request

- Base URL: `https://api.ender.au` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ender.au/v1/matters/{matter_id}/attribution`
- Auth: HTTP bearer

## Path parameters

- `matter_id` string, uuid, required

## Headers

- `Idempotency-Key` string, nullable

## Request body

- ChangeMatterAttribution
  - `referrer_id` string, uuid, nullable, required
  - `bdm_user_id` string, uuid, nullable, required
  - `effective_from` string, date, required

## Response `200`

Successful Response

- MatterAttributionResponse
  - `can_edit` boolean, required
  - `suggested_effective_from` string, date, required
  - `current` AttributionVersion, required
    - `id` string, uuid, required
    - `effective_from` string, date, required
    - `referrer` Referrer, required
      - `id` string, uuid, required
      - `name` string, required
      - `organisation` string, nullable, required
    - `bdm` AttributionPerson, required
      - `user_id` string, uuid, required
      - `name` string, nullable, required
      - `email` string, nullable, required
    - `recorded_by` AttributionPerson, required
      - `user_id` string, uuid, required
      - `name` string, nullable, required
      - `email` string, nullable, required
    - `recorded_at` string, date-time, required
  - `history` AttributionVersion[], required
    - `id` string, uuid, required
    - `effective_from` string, date, required
    - `referrer` Referrer, required
      - `id` string, uuid, required
      - `name` string, required
      - `organisation` string, nullable, required
    - `bdm` AttributionPerson, required
      - `user_id` string, uuid, required
      - `name` string, nullable, required
      - `email` string, nullable, required
    - `recorded_by` AttributionPerson, required
      - `user_id` string, uuid, required
      - `name` string, nullable, required
      - `email` string, nullable, required
    - `recorded_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ender/apis/ender-backend.md) - [All operations](https://skmtc.dev/ender/apis/ender-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/ender/apis/ender-backend/revisions/bf4373130521?raw)