# Registrants used before

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

Registrants of the customer's running domains, newest first, one row per person / organisation, to reuse for a waiting domain (`from_domain_id`). `ready: true` means the domain can be registered right away. Requires the `domains:registrant` scope: only personal API tokens with an IP restriction.

## HTTP request

| Item | Value |
| --- | --- |
| URL | `https://api.tino.vn/v1/registrants` |
| 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/registrants" \
  -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", "/registrants")`.

## 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).