---
title: "GET /users/{userId}/referral-acquisition-history"
method: GET
path: "/users/{userId}/referral-acquisition-history"
tags: ["Referrals"]
---

# GET /users/{userId}/referral-acquisition-history

`GET /users/{userId}/referral-acquisition-history`

## Request

- Base URL: `/v1r` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/v1r/users/{userId}/referral-acquisition-history`
- Auth: none declared. Required headers: `Authorization`

Returns the history of referral acquisition for the provided user id.

## Path parameters

- `userId` string, required

## Query parameters

- `days` integer

## Headers

- `Authorization` string, required
- `X-Account-Metadata` string

## Response `200`

OK

- UsersReferralAcquisition[]
  - `date` string
  - `t1` integer
  - `t2` integer

## Other responses

- `400`: if validations fail
- `401`: if not authorized
- `403`: if not allowed
- `422`: if syntax fails
- `500`: Internal Server Error
- `504`: if request times out

## Changes

- **2023-07-03** `452e8c907d2e`: 1 info
  - added the new optional `header` request parameter `X-Account-Metadata`
- **2023-03-23** `b8bf8339e1f6`: 1 warning
  - deleted the `header` request parameter `X-Account-Metadata`

[Operation history](https://skmtc.dev/ice-blockchain/apis/user-accounts-user-devices-user-statistics-api/changes/users/:userId/referral-acquisition-history/get.md)

---

[API](https://skmtc.dev/ice-blockchain/apis/user-accounts-user-devices-user-statistics-api.md) - [All operations](https://skmtc.dev/ice-blockchain/apis/user-accounts-user-devices-user-statistics-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ice-blockchain/apis/user-accounts-user-devices-user-statistics-api/revisions/34d6aba6606c?raw)
