---
title: "Domains about to be released"
method: GET
path: "/v1/domains/expiring"
---

# Domains about to be released

`GET /v1/domains/expiring`

## Request

- Base URL: `https://api.aleva.se`
- URL: `https://api.aleva.se/v1/domains/expiring`
- Auth: one of:
  - none
  - HTTP bearer
  - API key in header `X-API-Key`

## Query parameters

- `tld` string
- `tld.in` string
- `release_at` string, date
- `release_at.gte` string, date
- `release_at.lte` string, date
- `label_length` integer
- `label_length.lte` integer
- `limit` integer
- `cursor` string

## Response `200`

OK

- object
  - `_meta` Meta, required
    - `attribution` string
    - `build_run_id` integer
    - `built_at` string, date-time
    - `endpoint` string
    - `fetched_at` string, date-time
    - `licenses` string[]
    - `sources` object[]
    - `usage_mode` string
    - `version` integer
  - `data` object[], required
    - `days_left` integer: Days from the list's date to the release date
    - `domain` string
    - `in_zone` boolean: Still delegated in the latest zone snapshot
    - `label_length` integer: Characters before the dot
    - `release_at` string, date: Day it can be registered again (from 04:00 UTC), unless renewed first
    - `tld` string
  - `next_cursor` string: Present when there are more rows

## Other responses

- `400`: Invalid parameters
- `401`: Missing or invalid API key
- `404`: Not found
- `429`: Rate limit reached

---

[API](https://skmtc.dev/aleva/apis/aleva-api.md) · [All operations](https://skmtc.dev/aleva/apis/aleva-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aleva/apis/aleva-api/revisions/2edd15ebc4c9?raw)