---
title: "Check whether an alias is available"
method: POST
path: "/api/v1/alias/check"
tags: ["Aliases"]
---

# Check whether an alias is available

`POST /api/v1/alias/check`

## Request

- Base URL: `https://workers.miniurl.com`
- URL: `https://workers.miniurl.com/api/v1/alias/check`
- Auth: none required

Check alias availability on miniurl.com or a specific domain before creating a short link. No authentication required.

## Request body

- AliasCheckRequest
  - `alias` string, required: 4-64 characters on miniurl.com; 1-64 characters on a verified custom domain.
  - `domain` string

## Response `200`

Alias availability returned

- AliasCheckResponse
  - `exists` boolean, required

## Other responses

- `400`: Invalid input or malformed JSON

---

[API](https://skmtc.dev/miniurl/apis/miniurl-agent-first-api.md) · [All operations](https://skmtc.dev/miniurl/apis/miniurl-agent-first-api/llms.txt) · [OpenAPI document](https://skmtc.dev/miniurl/apis/miniurl-agent-first-api/revisions/1d12196927db?raw)