Skip to content
Kirim.Email SMTP API

Get domain details

GET
/api/domains/{domain}

Retrieve details of a specific domain

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
domain
required
string
Example
example.com

Domain name that must be owned by the authenticated user. The domain must be verified and properly configured for email sending.

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Successfully retrieved domain details including verification status and configuration

object
success

Indicates if the request was successful

boolean
Example
true
data

Domain object containing email domain configuration and verification status

object
id

Unique identifier for the domain

integer
Example
1
domain

Domain name used for sending emails

string
Example
example.com
tracklink_domain

Custom tracking domain for click and open tracking

string
tracklink_domain_is_verified

Whether the tracking domain has been verified

boolean
auth_domain_is_verified

Whether the authentication domain has been verified

boolean
dns_selector

DKIM selector used for DNS verification

string
Example
k1
dns_record

DKIM public key record that should be configured in DNS

string
Example
v=DKIM1; k=rsa; p=MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDjF2J8K5xqH7N8Z9L2zQ3bX9Y1tW7vU6kR5aP4sT8nB3mV7cZ2jX5L8oR9pN3tQ1wE4vY6bF2aC8hI7gD5eJ9kL3mX8oQ6bH2nV5pZ9cR8tW7yB4mX6qN5zL3oV8cF2tH9nB5pQ7eZ1mX8sT6kR4vY9bH3mC8qI7gL5nX2oW9zF5pD8eB7hR3mX6yV9cQ2tK4nB5pL1mX8sT6kR9vY9bH3mC8qI7gL5nX2oW9zF5pD8eB7hR3mX6yV9cQ2tK4nB5pL1mX8sT6kR9vY9bH3mC8qI7gL5nX2oW9zF5pD8eB7hR3mX6yV9cQIDAQAB
click_track

Whether click tracking is enabled for emails sent from this domain

boolean
open_track

Whether open tracking is enabled for emails sent from this domain

boolean
unsub_track

Whether unsubscribe tracking is enabled for emails sent from this domain

boolean
is_verified

Whether the domain has been verified for email sending

boolean
status

Domain status (active/inactive)

boolean
Example
true
created_at

Unix timestamp when the domain was created

integer
Example
1762810896
modified_at

Unix timestamp when the domain was last modified

integer
Example
1762810896
spf_record

Expected SPF record value that should be configured in DNS

string
Example
v=spf1 mx include:spf.kirim.email ~all

401

Section titled “401 ”

Unauthorized

object
error

Error type indicating authentication failure

string
Example
Unauthorized
message

Human-readable error message explaining the authentication issue

string
Example
Authorization header is required

404

Section titled “404 ”

Domain not found

object
success
boolean
message
string
Example
Domain not found

429

Section titled “429 ”

Too Many Requests - Rate limit exceeded. Retry after the specified time.

object
success
boolean
message
string
Example
Too many attempts. Please try again later.

Headers

Section titled “Headers ”
Retry-After
integer

Seconds until rate limit resets

X-RateLimit-Limit
integer

Maximum requests per minute

X-RateLimit-Remaining
integer

Remaining requests in current window