---
title: "Check what a customer's own domain currently answers."
method: GET
path: "/domains/check"
tags: ["Agents"]
---

# Check what a customer's own domain currently answers.

`GET /domains/check`

## Request

- Base URL: `https://agentspodium.com/api`
- URL: `https://agentspodium.com/api/domains/check`
- Auth: HTTP bearer

Call as the owner types their domain to confirm DNS points at the platform (and, once it does, that HTTPS works) before setting it as an agent's `domain`.

## Query parameters

- `domain` string, required
- `https` string

## Response `200`

OK.

- DomainCheck
  - `domain` string, required
  - `expectedIp` string, required: The address the customer's A record has to carry.
  - `dns` object, required
    - `status` 'ok' | 'unresolved' | 'elsewhere', required
    - `addresses` string[], required
  - `https` object, required
    - `status` 'ok' | 'error' | 'skipped', required: skipped when DNS does not point here yet, or when the caller did not ask for the HTTPS probe.

## Other responses

- `400`: Bad request — the body failed validation.
- `401`: Missing, invalid, expired, or revoked credential.

---

[API](https://skmtc.dev/defispace/apis/agentspodium-account-api-agent-facing-subset.md) · [All operations](https://skmtc.dev/defispace/apis/agentspodium-account-api-agent-facing-subset/llms.txt) · [OpenAPI document](https://skmtc.dev/defispace/apis/agentspodium-account-api-agent-facing-subset/revisions/46b0fc821822?raw)