> ## Documentation Index > Fetch the complete documentation index at: https://sendmux.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Verify a mailbox domain > Checks the domain's published DNS records and latest Amazon SES DKIM and MAIL FROM statuses. If every required check passes, the domain is marked verified. A previously failed domain remains failed until a complete check succeeds. Domains automatically re-verify every 6 hours — this endpoint is only needed to trigger a check on demand. ## OpenAPI ````yaml /openapi-app.json post /domains/{public_id}/verify openapi: 3.1.0 info: description: Programmatic access to your Sendmux email infrastructure. title: Sendmux API version: 1.0.0 servers: - description: API v1 url: https://app.sendmux.ai/api/v1 security: - bearerAuth: [] paths: /domains/{public_id}/verify: post: tags: - Domains summary: Verify a mailbox domain description: >- Checks the domain's published DNS records and latest Amazon SES DKIM and MAIL FROM statuses. If every required check passes, the domain is marked verified. A previously failed domain remains failed until a complete check succeeds. Domains automatically re-verify every 6 hours — this endpoint is only needed to trigger a check on demand. operationId: managementVerifyDomain parameters: - in: path name: public_id required: true schema: description: Domain public ID type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/DomainVerifyResponse' description: Verification result '404': content: application/json: schema: $ref: '#/components/schemas/ApiError' description: Domain not found '409': content: application/json: schema: $ref: '#/components/schemas/ApiError' description: The domain changed while verification was running. '500': content: application/json: schema: $ref: '#/components/schemas/ApiError' description: Unexpected server error. '503': content: application/json: schema: $ref: '#/components/schemas/ApiError' description: >- Verification is temporarily unavailable; retry after the indicated delay. headers: Retry-After: description: Seconds to wait before retrying. schema: example: 30 type: integer security: - bearerAuth: [] components: schemas: DomainVerifyResponse: allOf: - $ref: '#/components/schemas/SuccessEnvelope' - properties: data: $ref: '#/components/schemas/MailboxDomainVerifyResult' meta: $ref: '#/components/schemas/ResponseMeta' required: - data type: object unevaluatedProperties: false ApiError: additionalProperties: false properties: error: additionalProperties: false properties: code: description: Machine-readable error code enum: - invalid_parameter - missing_parameter - authentication_required - insufficient_permissions - not_found - conflict - limit_exceeded - idempotency_conflict - payload_too_large - validation_error - rate_limit_exceeded - service_unavailable - internal_error example: invalid_parameter type: string doc_url: description: Link to relevant documentation type: string errors: description: >- Accumulated per-field issues for validation errors. Only present on 400/422 responses. items: $ref: '#/components/schemas/ApiErrorDetail' type: array message: description: Human-readable error description type: string param: description: The parameter that caused the error type: string retryable: description: >- Whether the caller may safely retry this request. 4xx are typically false (except 429); 5xx are typically true. example: false type: boolean required: - code - message - retryable type: object meta: additionalProperties: false properties: request_id: example: req_clxxxxxxxxxxxxxxxxxxxxxxxxx type: string required: - request_id type: object ok: enum: - false type: boolean required: - ok - error - meta type: object SuccessEnvelope: properties: meta: additionalProperties: {} properties: {} type: object ok: enum: - true type: boolean required: - ok - meta type: object MailboxDomainVerifyResult: additionalProperties: false properties: checks: $ref: '#/components/schemas/MailboxDomainVerifyChecks' ses_dkim_status: description: Latest Amazon SES DKIM status type: string ses_mail_from_status: description: Latest Amazon SES MAIL FROM status type: string status: description: Post-check verification status enum: - verified - pending - failed type: string required: - status - ses_dkim_status - ses_mail_from_status - checks type: object ResponseMeta: additionalProperties: false properties: request_id: example: req_clxxxxxxxxxxxxxxxxxxxxxxxxx type: string required: - request_id type: object ApiErrorDetail: additionalProperties: false properties: code: description: >- Machine-readable issue code from the validator (e.g. zod issue code). example: invalid_string type: string field: description: Dot-path of the offending request field. example: recipient.email type: string message: description: Human-readable issue description. type: string required: - field - code - message type: object MailboxDomainVerifyChecks: additionalProperties: false properties: dmarc: description: >- Published DMARC policy provides at least the required enforcement level. type: boolean mail_from_mx: description: Custom MAIL FROM MX record matches expected value type: boolean mail_from_spf: description: >- Custom MAIL FROM SPF policy is compatible with the required Amazon SES sender authorisation. type: boolean mx: description: >- MX record present when the domain is configured for receiving. Always true for send-only domains. type: boolean spf: description: >- Published SPF policy is compatible with the required Amazon SES sender authorisation. type: boolean verification_txt: description: Ownership TXT record present with correct value type: boolean required: - mx - verification_txt - spf - dmarc - mail_from_mx - mail_from_spf type: object securitySchemes: bearerAuth: bearerFormat: API Key description: >- Sendmux API key. Use a root API key for Management API routes, or a mailbox credential for Mailbox API routes. Obtain keys from the dashboard under API Keys. scheme: bearer type: http ````