openapi: 3.0.0
info:
  title: EmailValidation
  description: >
    Email Validation API is a robust solution designed to verify the status of an email address and detect potential risks associated with fraudulent or suspicious activity. Whether you’re a business looking to reduce bounce rates, prevent fake account sign-ups, or enhance security, this API provides accurate and real-time email validation.


    **How It Works**


    The Email Validator API checks whether an email address is active, valid, and properly formatted while also analyzing potential risk factors. It returns detailed status flags indicating whether an email is:

    * **Valid and active** for communication

    * **Disposable or temporary**, often used for spam

    * **Associated with fraudulent activity** or high-risk behaviors

    * **From a free or corporate domain**

    * **Malformed or incorrectly formatted**



    **Why It Matters**


    Fraud prevention is a growing concern for businesses, and our Email Fraud Validation API plays a key role in identifying suspicious emails before they cause harm. By leveraging this API, companies can:

    * Prevent fraudulent sign-ups and spam registrations

    * Reduce email bounces and improve sender reputation

    * Enhance cybersecurity by identifying risky email addresses

    * Improve data accuracy in CRM and marketing campaigns

    Designed for seamless integration, our Email Validation API ensures that businesses can quickly and efficiently verify email addresses, reduce fraud risks, and maintain a clean and secure database.
  version: 1.0.0.0
paths:
  /GetReport:
    post:
      operationId: /GetReport
      requestBody:
        x-name: MBEmailValidationRq
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MBEmailValidationRq_Type'
            examples:
              VALID1:
                value: >-
                  {
                    "EmailAddr" : "nakkyaattah@gmail.com"
                  }
              VALID2:
                value: >-
                  {
                    "EmailAddr" : "test@testdomain.com"
                  }
          application/xml:
            schema:
              $ref: '#/components/schemas/MBEmailValidationRq_Type'
            examples:
              VALID1:
                value: <EmailAddr>nakkyaattah@gmail.com</EmailAddr>
              VALID2:
                value: <EmailAddr>test@testdomain.com</EmailAddr>
        required: true
        x-position: 1
      responses:
        default:
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MBEmailValidationRs_Type'
            application/xml:
              schema:
                $ref: '#/components/schemas/MBEmailValidationRs_Type'
      security:
      - oauth: []
  /GetArchiveReport:
    get:
      summary: Request previously obtained report by using its RqUID (AppId).
      description: Previously pulled reports are available on the system for immediate access for up to 90 days.
      operationId: /GetArchiveReport
      parameters:
      - name: AppId
        in: query
        required: true
        schema:
          type: string
        x-position: 1
      responses:
        default:
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MBEmailValidationRs_Type'
            application/xml:
              schema:
                $ref: '#/components/schemas/MBEmailValidationRs_Type'
      security:
      - oauth: []
components:
  schemas:
    MBEmailValidationRs_Type:
      type: object
      properties:
        MsgRsHdr:
          $ref: '#/components/schemas/MsgRsHdr_Type'
        Request:
          $ref: '#/components/schemas/MBEmailValidationRs_TypeRequest'
        EmailStatus:
          type: string
        EmailRiskLevel:
          type: string
        Message:
          $ref: '#/components/schemas/Message_Type'
    MsgRsHdr_Type:
      type: object
      properties:
        RqUID:
          type: string
        Status:
          $ref: '#/components/schemas/Status_Type'
    Status_Type:
      type: object
      properties:
        StatusCode:
          type: integer
          format: int64
        ServerStatusCode:
          type: string
        Severity:
          $ref: '#/components/schemas/Severity_Type'
        StatusDesc:
          type: string
        AdditionalStatus:
          type: array
          items:
            $ref: '#/components/schemas/AdditionalStatus_Type'
    Severity_Type:
      type: string
      description: ''
      x-enumNames:
      - Error
      - Warn
      - Info
      enum:
      - Error
      - Warn
      - Info
    AdditionalStatus_Type:
      type: object
      properties:
        StatusCode:
          type: integer
          format: int64
        StatusCodeSpecified:
          type: boolean
        ServerStatusCode:
          type: string
        Severity:
          $ref: '#/components/schemas/Severity_Type'
        StatusDesc:
          type: string
    MBEmailValidationRs_TypeRequest:
      type: object
      properties:
        RefNum:
          type: string
        EmailAddr:
          type: string
    Message_Type:
      type: object
      properties:
        Source:
          type: string
        EffDt:
          type: string
          format: date-time
        EffDtSpecified:
          type: boolean
        MsgClass:
          type: string
        MsgCode:
          type: string
        Text:
          type: string
    MBEmailValidationRq_Type:
      type: object
      properties:
        MsgRqHdr:
          $ref: '#/components/schemas/MsgRqHdr_Type'
        EmailAddr:
          type: string
    MsgRqHdr_Type:
      type: object
      properties:
        MemberId:
          type: string
        MemberPwd:
          type: string
        RequestType:
          $ref: '#/components/schemas/MsgRqHdr_TypeRequestType'
        RequestTypeSpecified:
          type: boolean
        ReasonCode:
          type: string
        GLBPurpose:
          type: string
        DLPurpose:
          type: string
        RefNum:
          type: string
        UserName:
          type: string
        Timeout:
          type: integer
          format: int64
        TimeoutSpecified:
          type: boolean
        FrozenFilePIN:
          type: string
        OutputFormat:
          type: string
        ProductID:
          type: string
    MsgRqHdr_TypeRequestType:
      type: string
      description: ''
      x-enumNames:
      - I
      - J
      - N
      - A
      - W
      - S
      - P
      - B
      - R
      enum:
      - I
      - J
      - N
      - A
      - W
      - S
      - P
      - B
      - R
  securitySchemes:
    oauth:
      type: oauth2
      flows:
        clientCredentials:
          scopes: {}
          tokenUrl: https://apitest.microbilt.com/OAuth/Token
servers:
- url: https://api.microbilt.com/EmailValidation
  description: Production url
- url: https://apitest.microbilt.com/EmailValidation
  description: Sandbox url
x-name: EmailValidation