GET
/
api
/
v2
/
domains
/
{id}
curl -X GET 'https://inbound.new/api/v2/domains/dom_abc123' \
  -H 'Authorization: Bearer YOUR_API_KEY'

{
  "id": "dom_abc123",
  "domain": "example.com",
  "status": "verified",
  "canReceiveEmails": true,
  "hasMxRecords": true,
  "domainProvider": "Cloudflare",
  "providerConfidence": "high",
  "lastDnsCheck": "2024-01-15T10:30:00Z",
  "lastSesCheck": "2024-01-15T10:30:00Z",
  "isCatchAllEnabled": true,
  "catchAllEndpointId": "end_xyz789",
  "createdAt": "2024-01-01T00:00:00Z",
  "updatedAt": "2024-01-15T10:30:00Z",
  "userId": "user_123",
  "stats": {
    "totalEmailAddresses": 5,
    "activeEmailAddresses": 4,
    "emailsLast24h": 12,
    "emailsLast7d": 89,
    "emailsLast30d": 345
  },
  "catchAllEndpoint": {
    "id": "end_xyz789",
    "name": "Main Webhook",
    "type": "webhook",
    "isActive": true
  },
  "verificationCheck": {
    "dnsRecords": [
      {
        "type": "TXT",
        "name": "_amazonses.example.com",
        "value": "abc123def456ghi789",
        "isVerified": true
      },
      {
        "type": "MX",
        "name": "example.com", 
        "value": "10 inbound-smtp.us-east-1.amazonaws.com",
        "isVerified": true
      }
    ],
    "sesStatus": "Success",
    "isFullyVerified": true,
    "lastChecked": "2024-01-15T10:30:00Z"
  }
}

​
Overview

This endpoint retrieves comprehensive information about a specific domain, including statistics, configuration, and optional real-time verification status.

​
Authentication

​
Authorization
string
required
Bearer token for API authentication. Format: Bearer YOUR_API_KEY

​
Parameters

​
id
string
required
The unique identifier of the domain to retrieve.
​
check
string
Perform real-time DNS and SES verification checks. Set to true to include current verification status in response. This may slow down the response but provides live verification results.

​
Response

​
id
string
required
Unique identifier for the domain.
​
domain
string
required
The domain name (e.g., “example.com”).
​
status
string
required
Current verification status: pending, verified, or failed.
​
canReceiveEmails
boolean
required
Whether the domain is configured to receive emails.
​
hasMxRecords
boolean
required
Whether the domain has valid MX records configured.
​
domainProvider
string | null
Detected domain provider (e.g., “Cloudflare”, “GoDaddy”).
​
providerConfidence
string | null
Confidence level of provider detection: high, medium, low.
​
lastDnsCheck
string | null
ISO 8601 timestamp of the last DNS verification check.
​
lastSesCheck
string | null
ISO 8601 timestamp of the last AWS SES verification check.
​
isCatchAllEnabled
boolean
required
Whether catch-all email forwarding is enabled for this domain.
​
catchAllEndpointId
string | null
ID of the endpoint used for catch-all email forwarding.
​
createdAt
string
required
ISO 8601 timestamp when the domain was added.
​
updatedAt
string
required
ISO 8601 timestamp when the domain was last updated.
​
userId
string
required
ID of the user who owns this domain.
​
stats
object
required
Detailed domain statistics and usage information.
​
catchAllEndpoint
object | null
Information about the catch-all endpoint (if configured).
​
verificationCheck
object
Real-time verification status (only included when check=true parameter is used).

​
Examples

​
Basic Request

curl -X GET 'https://inbound.new/api/v2/domains/dom_abc123' \
  -H 'Authorization: Bearer YOUR_API_KEY'

​
Request with Verification Check

curl -X GET 'https://inbound.new/api/v2/domains/dom_abc123?check=true' \
  -H 'Authorization: Bearer YOUR_API_KEY'

​
Response (with Verification Check)

{
  "id": "dom_abc123",
  "domain": "example.com",
  "status": "verified",
  "canReceiveEmails": true,
  "hasMxRecords": true,
  "domainProvider": "Cloudflare",
  "providerConfidence": "high",
  "lastDnsCheck": "2024-01-15T10:30:00Z",
  "lastSesCheck": "2024-01-15T10:30:00Z",
  "isCatchAllEnabled": true,
  "catchAllEndpointId": "end_xyz789",
  "createdAt": "2024-01-01T00:00:00Z",
  "updatedAt": "2024-01-15T10:30:00Z",
  "userId": "user_123",
  "stats": {
    "totalEmailAddresses": 5,
    "activeEmailAddresses": 4,
    "emailsLast24h": 12,
    "emailsLast7d": 89,
    "emailsLast30d": 345
  },
  "catchAllEndpoint": {
    "id": "end_xyz789",
    "name": "Main Webhook",
    "type": "webhook",
    "isActive": true
  },
  "verificationCheck": {
    "dnsRecords": [
      {
        "type": "TXT",
        "name": "_amazonses.example.com",
        "value": "abc123def456ghi789",
        "isVerified": true
      },
      {
        "type": "MX",
        "name": "example.com", 
        "value": "10 inbound-smtp.us-east-1.amazonaws.com",
        "isVerified": true
      }
    ],
    "sesStatus": "Success",
    "isFullyVerified": true,
    "lastChecked": "2024-01-15T10:30:00Z"
  }
}

​
Error Responses

{
  "error": "Domain not found"
}

​
Important Notes

The check=true parameter performs real-time DNS and SES verification checks, which may slow down the response but provides the most current verification status.
Use the check=true parameter when you need to verify the current status of a domain, especially after making DNS changes or when troubleshooting verification issues.
The verificationCheck field is only included when check=true is specified. This parameter may increase response time as it performs live DNS lookups and AWS SES API calls.

​
Notes

  • The catchAllEndpoint field is only populated when isCatchAllEnabled is true and a valid endpoint is configured
  • Email statistics are calculated in real-time and may take a moment to update after configuration changes
  • Only verified domains can receive emails and will have meaningful statistics
  • When check=true is used, the domain status may be automatically updated based on current SES verification status