---
title: "Changes to Claim a referral code"
method: POST
path: "/v1/referral/claim"
---

# Changes to Claim a referral code

`POST /v1/referral/claim`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 5 revisions.

- **2026-08-25** `63e8937ff6f7`: 1 info
- **2026-06-07** `dc14c1586dfa`: 6 breaking, 13 info
- **2026-03-15** `b29881d08c78`: 1 info

## Changes

- **2026-08-25** `63e8937ff6f7`: 1 info
  - added the non-success response with the status `413`
- **2026-06-07** `dc14c1586dfa`: 6 breaking, 13 info
  - added `#/components/schemas/EIP712AuthIntent` to the `data/intent` request property `allOf` list
  - removed the enum value `0.00` of the request property `data/intent`
  - removed the enum value `1.00` of the request property `data/intent`
  - removed the enum value `2.00` of the request property `data/intent`
  - removed the enum value `3.00` of the request property `data/intent`
  - the `data/intent` request property type changed from `number` to no type
  - the `error` response's property default value `Bad Request` was removed for the status `400`
  - the `error` response's property default value `Forbidden` was removed for the status `403`
  - the `error` response's property default value `Not Found` was removed for the status `404`
  - the `error` response's property default value `Too Many Requests` was removed for the status `429`
  - the `error` response's property default value `Unauthorized` was removed for the status `401`
  - the `error` response's property default value `Unprocessable Entity` was removed for the status `422`
  - the `statusCode` response's property default value `400` was removed for the status `400`
  - the `statusCode` response's property default value `401` was removed for the status `401`
  - the `statusCode` response's property default value `403` was removed for the status `403`
  - the `statusCode` response's property default value `404` was removed for the status `404`
  - the `statusCode` response's property default value `422` was removed for the status `422`
  - the `statusCode` response's property default value `429` was removed for the status `429`
  - response property `message` list-of-types was narrowed by removing types `array` from media type `application/json` of response `400`
- **2026-03-15** `b29881d08c78`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/ethereal/apis/ethereal-exchange-api/docs/v1/referral/claim/post.md) - [API](https://skmtc.dev/ethereal/apis/ethereal-exchange-api.md) - [Page](https://skmtc.dev/ethereal/apis/ethereal-exchange-api/changes/v1/referral/claim/post)