Hoppa till innehållet

List the inbound domains

GET/v1/inbound/domains

TypeScript sendora.inboundDomains.list()

Python sendora.inbound_domains.list()

Key sk_… a server key

Responses

200Every inbound domain of the server.

  • domainsarray of objectrequired
    • inboundDomainIdstring (uuid)required
    • streamIdstring (uuid)required

      The inbound stream the domain delivers to.

    • domainstringrequired

      The domain, lower-cased and IDNA-encoded.

    • verifiedbooleanrequired

      True while both records are seen; only then is mail to the domain accepted.

    • createdAtstring (date-time)required
    • lastCheckedAtstring (date-time) or nullrequired

      When the records were last looked up.

    • unverifiedAtstring (date-time) or nullrequired

      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.

    • mxobjectrequired

      The MX record that brings the domain’s mail to Sendora, at any priority.

      • type"MX"required
      • hoststringrequired

        The name to create the record under.

      • valuestringrequired

        The value the record must hold.

      • verifiedbooleanrequired
      • verifiedAtstring (date-time) or nullrequired
    • txtobjectrequired

      The TXT record that proves the claim; it carries a value only you were shown.

      • type"TXT"required
      • hoststringrequired

        The name to create the record under.

      • valuestringrequired

        The value the record must hold.

      • verifiedbooleanrequired
      • verifiedAtstring (date-time) or nullrequired
Example (27 lines)
{
  "domains": [
    {
      "inboundDomainId": "6c2a9e1d-3f4b-4a8c-9d0e-1b2c3d4e5f60",
      "streamId": "b7d2e4f6-1a3c-4d5e-9f80-2c4e6a8b0d1f",
      "domain": "post.example.se",
      "verified": false,
      "createdAt": "2026-09-19T09:00:00.000Z",
      "lastCheckedAt": null,
      "unverifiedAt": null,
      "mx": {
        "type": "MX",
        "host": "post.example.se",
        "value": "10 inbound.sendora.se.",
        "verified": false,
        "verifiedAt": null
      },
      "txt": {
        "type": "TXT",
        "host": "_sendora-inbound.post.example.se",
        "value": "sendora-inbound=7f3a9c2e5b1d4f6a8c0e2b4d6f8a1c3e",
        "verified": false,
        "verifiedAt": null
      }
    }
  ]
}

Errors

Every error answers error, the code, and message, a sentence for a person. A code that adds fields is shown in full below the table.

CodeStatusMeaning
unauthorized401The key is missing, malformed or revoked.
wrong_token_kind403The key is of the other kind: a server key (sk_) where an account key (ak_) is needed, or the reverse. The message names the kind the operation takes.