Retrieve a project domain

Fetch the details of a single domain attached to a project.

This is useful when:

• you want to display the domain configuration in a dashboard

• you want to confirm that a domain belongs to a project

• you need to read domain flags like is_active, is_primary, or has_paid

Endpoint

GET /project/{project}/domain/{domain}

Full URL:

https://api.devpayr.dev/api/v1/project/{project}/domain/{domain}

Note: This endpoint uses /domain/{domain} (singular), while listing uses /domains (plural). This is intentional and matches the actual route definition.

Authentication

✅ Required: API Key

Send your API key using:

X-API-KEY: <your_api_key>

Path Parameters

Parameter	Type	Required	Description
project	integer	Yes	The ID of the project.
domain	integer	Yes	The ID of the project domain record to retrieve.

Access Rules

DevPayr enforces three access checks:

1) Project-scoped API key must match the project

If your API key is scoped to a project, it must match project in the URL.

Error (403)

{ "message": "This API key is not allowed to access this project." }

2) Global API key must match project ownership

If your API key is global, it must belong to the same user who owns the project.

Error (403)

{ "message": "This API key does not have permission to access this project." }

3) Domain must belong to the specified project

Even if you own the project, the domain ID must actually belong to that project.

Error (403)

{ "message": "This domain does not belong to the specified project." }

Example Request

curl -X GET "https://api.devpayr.dev/api/v1/project/2/domain/10" \
  -H "Accept: application/json" \
  -H "X-API-KEY: YOUR_API_KEY"

Response

Success (200)

On success, DevPayr returns the domain record wrapped in the standard response envelope and includes a specific message:

• message: "Domain successfully loaded."

Example Response

{
  "status": "success",
  "message": "Domain successfully loaded.",
  "data": {
    "id": 10,
    "project_id": 2,
    "domain": "example.com",
    "has_paid": true,
    "is_active": true,
    "is_primary": true,
    "created_at": "2025-12-01T10:12:00.000000Z",
    "updated_at": "2025-12-01T10:12:00.000000Z"
  },
  "errors": null
}

The response excludes internal fields such as user_id.

Caching Behavior

This endpoint caches results per API key + project + domain.

• Cache TTL: 15 minutes

• Cache key includes:

  • API key ID

  • project ID

  • domain ID

This improves repeated reads from dashboards or admin tools.

Errors

Missing API Key (401)

{ "message": "Missing required X-API-KEY header." }

Invalid / Expired API Key (403)

{ "message": "Invalid or expired API key." }

Unauthorized (403)

Project-scoped mismatch:

{ "message": "This API key is not allowed to access this project." }

Global key not owner:

{ "message": "This API key does not have permission to access this project." }

Domain not tied to project:

{ "message": "This domain does not belong to the specified project." }

Project or Domain Not Found (404)

{ "message": "Resource not found." }

Rate Limited (429)

{ "message": "Rate limit exceeded (X requests/min). Please slow down." }