---
title: "TLD allowlist for domain verification"
method: GET
path: "/api/agents/domain-tlds"
tags: ["agents"]
---

# TLD allowlist for domain verification

`GET /api/agents/domain-tlds`

## Request

- Base URL: `https://api.depixapp.com`
- URL: `https://api.depixapp.com/api/agents/domain-tlds`
- Auth: none required

Public discovery of the TLDs POST /api/agents/verify-domain accepts — avoids trial-and-error 422s.

## Response `200`

The current allowlist.

- DomainTldsResponse: The current TLD allowlist for domain verification — discover what verify-domain accepts without trial-and-error.
  - `allowed_tlds` string[], required: Accepted TLD suffixes (leading dot), e.g. ".com", ".com.br". A domain whose suffix is not listed is rejected with domain_tld_not_allowed.

## Other responses

- `429`: Rate limited (per-IP, per-key or per-merchant window). Retry after `retry_after` seconds (also in the Retry-After header).

---

[API](https://skmtc.dev/depixapp/apis/depix-api.md) · [All operations](https://skmtc.dev/depixapp/apis/depix-api/llms.txt) · [OpenAPI document](https://skmtc.dev/depixapp/apis/depix-api/revisions/04094536dd0f?raw)