---
title: "Read an inbound domain"
method: GET
path: "/v1/inbound/domains/{id}"
tags: ["Inbound"]
---

# Read an inbound domain

`GET /v1/inbound/domains/{id}`

## Request

- Base URL: `https://api.sendora.se`
- URL: `https://api.sendora.se/v1/inbound/domains/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, uuid, required

## Response `200`

A domain on an inbound stream and the two records it needs.

- object: A domain on an inbound stream and the two records it needs.
  - `inboundDomainId` string, uuid, required
  - `streamId` string, uuid, required: The inbound stream the domain delivers to.
  - `domain` string, required: The domain, lower-cased and IDNA-encoded.
  - `verified` boolean, required: True while both records are seen; only then is mail to the domain accepted.
  - `createdAt` string, date-time, required
  - `lastCheckedAt` string, date-time, nullable, required: When the records were last looked up.
  - `unverifiedAt` string, date-time, nullable, required: When a verified domain lost its records. Mail to it is deferred for 72 hours from then and refused after, until the records are back.
  - `mx` object, required: The MX record that brings the domain’s mail to Sendora, at any priority.
    - `type` 'MX', required
    - `host` string, required: The name to create the record under.
    - `value` string, required: The value the record must hold.
    - `verified` boolean, required
    - `verifiedAt` string, date-time, nullable, required
  - `txt` object, required: The TXT record that proves the claim; it carries a value only you were shown.
    - `type` 'TXT', required
    - `host` string, required: The name to create the record under.
    - `value` string, required: The value the record must hold.
    - `verified` boolean, required
    - `verifiedAt` string, date-time, nullable, required

## Other responses

- `401`: The key is missing, malformed or revoked.
- `403`: The key is of the other kind, or a connected app may not do this here: it is not for connections, the connection may only read here, or it is for test servers only.
- `404`: No such inbound domain of this server.

---

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