---
title: "List API tokens"
method: GET
path: "/api/mail/v1/api-tokens"
tags: ["Mail: API Tokens"]
---

# List API tokens

`GET /api/mail/v1/api-tokens`

Retrieve a paginated list of
[Hostinger Email API](https://api.mail.hostinger.com/) tokens across
all your mail orders, optionally filtered by order. Plaintext tokens
are never included; they are returned only when a token is created.

## Query parameters

- `order_id` string, nullable
- `page` integer
- `per_page` integer

## Response `200`

Success response

- object
  - `data` MailV1ApiTokensApiTokenResource[] — Array of [`Mail.V1.ApiTokens.ApiTokenResource`](#model/mailv1apitokensapitokenresource)
    - `id` string — Unique API token identifier
    - `order_id` string, nullable — Resource ID of the owning mail order
    - `name` string, nullable — Human-readable label for this token
    - `scope` MailV1ApiTokensApiTokenScopeResource
      - `has_all_mailboxes` boolean — Whether the token covers all current and future mailboxes of the order
      - `mailboxes` MailV1ApiTokensApiTokenMailboxResource[] — Mailboxes this token grants access to. Empty when `has_all_mailboxes` is true.
        - `id` string — Mailbox resource ID
        - `address` string
    - `created_at` string, date-time
    - `last_used_at` string, date-time, nullable — Last successful authentication using this token
    - `type` 'api_token' | 'oauth'
  - `meta` CommonSchemaPaginationMetaSchema
    - `current_page` integer
    - `per_page` integer
    - `total` integer

## Other responses

- `401` — Unauthenticated response
- `422` — Error response
- `500` — Error response

---

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