> ## Documentation Index
> Fetch the complete documentation index at: https://jetemail.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Get inbound domain settings

> Returns the full configuration for a specific inbound domain. Mode-specific fields (smtp_servers, webhook_url and friends, forward_*_verified) are only present when relevant to the domain's delivery_type.



## OpenAPI

````yaml /openapi.json get /inbound/settings/{uuid}
openapi: 3.0.0
info:
  title: JetEmail API
  version: 1.0.0
  description: API documentation for JetEmail's transactional email service.
servers:
  - url: https://api.jetemail.com
    description: Production
security:
  - apiKeyAuth: []
externalDocs:
  description: Download OpenAPI Specification
  url: /openapi.json
paths:
  /inbound/settings/{uuid}:
    get:
      tags:
        - Inbound
      summary: Get inbound domain settings
      description: >-
        Returns the full configuration for a specific inbound domain.
        Mode-specific fields (smtp_servers, webhook_url and friends,
        forward_*_verified) are only present when relevant to the domain's
        delivery_type.
      parameters:
        - name: uuid
          in: path
          required: true
          description: UUID of the domain
          schema:
            type: string
            format: uuid
            pattern: >-
              ^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
      responses:
        '200':
          description: Successfully retrieved domain settings
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  result:
                    type: object
                    properties:
                      uuid:
                        type: string
                        format: uuid
                        example: 550e8400-e29b-41d4-a716-446655440000
                      domain:
                        type: string
                        example: example.com
                      delivery_type:
                        type: string
                        enum:
                          - smtp
                          - webhook
                          - forward
                        example: smtp
                      status:
                        type: string
                        enum:
                          - active
                          - disabled
                        example: active
                      smtp_servers:
                        type: array
                        nullable: true
                        description: Only populated for delivery_type=smtp; null otherwise.
                        items:
                          type: object
                          properties:
                            url:
                              type: string
                              example: mail.example.com:25
                            priority:
                              type: integer
                              example: 1
                            tls_enabled:
                              type: boolean
                              example: false
                            timeout:
                              type: integer
                              example: 30000
                      webhook_url:
                        type: string
                        format: uri
                        nullable: true
                        description: >-
                          Only populated for delivery_type=webhook; null
                          otherwise.
                        example: https://example.com/webhook/inbound
                      webhook_method:
                        type: string
                        enum:
                          - POST
                          - PUT
                        nullable: true
                        description: >-
                          Only populated for delivery_type=webhook; null
                          otherwise.
                      webhook_headers:
                        type: object
                        additionalProperties:
                          type: string
                        nullable: true
                        description: >-
                          Only populated for delivery_type=webhook; null
                          otherwise.
                      webhook_timeout:
                        type: integer
                        nullable: true
                        description: >-
                          Only populated for delivery_type=webhook; null
                          otherwise.
                        example: 30000
                      webhook_retry_count:
                        type: integer
                        nullable: true
                        description: >-
                          Only populated for delivery_type=webhook; null
                          otherwise.
                        example: 3
                      webhook_auth_header:
                        type: string
                        nullable: true
                        description: >-
                          Only populated for delivery_type=webhook; null
                          otherwise.
                      webhook_secret:
                        type: string
                        nullable: true
                        description: >-
                          Only populated for delivery_type=webhook; null
                          otherwise. Used to validate the HMAC signature on
                          webhook payloads.
                      forward_mx_verified:
                        type: integer
                        enum:
                          - 0
                          - 1
                        description: >-
                          Only present for delivery_type=forward. DNS
                          verification flag for the customer's MX record.
                          Inbound mail is rejected with 550 until all four
                          forward_*_verified flags are 1.
                        example: 0
                      forward_dkim_verified:
                        type: integer
                        enum:
                          - 0
                          - 1
                        description: >-
                          Only present for delivery_type=forward. DNS
                          verification flag for the customer's DKIM CNAME.
                        example: 0
                      forward_spf_verified:
                        type: integer
                        enum:
                          - 0
                          - 1
                        description: >-
                          Only present for delivery_type=forward. DNS
                          verification flag for the customer's SPF record.
                        example: 0
                      forward_dmarc_verified:
                        type: integer
                        enum:
                          - 0
                          - 1
                        description: >-
                          Only present for delivery_type=forward. DNS
                          verification flag for the customer's DMARC record.
                        example: 0
                      last_modified:
                        type: integer
                        nullable: true
                        description: Unix epoch seconds.
                        example: 1735937552
                      created_at:
                        type: integer
                        nullable: true
                        description: Unix epoch seconds.
                        example: 1735937552
        '400':
          description: Invalid UUID format
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  error:
                    type: string
                    example: Invalid UUID format
        '401':
          description: Unauthorized - User not authenticated
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  error:
                    type: string
                    example: User information not found
        '404':
          description: Domain not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  error:
                    type: string
                    example: Domain not found
        '500':
          description: Server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  error:
                    type: string
                    example: Failed to fetch domain settings
components:
  securitySchemes:
    apiKeyAuth:
      type: http
      scheme: bearer
      description: API key for account management endpoints. Use your api_ prefixed token.

````