> ## 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 SMTP users

> Retrieves a list of SMTP users



## OpenAPI

````yaml /openapi.json get /outbound/smarthost
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: []
tags:
  - name: Email
    description: Send transactional email
  - name: Outbound
    description: 'Outbound sending: keys, SMTP users, domains, logs, suppression'
  - name: Inbound
    description: Inbound routing, domains and forward destinations
  - name: DMARC
    description: DMARC aggregate-report domain setup, DNS verification and analytics
  - name: Marketing
    description: >-
      Marketing suite: templates, audiences, contacts, broadcasts, themes,
      assets and signup forms
  - name: Signup Forms
    description: Hosted signup pages and form submissions
externalDocs:
  description: Download OpenAPI Specification
  url: /openapi.json
paths:
  /outbound/smarthost:
    get:
      tags:
        - Outbound
      summary: Get SMTP users
      description: Retrieves a list of SMTP users
      responses:
        '200':
          description: Successfully retrieved SMTP users
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  smarthosts:
                    type: array
                    items:
                      type: object
                      properties:
                        username:
                          type: string
                          description: SMTP username
                          example: smtpuser
                        uuid:
                          type: string
                          description: Unique identifier for the smarthost
                          example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
                        status:
                          type: string
                          enum:
                            - disabled
                            - active
                            - suspended
                            - quota-locked
                            - quota-unlocked
                          description: Current status of the SMTP user
                          example: active
                        allowAnyDomain:
                          type: integer
                          enum:
                            - 0
                            - 1
                          description: >-
                            Whether the user can send from any domain (0=false,
                            1=true)
                          example: 0
                        allowAllDomains:
                          type: integer
                          enum:
                            - 0
                            - 1
                          description: >-
                            Whether the user can send from all verified domains
                            (0=false, 1=true)
                          example: 0
                        approvedDomains:
                          type: string
                          description: JSON string containing array of approved domains
                          example: '["alloweddomain.com"]'
                        usage:
                          type: integer
                          description: Current usage count
                          example: 77
                        quota:
                          type: integer
                          description: Maximum allowed usage
                          example: 1001
                        ipRestrictions:
                          type: string
                          description: JSON string containing array of allowed IP addresses
                          example: '["1.1.1.1"]'
                        ip_auth:
                          type: string
                          nullable: true
                          description: >-
                            IP-based SMTP authentication address (pro only). A
                            single IPv4 bound to this account, globally unique
                            across all accounts; null if not set. Username and
                            password are still required.
                          example: 1.1.1.1
                        tags:
                          type: string
                          description: >-
                            JSON string containing an array of free-form tags
                            used to organise/filter SMTP users
                          example: '["production","billing"]'
                        created_date:
                          type: string
                          description: >-
                            Creation timestamp in milliseconds or seconds (with
                            decimal)
                          example: '1724113774000'
                        last_modified:
                          type: integer
                          description: Last modification timestamp in seconds
                          example: 1735937552
        '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
        '500':
          description: Server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  error:
                    type: string
                    example: Failed to fetch SMTP users
components:
  securitySchemes:
    apiKeyAuth:
      type: http
      scheme: bearer
      description: API key for account management endpoints. Use your api_ prefixed token.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.