---
title: "Get my codes"
method: POST
path: "/api/v4/main-account/codes/my"
tags: ["Codes"]
---

# Get my codes

`POST /api/v4/main-account/codes/my`

The endpoint retrieves the list of [WhiteBIT codes](/glossary#whitebit-codes) created by my account.

<Warning>
Rate limit: 1000 requests/10 sec.
</Warning>

<Note>
The API does not cache the response.
</Note>

<Note>
Results are sorted by creation date, newest first. Pagination is capped at `offset + limit ≤ 10000`; for a complete history export beyond the cap, use the Report on the History page.
</Note>

## Request body

- object
  - `limit` integer — LIMIT is a special clause used to limit records a particular query can return.
  - `offset` integer — Use the OFFSET clause to return entries starting from a particular line.
  - `request` string, required — Request signature
  - `nonce` integer, required — Unique request identifier

## Response `201`

All validations succeeded and creating transaction is started

- object
  - `total` integer — Total number of codes
  - `data` CodeInfo[]
    - `amount` string — Code amount
    - `code` string — WhiteBIT code
    - `date` integer — Code creation timestamp
    - `status` string — Code status
    - `ticker` string — Code [ticker](/glossary#ticker)
    - `external_id` string — Code external identifier
  - `limit` integer
  - `offset` integer

## Other responses

- `400` — Request validation failed
- `422` — Inner validation failed

---

[API](https://skmtc.net/whitebit/apis/whitebit-private-http-api-v4.md) · [All operations](https://skmtc.net/whitebit/apis/whitebit-private-http-api-v4/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/whitebit/whitebit-private-http-api-v4/revisions/76c9def9942f/schema)