Get your domain

GET

https://api.hmsovereign.com/api/v1/domains

Domains

Last modified:2026-01-30 13:43:45

Maintainer:Jesper Rietbergen

Retrieve your organization's configured email domain from Resend. Requires a Resend API key to be configured via BYOK (Bring Your Own Key). Returns null if no domain is configured.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Responses

🟢200

application/json

Domain information

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.hmsovereign.com/api/v1/domains' \
--header 'Authorization: Bearer <token>'

Response Example

{
    "domain": {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "domain_name": "notifications.example.com",
        "resend_domain_id": "string",
        "status": "not_started",
        "region": "eu-west-1",
        "records": [
            {
                "type": "TXT",
                "name": "string",
                "value": "string",
                "record": "string",
                "ttl": "string",
                "status": "string",
                "priority": 0
            }
        ],
        "created_at": "2019-08-24T14:15:22.123Z",
        "updated_at": "2019-08-24T14:15:22.123Z",
        "verified_at": "2019-08-24T14:15:22.123Z"
    }
}

Modified at 2026-01-30 13:43:45

Get BYOK provider configurations

Add a domain