---
title: "Retrieve user key"
method: POST
path: "/v2/user-key"
tags: ["auth"]
---

# Retrieve user key

`POST /v2/user-key`

This endpoint allows partners to get an authentication key by providing username and password.

## Response `200`

Authentication key successfully retrieved.

- V2GetUserKeyResponse
  - `userKey` string — The unique authentication key that enables secure access.
  - `userId` string — The userId of the user.

## Other responses

- `400` — There was a problem with input.
- `401` — Login failed or token not valid.
- `403` — Access denied due to insufficient permissions.
- `default` — An unexpected error response.

---

[API](https://skmtc.net/citrusad/apis/citrus-auth-api.md) · [All operations](https://skmtc.net/citrusad/apis/citrus-auth-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/citrusad/citrus-auth-api/revisions/a040003c7378/schema)