---
title: "Reads the domain of a lambda"
method: GET
path: "/lambdas/{privateKey}/domain"
tags: ["Domain"]
---

# Reads the domain of a lambda

`GET /lambdas/{privateKey}/domain`

## Request

- Base URL: `https://genhttp.dev/api/v1`
- URL: `https://genhttp.dev/api/v1/lambdas/{privateKey}/domain`
- Auth: none declared

The name servers are asked as the request is answered, for up to three seconds, and their answers may be cached for as long as the records say.

## Path parameters

- `privateKey` string, required

## Response `200`

The domain, and what it resolves to

- DomainResponse: The domain of a lambda, and whether it answers at it.
  - `Domain` string, nullable: The domain it is configured to answer at; absent without one
  - `Tier` string: The tier of the lambda, which decides whether it may have one
  - `Allowed` boolean: Whether the tier includes a domain of its own: only the premium tier does
  - `Served` boolean: Whether requests to the domain reach the lambda right now - it has one, and its tier includes it. A domain kept from a premium tier is not served.
  - `Dns` DnsResponse: What a domain resolves to, looked up by the server as the request was answered. Only the addresses - not whether they are this installation's, which is for whoever knows where it runs to compare.
    - `Addresses` string[]: Every address the domain resolved to, IPv4 and IPv6 alike
    - `Problem` string, nullable: Why nothing could be resolved, where nothing could: it does not resolve yet, or the name servers could not be asked

## Other responses

- `204`: A response containing no body
- `404`: No lambda has this editor key. A key that never existed and the key of a deleted lambda are answered alike.

---

[API](https://skmtc.dev/genhttp/apis/genhttp-lambda-api.md) · [All operations](https://skmtc.dev/genhttp/apis/genhttp-lambda-api/llms.txt) · [OpenAPI document](https://skmtc.dev/genhttp/apis/genhttp-lambda-api/revisions/8b36699e03df?raw)