# Appraise name

`POST https://api.unique.domains/v1/names/{name}/appraise`

Runs the appraisal of one stored name when its estimate is missing, and returns the value resource.

A fresh estimate answers 200 with `Appraisal=0` and no run. A run this call started answers 200 with `Appraisal=1`; a run another call holds answers 202 with `Retry-After: 30` and `Appraisal=0`, and a run another call finished meanwhile 200 with `Appraisal=0`. The name must be stored: run `POST /names/{name}/check` first. 5,000 runs a UTC day for the whole API.

- Access: A member key (Founder or Investor) or a paid RapidAPI subscription to this API.
- Billing: One call, plus one appraisal when the appraisal runs.
- Plan: Investor plan. A Founder key answers 403 `plan_required`.
- Formats: JSON
- API: Domain Check API

## Request

| Field | Type | Needs | Where | Description |
| --- | --- | --- | --- | --- |
| `name` | string | Required | Path | A full domain name on an ending the catalog holds, lowercased, IDN as punycode. A bare word, a subdomain, an e-mail address or an unknown ending answers 400 `validation_failed` with `reason` and `suggestion`. |
| `fields` | string | Optional | Query | Comma-separated top-level keys to keep; an unknown key answers 400 `unsupported_field`. |

## Sample request

```bash
curl -X POST "https://api.unique.domains/v1/names/get.plumbing/appraise" \
  -H "Authorization: Bearer YOUR_MEMBER_KEY"
```

## Response

| Field | Type | Description |
| --- | --- | --- |
| `current` | object \| null |  |
| `history` | object[] |  |

## Errors

| Code | Status | What it means |
| --- | --- | --- |
| [`validation_failed`](https://unique.domains/api/problems/validation_failed) | 400 | A value is not valid |
| [`keyed_only`](https://unique.domains/api/problems/keyed_only) | 403 | A paid subscription is required |
| [`not_found`](https://unique.domains/api/problems/not_found) | 404 | Not found |
| [`budget_spent`](https://unique.domains/api/problems/budget_spent) | 429 | Today's budget is spent |
| [`rate_limited`](https://unique.domains/api/problems/rate_limited) | 429 | Too many requests |
| [`internal`](https://unique.domains/api/problems/internal) | 500 | Unexpected error |
| [`check_unavailable`](https://unique.domains/api/problems/check_unavailable) | 503 | The live check is unavailable |

## Example answer

200, application/json

```json
{
  "data": {
    "current": {
      "value": 4200,
      "asOf": "2026-10-30T11:02:00.000Z"
    },
    "history": [
      {
        "value": 4200,
        "date": "2026-10-30T11:02:00.000Z"
      }
    ]
  },
  "meta": {
    "asOf": "2026-11-05T08:00:00Z",
    "cursor": null,
    "limit": null
  },
  "links": {
    "self": "https://api.unique.domains/v1/names/get.plumbing/appraise",
    "next": null,
    "register": null,
    "product": null,
    "dataset": null
  }
}
```

API status: https://uniquedomains.instatus.com

Full reference: https://unique.domains/api