---
title: "Roles Endpoint"
method: POST
path: "/v1/roles"
tags: ["Account Administration"]
---

# Roles Endpoint

`POST /v1/roles`

## Request

- Base URL: `https://api.gemini.com`
- URL: `https://api.gemini.com/v1/roles`
- Auth: API key in header `X-GEMINI-APIKEY` and API key in header `X-GEMINI-SIGNATURE` and API key in header `X-GEMINI-PAYLOAD`

The `v1/roles` endpoint will return a string of the role of the current API key. The response fields will be different for account-level and master-level API keys.

## Headers

- `X-GEMINI-APIKEY` string, required
- `X-GEMINI-SIGNATURE` string, required
- `X-GEMINI-PAYLOAD` string, required
- `Content-Type` string
- `Content-Length` string
- `Cache-Control` string

## Request body

- object
  - `request` string, required: The literal string "/v1/roles"
  - `nonce` union, required: timestamp
    - string: Gemini strongly recommends using milliseconds instead of seconds for timestamps. | Timestamp format | Example | Supported request type | |-----------------------|-----------------------|------------------------| | string (seconds) | `1495127793` | `POST` only | | string (milliseconds) | `1495127793000` | `POST` only |
    - integer: Gemini strongly recommends using milliseconds instead of seconds for timestamps. | Timestamp format | Example | Supported request type | |-----------------------------|---------------------------|------------------------| | whole number (seconds) | `1495127793` | `GET`, `POST` | | whole number (milliseconds) | `1495127793000` | `GET`, `POST` |

## Response `200`

The response will be a JSON object indicating the assigned roles to the set of API keys used to call `/v1/roles`. The `Auditor` role cannot be combined with other roles. `Fund Manager` and `Trader` can be combined.

- RoleResponse
  - `isAuditor` boolean, required: `True` if the Auditor role is assigned to the API keys. `False` otherwise.
  - `isFundManager` boolean, required: `True` if the Fund Manager role is assigned to the API keys. `False` otherwise.
  - `isTrader` boolean, required: `True` if the Trader role is assigned to the API keys. `False` otherwise.
  - `counterparty_id` string: _Only returned for master-level API keys_. The Gemini clearing counterparty ID associated with the API key making the request.
  - `isAccountAdmin` boolean: _Only returned for master-level API keys_.`True` if the Administrator role is assigned to the API keys. `False` otherwise.

---

[API](https://skmtc.dev/gemini/apis/rest-api.md) - [All operations](https://skmtc.dev/gemini/apis/rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gemini/apis/rest-api/revisions/24979792d748?raw)