---
title: "Look up a subdomain"
method: GET
path: "/subdomains/v1/{name}"
tags: ["Subdomains"]
---

# Look up a subdomain

`GET /subdomains/v1/{name}`

## Request

- Base URL: `https://api.run402.com`
- URL: `https://api.run402.com/subdomains/v1/{name}`
- Auth: none declared

Public lookup — no auth required.

## Path parameters

- `name` string, required

## Response `200`

Subdomain details

- Subdomain
  - `name` string
  - `deployment_id` string
  - `release_id` string, nullable: On a claim response: the release the bound deployment belongs to, when the target was resolved from a release, an operation, or the live release.
  - `resolved_from` 'deployment_id' | 'release_id' | 'operation_id' | 'live_release' | 'latest_deployment', nullable: On a claim response: how the bound deployment was chosen.
  - `url` string, uri
  - `deployment_url` string, uri
  - `project_id` string: Run402 project ID. Public IDs are not UUIDs.
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `404`: Subdomain not found

---

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