# Claim a domain

`POST /api/domains` · Praecise account · Domains

Where Praecise holds the registrar for the domain, the ownership record is published and checked in the same call (`published: true`).

## Request body

`application/json`

```json
{
  "type": "object",
  "required": [
    "domain"
  ],
  "properties": {
    "domain": {
      "type": "string",
      "examples": [
        "example.com"
      ]
    }
  }
}
```

## Responses

- `201`: Claimed.
- `400`: That does not look like a domain.
- `401`: Neither a service token nor a signed-in session was accepted.
- `502`: The mail service could not be reached, or refused.
- `503`: Mail is not configured on this deployment.

## Example

```sh
curl -X POST 'https://accounts.praecise.com/api/domains' \
  -H 'Authorization: Bearer $KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "domain": "example.com"
}'
```