---
title: "Get project-scoped Cloudflare DNS authorization status"
method: GET
path: "/v1/projects/{project_id}/cloudflare-dns"
---

# Get project-scoped Cloudflare DNS authorization status

`GET /v1/projects/{project_id}/cloudflare-dns`

## Request

- Base URL: `https://app.ohmyho.st`
- URL: `https://app.ohmyho.st/v1/projects/{project_id}/cloudflare-dns`
- Auth: HTTP bearer

Returns only the fixed zone, closed scope set, expiry, and authorization state; provider credentials are never exposed.

## Path parameters

- `project_id` string, required

## Headers

- `X-Request-Id` string

## Response `200`

The current credential-free Cloudflare DNS authorization status.

- CloudflareDnsAuthorizationStatus: Credential-free project authorization state. Without an authorization, status is not_authorized, zone and expires_at are null, and scopes is empty. All other states name the actual customer zone; no platform or customer zone is inferred.
  - `status` 'not_authorized' | 'pending' | 'authorized' | 'expired' | 'revoked', required
  - `zone` string, nullable, required
  - `scopes` string[], required
  - `expires_at` string, date-time, nullable, required

## Other responses

- `400`: The request failed.
- `401`: The request failed.
- `403`: The request failed.
- `404`: The resource does not exist or is not visible to the authenticated principal.
- `429`: The request failed.
- `503`: The request failed.

---

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