---
title: "Retrieves API tokens that are about to expire"
method: GET
path: "/api/v1/apitoken/expiring"
tags: ["API Token"]
---

# Retrieves API tokens that are about to expire

`GET /api/v1/apitoken/expiring`

## Request

- Base URL: `https://docs.anzworldline-solutions.com.au`
- URL: `https://docs.anzworldline-solutions.com.au/api/v1/apitoken/expiring`
- Auth: none declared
- TypeScript: <https://skmtc.dev/anzworldline-solutions/apis/dotcms-rest-api/docs/api/v1/apitoken/expiring/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a list of API tokens that will expire within the configured number of days.

For admin users, returns all expiring tokens from all users.
For limited users, returns only their own expiring tokens.

The number of days to look ahead can be configured via the EXPIRING_TOKEN_LOOKAHEAD_DAYS property (default: 7).

## Response `200`

Expiring API tokens successfully retrieved

## Other responses

- `401`: Invalid user
- `403`: Forbidden
- `500`: Unexpected server error

## Changes

- **2026-10-30** `4fd8e917d458`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/anzworldline-solutions/apis/dotcms-rest-api/changes/api/v1/apitoken/expiring/get.md)

---

[API](https://skmtc.dev/anzworldline-solutions/apis/dotcms-rest-api.md) - [All operations](https://skmtc.dev/anzworldline-solutions/apis/dotcms-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/anzworldline-solutions/apis/dotcms-rest-api/revisions/4fd8e917d458?raw)