---
title: "Refresh a website"
method: POST
path: "/v1/domains/{id}/refresh"
tags: ["Domains"]
---

# Refresh a website

`POST /v1/domains/{id}/refresh`

## Request

- Base URL: `https://api.upcheck.so`
- URL: `https://api.upcheck.so/v1/domains/{id}/refresh`
- Auth: HTTP bearer

Probes every check on the website now and returns the updated row. A check that takes longer than the request allows is finished by the scheduler within a minute.

## Path parameters

- `id` string, required

## Response `200`

The website after the probes.

- object: A monitored website with the latest state of its certificate and registration.
  - `id` string, required: Opaque identifier.
  - `organizationId` string, required: Opaque identifier.
  - `domain` string, required
  - `friendlyName` string, nullable, required
  - `hostname` string, required
  - `certificateStatus` 'checking' | 'healthy' | 'expiring_soon' | 'expired' | 'invalid' | 'unreachable', required
  - `certificateIssuer` string, required
  - `certificateExpiresAt` number, required: Unix ms.
  - `certificateDaysRemaining` number, required
  - `certificateLastChecked` number, required
  - `certificateNextCheck` number, required
  - `certificateAutoRenew` boolean, nullable, required
  - `certificate` object, required
    - `issuer` string, required
    - `commonName` string, required
    - `subjectAlternativeNames` string[], required
    - `serialNumber` string, required
    - `signatureAlgorithm` string, required
    - `publicKeyType` string, required
    - `publicKeySize` number, required
    - `validFrom` number, required: Unix ms.
    - `expirationDate` number, required: Unix ms.
    - `fingerprintSha256` string, required
    - `sslVersion` string, required
    - `chain` object[], required
      - `commonName` string, required
      - `issuer` string, required
      - `type` 'leaf' | 'intermediate' | 'root', required
  - `certificateLastError` string, nullable, required
  - `registrationStatus` 'checking' | 'healthy' | 'expiring_soon' | 'expired' | 'at_risk' | 'unsupported' | 'lookup_failed', nullable, required
  - `registrar` string, required
  - `registrationExpiresAt` number, required
  - `registrationDaysRemaining` number, required
  - `registration` object, nullable, required
    - `registrableDomain` string, required
    - `registrar` string, required
    - `registrarUrl` string
    - `createdAt` number, required
    - `expiresAt` number, required: Unix ms. 0 when the registry publishes no expiry.
    - `updatedAt` number, required
    - `statuses` string[], required
    - `nameservers` string[], required
    - `source` string, required
  - `registrationLastChecked` number, nullable, required
  - `registrationNextCheck` number, nullable, required
  - `registrationLastError` string, nullable, required

## Other responses

- `400`: Validation Error
- `401`: The API key is missing, invalid, or revoked.
- `404`: No such resource in this organization.
- `429`: The key's rate limit was exceeded. Honour `Retry-After`.

---

[API](https://skmtc.dev/upcheck/apis/upcheck-api.md) · [All operations](https://skmtc.dev/upcheck/apis/upcheck-api/llms.txt) · [OpenAPI document](https://skmtc.dev/upcheck/apis/upcheck-api/revisions/56f55512eb8a?raw)