Docs Monitoring Data

List Domains

List the domains your organization monitors.

GET /v1/domains monitoring.read

Returns every domain in the caller's organization with its latest monitoring snapshot — DNS/SSL status, 30-day uptime, health score, last response time, and registry/SSL expiry countdowns.

Authentication

This endpoint requires a valid API key sent as a Bearer token, and the key must carry the scope listed above. See Authentication and Scopes for details.

Query Parameters

Name Type Required Description
page int Optional 1-based page number.
pageSize int Optional Items per page (max 100).

Headers

Header Required Description
Authorization Required Bearer token — Bearer pk_live_...

Request Example

Response Example

200 OK
{
  "success": true,
  "data": {
    "items": [
      {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "host": "example.com",
        "displayName": "Marketing site",
        "environment": "Production",
        "lastResolvedIp": "93.184.216.34",
        "dnsStatus": "Healthy",
        "sslStatus": "Healthy",
        "uptime30d": 99.98,
        "lastCheckedAt": "2026-09-01T12:00:00Z",
        "lastResponseTimeMs": 128,
        "sslDaysRemaining": 62,
        "healthScore": 97,
        "inMaintenanceWindow": false,
        "domainRegistryDaysRemaining": 210,
        "publicStatusPageUrl": "https://app.paqet.io/status/example"
      }
    ],
    "page": 1,
    "pageSize": 20,
    "totalCount": 1,
    "totalPages": 1
  }
}

Error Responses

Status Code Meaning
401 API_KEY_INVALID The API key is missing, malformed, or doesn't match any active key.
401 API_KEY_REVOKED The API key was manually revoked and can never be reactivated.
401 API_KEY_EXPIRED The API key's expiration date has passed.
403 PLAN_EXPIRED Your Enterprise subscription is no longer active.
403 ENTERPRISE_REQUIRED The Public API is only available on the Enterprise plan.
403 SCOPE_REQUIRED The API key doesn't have the scope required for this endpoint.
429 RATE_LIMIT_EXCEEDED The API key has exceeded its request limit for the current window.
404 RESOURCE_NOT_FOUND The requested resource does not exist.
422 VALIDATION_ERROR One or more request parameters failed validation.
500 INTERNAL_ERROR An unexpected error occurred on Paqet's side.

Rate Limits

This endpoint counts against your API key's standard request limit. See Rate Limits for current limits, response headers, and retry guidance.

Notes

  • Requires the monitoring.read scope. Existing keys don't have it by default - add it to a key from the Developer Portal (Edit Scopes).
  • Only returns data for the organization the API key belongs to. IDs from another organization return RESOURCE_NOT_FOUND, never another org's data.
  • Monitoring reads count against a separate per-key rate-limit bucket, not the diagnostic-tool bucket - see Rate Limits.

Try this endpoint

Run it live from the Playground using your own API key.

Open Playground