# Domains awaiting their dossier

`GET /v1/domains/pending` · scope `domains:registrant`

Paid domains that could not be registered yet because the registrant details or dossier (eKYC, declaration) are incomplete, with what is left to do (`actions`) and `ready` while Tino registers them. Requires the `domains:registrant` scope: only personal API tokens with an IP restriction. Guide: [Domain registrant dossier](/en/docs/domain-registrant).

## HTTP request

| Item | Value |
| --- | --- |
| URL | `https://api.tino.vn/v1/domains/pending` |
| Method | `GET` |
| Scope | `domains:registrant` |
| Header | `Authorization: Bearer <token>` |
| Content-Type | — (no body) |
| Tokens that can call it | personal API tokens (`tinopat_`) with an IP allow-list only |

## Parameters

This route takes no parameters.

## Example request

```bash
curl "https://api.tino.vn/v1/domains/pending" \
  -H "Authorization: Bearer $TINO_TOKEN"
```

`$TINO_TOKEN` is a token with the scope `domains:registrant`.

SDK ([SDK & examples](/en/docs/sdk)): no dedicated function yet, use `client.request("GET", "/domains/pending")`.

## Example response

No live sample: the route changes real data or the test account has no data for it. The answer is a JSON object; errors follow the common shape in [Calling the Tino API](/en/docs/api#errors).
