For clean Markdown of any page, append .md to the page URL. For a complete documentation index, see https://documentation.apexverify.com/api-reference/apex-verify-api/unit/llms.txt. For full documentation content, see https://documentation.apexverify.com/api-reference/apex-verify-api/unit/llms-full.txt.

# Unit Verification

POST https://api.apexverify.com/v1/unit
Content-Type: application/json

Start unit verification to get real-time verification results for a given unit. The verification process can take up to 5 seconds to complete, depending on the complexity of the unit...

Reference: https://documentation.apexverify.com/api-reference/apex-verify-api/unit/post-v-1-unit-post

## OpenAPI Specification

```yaml
openapi: 3.1.0
info:
  title: openapi
  version: 1.0.0
paths:
  /v1/unit:
    post:
      operationId: post-v-1-unit-post
      summary: Unit Verification
      description: >-
        Start unit verification to get real-time verification results for a
        given unit. The verification process can take up to 5 seconds to
        complete, depending on the complexity of the unit...
      tags:
        - subpackage_unit
      parameters:
        - name: X-API-Key
          in: header
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Unit_post_v1_unit_post_Response_200'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequestResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedResponse'
        '402':
          description: Payment Required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentRequiredResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ForbiddenResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFoundResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TooManyRequestsResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerErrorResponse'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UnitVerificationModelPayload'
servers:
  - url: https://api.apexverify.com
components:
  schemas:
    BatchVerificationTypeEnum:
      type: string
      enum:
        - email
        - phone
      title: BatchVerificationTypeEnum
    CountryCodeIso2Enum:
      type: string
      enum:
        - AF
        - AL
        - DZ
        - AS
        - AD
        - AO
        - AI
        - AG
        - AR
        - AM
        - AW
        - AU
        - AT
        - AZ
        - BH
        - BD
        - BB
        - BY
        - BE
        - BZ
        - BJ
        - BM
        - BT
        - BO
        - BA
        - BW
        - BR
        - IO
        - BN
        - BG
        - BF
        - BI
        - KH
        - CM
        - CA
        - CV
        - KY
        - CF
        - TD
        - CL
        - CN
        - CO
        - KM
        - CG
        - CD
        - CK
        - CR
        - CI
        - HR
        - CU
        - CY
        - CZ
        - DK
        - DJ
        - DM
        - DO
        - TL
        - EC
        - EG
        - SV
        - GQ
        - ER
        - EE
        - ET
        - FK
        - FO
        - FJ
        - FI
        - FR
        - PF
        - GA
        - GE
        - DE
        - GH
        - GI
        - GR
        - GL
        - GD
        - GP
        - GT
        - GG
        - GN
        - GW
        - GY
        - HT
        - HN
        - HK
        - HU
        - IS
        - IN
        - ID
        - IR
        - IQ
        - IE
        - IL
        - IT
        - JM
        - JP
        - JE
        - JO
        - KZ
        - KE
        - KR
        - KW
        - KG
        - LA
        - LV
        - LB
        - LS
        - LR
        - LY
        - LI
        - LT
        - LU
        - MO
        - MK
        - MG
        - MW
        - MY
        - MV
        - ML
        - MT
        - MQ
        - MR
        - MU
        - YT
        - MX
        - MD
        - MC
        - MN
        - ME
        - MS
        - MA
        - MZ
        - MM
        - NA
        - NR
        - NP
        - NL
        - NC
        - NZ
        - NI
        - NE
        - NG
        - NU
        - NF
        - MP
        - 'NO'
        - OM
        - PK
        - PW
        - PS
        - PA
        - PG
        - PY
        - PE
        - PH
        - PL
        - PT
        - QA
        - RE
        - RO
        - RU
        - RW
        - KN
        - LC
        - PM
        - VC
        - BL
        - MF
        - WS
        - SM
        - ST
        - SA
        - SN
        - RS
        - SC
        - SL
        - SG
        - SK
        - SI
        - SB
        - SO
        - ZA
        - GS
        - SS
        - ES
        - LK
        - SD
        - SR
        - SZ
        - SE
        - CH
        - SY
        - TW
        - TJ
        - TZ
        - TH
        - TG
        - TO
        - TT
        - TN
        - TR
        - TM
        - TC
        - UG
        - UA
        - AE
        - GB
        - US
        - UM
        - UY
        - UZ
        - VU
        - VE
        - VN
        - VG
        - YE
        - ZM
        - ZW
        - CW
        - SX
      title: CountryCodeIso2Enum
    UnitVerificationModelPayloadTargetAudience:
      type: string
      enum:
        - '1'
        - '2'
        - '3'
        - '4'
        - '5'
        - '6'
        - '7'
        - '8'
        - '9'
        - '10'
        - '11'
        - '12'
        - '13'
        - '14'
        - '15'
        - '16'
        - '17'
        - '18'
        - '19'
        - '20'
        - '21'
        - '22'
        - '23'
      description: >-
        1 = Agency / Consultants<br>2 = Creators & Influencers<br>3 = Customer
        Support & Success<br>4 = Developers & Technical Leads<br>5 = E-commerce
        & Retail Managers<br>6 = Enterprise Decision-Makers<br>7 = Finance &
        Operations Professionals<br>8 = Founders & C-Level Executives<br>9 =
        Freelancers & Solopreneurs<br>10 = Government & Public Sector
        Employees<br>11 = HR & Talent Acquisition<br>12 = Healthcare
        Professionals<br>13 = Hobbyists & Enthusiasts<br>14 = Investors &
        VCs<br>15 = Job Seekers<br>16 = Legal Professionals<br>17 = Marketing &
        Sales Professionals<br>18 = Non-Profit Leaders & Staff<br>19 = Parents &
        Families<br>20 = Product & Project Managers<br>21 = Real Estate
        Professionals<br>22 = Small-to-Medium Business (SMB) Owners<br>23 =
        Students & Educators
      title: UnitVerificationModelPayloadTargetAudience
    UnitVerificationModelPayloadTargetMarketIndustry:
      type: string
      enum:
        - '1'
        - '2'
        - '3'
        - '4'
        - '5'
        - '6'
        - '7'
        - '8'
        - '9'
        - '10'
        - '11'
        - '12'
        - '13'
        - '14'
        - '15'
        - '16'
        - '17'
        - '18'
        - '19'
        - '20'
        - '21'
        - '22'
        - '23'
        - '24'
        - '25'
        - '26'
        - '27'
        - '28'
        - '29'
        - '30'
        - '31'
        - '32'
        - '33'
        - '34'
        - '35'
        - '36'
        - '37'
        - '38'
        - '39'
        - '40'
        - '41'
        - '42'
        - '43'
        - '44'
        - '45'
        - '46'
        - '47'
        - '48'
        - '49'
        - '50'
        - '51'
        - '52'
        - '53'
        - '54'
        - '55'
        - '56'
        - '57'
        - '58'
        - '59'
        - '60'
        - '61'
        - '62'
        - '63'
        - '64'
        - '65'
        - '66'
        - '67'
        - '68'
        - '69'
        - '70'
        - '71'
        - '72'
        - '73'
        - '74'
        - '75'
        - '76'
        - '77'
        - '78'
        - '79'
        - '80'
        - '81'
        - '82'
        - '83'
        - '84'
        - '85'
        - '86'
        - '87'
        - '88'
        - '89'
        - '90'
        - '91'
        - '92'
        - '93'
        - '94'
        - '95'
        - '96'
        - '97'
        - '98'
        - '99'
        - '100'
        - '101'
        - '102'
        - '103'
        - '104'
        - '105'
        - '106'
        - '107'
        - '108'
        - '109'
        - '110'
        - '111'
        - '112'
        - '113'
        - '114'
        - '115'
      description: >-
        1 = Accommodation<br>2 = Accommodation and Food Services<br>3 =
        Administrative and Support Services<br>4 = Administrative and Support
        and Waste Management and Remediation Services<br>5 = Agriculture,
        Forestry, Fishing and Hunting<br>6 = Air Transportation<br>7 =
        Ambulatory Health Care Services<br>8 = Amusement, Gambling, and
        Recreation Industries<br>9 = Animal Production<br>10 = Apparel
        Manufacturing<br>11 = Arts, Entertainment, and Recreation<br>12 =
        Beverage and Tobacco Product Manufacturing<br>13 = Broadcasting (except
        Internet)<br>14 = Building Material and Garden Equipment and Supplies
        Dealers<br>15 = Chemical Manufacturing<br>16 = Clothing and Clothing
        Accessories Stores<br>17 = Computer and Electronic Product
        Manufacturing<br>18 = Construction<br>19 = Construction of
        Buildings<br>20 = Couriers and Messengers<br>21 = Credit Intermediation
        and Related Activities<br>22 = Crop Production<br>23 = Data Processing,
        Hosting, and Related Services<br>24 = Education and Health
        Services<br>25 = Educational Services<br>26 = Electrical Equipment,
        Appliance, and Component Manufacturing<br>27 = Electronics and Appliance
        Stores<br>28 = Fabricated Metal Product Manufacturing<br>29 = Finance
        and Insurance<br>30 = Financial Activities<br>31 = Fishing, Hunting and
        Trapping<br>32 = Food Manufacturing<br>33 = Food Services and Drinking
        Places<br>34 = Food and Beverage Stores<br>35 = Forestry and
        Logging<br>36 = Funds, Trusts, and Other Financial Vehicles<br>37 =
        Furniture and Home Furnishings Stores<br>38 = Furniture and Related
        Product Manufacturing<br>39 = Gasoline Stations<br>40 = General
        Merchandise Stores<br>41 = Goods-Producing Industries<br>42 = Health
        Care and Social Assistance<br>43 = Health and Personal Care Stores<br>44
        = Heavy and Civil Engineering Construction<br>45 = Hospitals<br>46 =
        Information<br>47 = Insurance Carriers and Related Activities<br>48 =
        Internet Publishing and Broadcasting<br>49 = Leather and Allied Product
        Manufacturing<br>50 = Leisure and Hospitality<br>51 = Lessors of
        Nonfinancial Intangible Assets (except Copyrighted Works)<br>52 =
        Machinery Manufacturing<br>53 = Management of Companies and
        Enterprises<br>54 = Manufacturing<br>55 = Merchant Wholesalers, Durable
        Goods<br>56 = Merchant Wholesalers, Nondurable Goods<br>57 = Mining
        (except Oil and Gas)<br>58 = Mining, Quarrying, and Oil and Gas
        Extraction<br>59 = Miscellaneous Manufacturing<br>60 = Miscellaneous
        Store Retailers<br>61 = Monetary Authorities - Central Bank<br>62 =
        Motion Picture and Sound Recording Industries<br>63 = Motor Vehicle and
        Parts Dealers<br>64 = Museums, Historical Sites, and Similar
        Institutions<br>65 = Natural Resources and Mining<br>66 = Nonmetallic
        Mineral Product Manufacturing<br>67 = Nonstore Retailers<br>68 = Nursing
        and Residential Care Facilities<br>69 = Oil and Gas Extraction<br>70 =
        Other Information Services<br>71 = Other Services (except Public
        Administration)<br>72 = Paper Manufacturing<br>73 = Performing Arts,
        Spectator Sports, and Related Industries<br>74 = Personal and Laundry
        Services<br>75 = Petroleum and Coal Products Manufacturing<br>76 =
        Pipeline Transportation<br>77 = Plastics and Rubber Products
        Manufacturing<br>78 = Postal Service<br>79 = Primary Metal
        Manufacturing<br>80 = Printing and Related Support Activities<br>81 =
        Private Households<br>82 = Professional and Business Services<br>83 =
        Professional, Scientific, and Technical Services<br>84 = Publishing
        Industries (except Internet)<br>85 = Rail Transportation<br>86 = Real
        Estate<br>87 = Real Estate and Rental and Leasing<br>88 = Religious,
        Grantmaking, Civic, Professional, and Similar Organizations<br>89 =
        Rental and Leasing Services<br>90 = Repair and Maintenance<br>91 =
        Retail Trade<br>92 = Scenic and Sightseeing Transportation<br>93 =
        Securities, Commodity Contracts, and Other Financial Investments and
        Related Activities<br>94 = Service-Providing Industries<br>95 = Social
        Assistance<br>96 = Specialty Trade Contractors<br>97 = Sporting Goods,
        Hobby, Book, and Music Stores<br>98 = Support Activities for Agriculture
        and Forestry<br>99 = Support Activities for Mining<br>100 = Support
        Activities for Transportation<br>101 = Telecommunications<br>102 =
        Textile Mills<br>103 = Textile Product Mills<br>104 = Trade,
        Transportation, and Utilities<br>105 = Transit and Ground Passenger
        Transportation<br>106 = Transportation Equipment Manufacturing<br>107 =
        Transportation and Warehousing<br>108 = Truck Transportation<br>109 =
        Utilities<br>110 = Warehousing and Storage<br>111 = Waste Management and
        Remediation Services<br>112 = Water Transportation<br>113 = Wholesale
        Electronic Markets and Agents and Brokers<br>114 = Wholesale
        Trade<br>115 = Wood Product Manufacturing
      title: UnitVerificationModelPayloadTargetMarketIndustry
    UnitVerificationModelPayloadTargetObjective:
      type: string
      enum:
        - '1'
        - '2'
        - '3'
        - '4'
        - '5'
        - '6'
        - '7'
        - '8'
        - '9'
        - '10'
        - '11'
        - '12'
        - '13'
        - '14'
        - '15'
        - '16'
      description: >-
        1 = App Installs / Downloads<br>2 = Audience Building
        (Email/Community)<br>3 = Brand Awareness & Recall<br>4 = Customer
        Acquisition / Sales<br>5 = Free Trial or Freemium Signups<br>6 = Lead
        Generation (Top/Mid-Funnel)<br>7 = Loyalty & Referral Program
        Growth<br>8 = Market & Customer Research<br>9 = New Market Entry<br>10 =
        Partner & Affiliate Recruitment<br>11 = Product Engagement & Feature
        Adoption<br>12 = Sales-Ready Leads (Bottom-Funnel)<br>13 = Upsell /
        Cross-sell Revenue<br>14 = User Retention & Churn Reduction<br>15 =
        Waitlist / Pre-order Signups<br>16 = Website / App Traffic Acquisition
      title: UnitVerificationModelPayloadTargetObjective
    UnitVerificationModelPayload:
      type: object
      properties:
        type:
          $ref: '#/components/schemas/BatchVerificationTypeEnum'
          description: Type of verification to apply to the batch.
        target_country:
          $ref: '#/components/schemas/CountryCodeIso2Enum'
          description: Country against which the batch should be processed.
        target_audience:
          $ref: '#/components/schemas/UnitVerificationModelPayloadTargetAudience'
          description: >-
            1 = Agency / Consultants<br>2 = Creators & Influencers<br>3 =
            Customer Support & Success<br>4 = Developers & Technical Leads<br>5
            = E-commerce & Retail Managers<br>6 = Enterprise
            Decision-Makers<br>7 = Finance & Operations Professionals<br>8 =
            Founders & C-Level Executives<br>9 = Freelancers &
            Solopreneurs<br>10 = Government & Public Sector Employees<br>11 = HR
            & Talent Acquisition<br>12 = Healthcare Professionals<br>13 =
            Hobbyists & Enthusiasts<br>14 = Investors & VCs<br>15 = Job
            Seekers<br>16 = Legal Professionals<br>17 = Marketing & Sales
            Professionals<br>18 = Non-Profit Leaders & Staff<br>19 = Parents &
            Families<br>20 = Product & Project Managers<br>21 = Real Estate
            Professionals<br>22 = Small-to-Medium Business (SMB) Owners<br>23 =
            Students & Educators
        target_market_industry:
          $ref: >-
            #/components/schemas/UnitVerificationModelPayloadTargetMarketIndustry
          description: >-
            1 = Accommodation<br>2 = Accommodation and Food Services<br>3 =
            Administrative and Support Services<br>4 = Administrative and
            Support and Waste Management and Remediation Services<br>5 =
            Agriculture, Forestry, Fishing and Hunting<br>6 = Air
            Transportation<br>7 = Ambulatory Health Care Services<br>8 =
            Amusement, Gambling, and Recreation Industries<br>9 = Animal
            Production<br>10 = Apparel Manufacturing<br>11 = Arts,
            Entertainment, and Recreation<br>12 = Beverage and Tobacco Product
            Manufacturing<br>13 = Broadcasting (except Internet)<br>14 =
            Building Material and Garden Equipment and Supplies Dealers<br>15 =
            Chemical Manufacturing<br>16 = Clothing and Clothing Accessories
            Stores<br>17 = Computer and Electronic Product Manufacturing<br>18 =
            Construction<br>19 = Construction of Buildings<br>20 = Couriers and
            Messengers<br>21 = Credit Intermediation and Related
            Activities<br>22 = Crop Production<br>23 = Data Processing, Hosting,
            and Related Services<br>24 = Education and Health Services<br>25 =
            Educational Services<br>26 = Electrical Equipment, Appliance, and
            Component Manufacturing<br>27 = Electronics and Appliance
            Stores<br>28 = Fabricated Metal Product Manufacturing<br>29 =
            Finance and Insurance<br>30 = Financial Activities<br>31 = Fishing,
            Hunting and Trapping<br>32 = Food Manufacturing<br>33 = Food
            Services and Drinking Places<br>34 = Food and Beverage Stores<br>35
            = Forestry and Logging<br>36 = Funds, Trusts, and Other Financial
            Vehicles<br>37 = Furniture and Home Furnishings Stores<br>38 =
            Furniture and Related Product Manufacturing<br>39 = Gasoline
            Stations<br>40 = General Merchandise Stores<br>41 = Goods-Producing
            Industries<br>42 = Health Care and Social Assistance<br>43 = Health
            and Personal Care Stores<br>44 = Heavy and Civil Engineering
            Construction<br>45 = Hospitals<br>46 = Information<br>47 = Insurance
            Carriers and Related Activities<br>48 = Internet Publishing and
            Broadcasting<br>49 = Leather and Allied Product Manufacturing<br>50
            = Leisure and Hospitality<br>51 = Lessors of Nonfinancial Intangible
            Assets (except Copyrighted Works)<br>52 = Machinery
            Manufacturing<br>53 = Management of Companies and Enterprises<br>54
            = Manufacturing<br>55 = Merchant Wholesalers, Durable Goods<br>56 =
            Merchant Wholesalers, Nondurable Goods<br>57 = Mining (except Oil
            and Gas)<br>58 = Mining, Quarrying, and Oil and Gas Extraction<br>59
            = Miscellaneous Manufacturing<br>60 = Miscellaneous Store
            Retailers<br>61 = Monetary Authorities - Central Bank<br>62 = Motion
            Picture and Sound Recording Industries<br>63 = Motor Vehicle and
            Parts Dealers<br>64 = Museums, Historical Sites, and Similar
            Institutions<br>65 = Natural Resources and Mining<br>66 =
            Nonmetallic Mineral Product Manufacturing<br>67 = Nonstore
            Retailers<br>68 = Nursing and Residential Care Facilities<br>69 =
            Oil and Gas Extraction<br>70 = Other Information Services<br>71 =
            Other Services (except Public Administration)<br>72 = Paper
            Manufacturing<br>73 = Performing Arts, Spectator Sports, and Related
            Industries<br>74 = Personal and Laundry Services<br>75 = Petroleum
            and Coal Products Manufacturing<br>76 = Pipeline
            Transportation<br>77 = Plastics and Rubber Products
            Manufacturing<br>78 = Postal Service<br>79 = Primary Metal
            Manufacturing<br>80 = Printing and Related Support Activities<br>81
            = Private Households<br>82 = Professional and Business
            Services<br>83 = Professional, Scientific, and Technical
            Services<br>84 = Publishing Industries (except Internet)<br>85 =
            Rail Transportation<br>86 = Real Estate<br>87 = Real Estate and
            Rental and Leasing<br>88 = Religious, Grantmaking, Civic,
            Professional, and Similar Organizations<br>89 = Rental and Leasing
            Services<br>90 = Repair and Maintenance<br>91 = Retail Trade<br>92 =
            Scenic and Sightseeing Transportation<br>93 = Securities, Commodity
            Contracts, and Other Financial Investments and Related
            Activities<br>94 = Service-Providing Industries<br>95 = Social
            Assistance<br>96 = Specialty Trade Contractors<br>97 = Sporting
            Goods, Hobby, Book, and Music Stores<br>98 = Support Activities for
            Agriculture and Forestry<br>99 = Support Activities for
            Mining<br>100 = Support Activities for Transportation<br>101 =
            Telecommunications<br>102 = Textile Mills<br>103 = Textile Product
            Mills<br>104 = Trade, Transportation, and Utilities<br>105 = Transit
            and Ground Passenger Transportation<br>106 = Transportation
            Equipment Manufacturing<br>107 = Transportation and
            Warehousing<br>108 = Truck Transportation<br>109 = Utilities<br>110
            = Warehousing and Storage<br>111 = Waste Management and Remediation
            Services<br>112 = Water Transportation<br>113 = Wholesale Electronic
            Markets and Agents and Brokers<br>114 = Wholesale Trade<br>115 =
            Wood Product Manufacturing
        target_objective:
          $ref: '#/components/schemas/UnitVerificationModelPayloadTargetObjective'
          description: >-
            1 = App Installs / Downloads<br>2 = Audience Building
            (Email/Community)<br>3 = Brand Awareness & Recall<br>4 = Customer
            Acquisition / Sales<br>5 = Free Trial or Freemium Signups<br>6 =
            Lead Generation (Top/Mid-Funnel)<br>7 = Loyalty & Referral Program
            Growth<br>8 = Market & Customer Research<br>9 = New Market
            Entry<br>10 = Partner & Affiliate Recruitment<br>11 = Product
            Engagement & Feature Adoption<br>12 = Sales-Ready Leads
            (Bottom-Funnel)<br>13 = Upsell / Cross-sell Revenue<br>14 = User
            Retention & Churn Reduction<br>15 = Waitlist / Pre-order
            Signups<br>16 = Website / App Traffic Acquisition
        use_account_cache:
          type: boolean
          default: true
          description: >-
            You can choose to enable or disable your account cache. If enabled,
            we may reuse your previous verification results to speed up
            processing and improve efficiency. When your account cache is used,
            you’ll receive a 50% credit refund for those verifications. You can
            enable both the account cache and the global cache, or disable both.
            Our system will always check your account cache first, then the
            global cache.
        max_account_cache_backoff:
          type: integer
          default: 30
          description: >-
            Set the maximum number of days our system should look back to find
            matching verification results for this file. Min: 1 (only today) -
            Max: 180 days.
        use_global_cache:
          type: boolean
          default: true
          description: >-
            You can choose to enable or disable the global cache. When the
            global cache is used, you’ll receive a 50% credit refund for the
            related verifications. If enabled, your verification results will be
            shared anonymously with other users, and you'll also gain access to
            anonymized results from other companies. This shared data is fully
            abstracted and anonymized, no personal or identifiable information
            is exposed. By enabling this option, you give us permission to reuse
            previous verification results across different clients to improve
            efficiency and reduce redundancy.
        max_global_cache_backoff:
          type: integer
          default: 30
          description: >-
            Set the maximum number of days our system should look back to find
            matching verification results for this file. Min: 1 (only today) -
            Max: 180 days.
        unit:
          type: string
          description: Email, Phone or Address to Verify.
      required:
        - type
        - target_country
        - unit
      title: UnitVerificationModelPayload
    EmailResultQuality:
      type: string
      enum:
        - good
        - bad
        - risky
        - unknown
      title: EmailResultQuality
    EmailResultResult:
      type: string
      enum:
        - ok
        - invalid
        - error
        - unknown
      title: EmailResultResult
    BatchVerificationResultsEmailSerial:
      type: object
      properties:
        email:
          type: string
        valid:
          type: boolean
        wrong:
          type: boolean
        unknown:
          type: boolean
        quality:
          $ref: '#/components/schemas/EmailResultQuality'
        result:
          $ref: '#/components/schemas/EmailResultResult'
        is_syntax_error:
          type: boolean
        is_free:
          type: boolean
        is_role:
          type: boolean
        is_disposable:
          type: boolean
        is_catch_all:
          type: boolean
      required:
        - email
        - valid
        - wrong
        - unknown
        - quality
        - result
        - is_syntax_error
        - is_free
        - is_role
        - is_disposable
        - is_catch_all
      title: BatchVerificationResultsEmailSerial
    PhoneResultNumberType:
      type: string
      enum:
        - bad_format
        - mobile
        - landline
        - mobile_or_landline
        - toll_free
        - premium
        - shared_cost
        - voip
        - stage_and_screen
        - pager
        - universal_access_number
        - personal_number
        - voicemail_only
        - msrn
        - unknown
      title: PhoneResultNumberType
    PhoneResultLiveStatus:
      type: string
      enum:
        - live
        - dead
        - absent_subscriber
        - no_teleservice_provisioned
        - not_available_network_only
        - no_coverage
        - not_applicable
        - inconclusive
      title: PhoneResultLiveStatus
    BatchVerificationResultsPhoneSerial:
      type: object
      properties:
        phone:
          type: string
        valid:
          type: boolean
        wrong:
          type: boolean
        unknown:
          type: boolean
        type:
          $ref: '#/components/schemas/PhoneResultNumberType'
        status:
          $ref: '#/components/schemas/PhoneResultLiveStatus'
        is_syntax_error:
          type: boolean
        is_ported:
          type: boolean
        current_network_mcc:
          type:
            - string
            - 'null'
        current_network_mnc:
          type:
            - string
            - 'null'
        operator:
          type:
            - string
            - 'null'
      required:
        - phone
        - valid
        - wrong
        - unknown
        - type
        - status
        - is_syntax_error
        - is_ported
      title: BatchVerificationResultsPhoneSerial
    V1UnitPostResponsesContentApplicationJsonSchemaDiscriminatorMappingOkVerificationResult:
      oneOf:
        - $ref: '#/components/schemas/BatchVerificationResultsEmailSerial'
        - $ref: '#/components/schemas/BatchVerificationResultsPhoneSerial'
      title: >-
        V1UnitPostResponsesContentApplicationJsonSchemaDiscriminatorMappingOkVerificationResult
    Unit_post_v1_unit_post_Response_200:
      oneOf:
        - type: object
          properties:
            status:
              type: string
              enum:
                - ok
              description: 'Discriminator value: ok'
            verification_result:
              $ref: >-
                #/components/schemas/V1UnitPostResponsesContentApplicationJsonSchemaDiscriminatorMappingOkVerificationResult
          required:
            - status
            - verification_result
          description: ok variant
        - type: object
          properties:
            status:
              type: string
              enum:
                - empty
              description: 'Discriminator value: empty'
          required:
            - status
          description: empty variant
        - type: object
          properties:
            status:
              type: string
              enum:
                - parse_error
              description: 'Discriminator value: parse_error'
          required:
            - status
          description: parse_error variant
        - type: object
          properties:
            status:
              type: string
              enum:
                - error
              description: 'Discriminator value: error'
          required:
            - status
          description: error variant
      discriminator:
        propertyName: status
      title: Unit_post_v1_unit_post_Response_200
    BadRequestResponse:
      type: object
      properties:
        message:
          type: string
          default: Bad Request
      title: BadRequestResponse
    UnauthorizedResponse:
      type: object
      properties:
        message:
          type: string
          default: Unauthorized
      title: UnauthorizedResponse
    PaymentRequiredResponse:
      type: object
      properties:
        message:
          type: string
          default: >-
            Payment Required. Please reload your credits to proceed with the
            verification...
      title: PaymentRequiredResponse
    ForbiddenResponse:
      type: object
      properties:
        message:
          type: string
          default: Forbidden
      title: ForbiddenResponse
    NotFoundResponse:
      type: object
      properties:
        message:
          type: string
          default: Not Found
      title: NotFoundResponse
    ValidationErrorLocItems:
      oneOf:
        - type: string
        - type: integer
      title: ValidationErrorLocItems
    ValidationErrorCtx:
      type: object
      properties: {}
      title: ValidationErrorCtx
    ValidationError:
      type: object
      properties:
        loc:
          type: array
          items:
            $ref: '#/components/schemas/ValidationErrorLocItems'
        msg:
          type: string
        type:
          type: string
        input:
          description: Any type
        ctx:
          $ref: '#/components/schemas/ValidationErrorCtx'
      required:
        - loc
        - msg
        - type
      title: ValidationError
    HTTPValidationError:
      type: object
      properties:
        detail:
          type: array
          items:
            $ref: '#/components/schemas/ValidationError'
      title: HTTPValidationError
    TooManyRequestsResponse:
      type: object
      properties:
        message:
          type: string
          default: Too Many Requests
      title: TooManyRequestsResponse
    InternalServerErrorResponse:
      type: object
      properties:
        message:
          type: string
          default: >-
            Internal Server Error. Please contact support at
            contact@apexverify.com...
      title: InternalServerErrorResponse
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key

```

## SDK Code Examples

```python
import requests

url = "https://api.apexverify.com/v1/unit"

payload = {
    "type": "email",
    "target_country": "SG",
    "unit": "island@gmail.com"
}
headers = {
    "X-API-Key": "<apiKey>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())
```

```javascript
const url = 'https://api.apexverify.com/v1/unit';
const options = {
  method: 'POST',
  headers: {'X-API-Key': '<apiKey>', 'Content-Type': 'application/json'},
  body: '{"type":"email","target_country":"SG","unit":"island@gmail.com"}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.apexverify.com/v1/unit"

	payload := strings.NewReader("{\n  \"type\": \"email\",\n  \"target_country\": \"SG\",\n  \"unit\": \"island@gmail.com\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-Key", "<apiKey>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.apexverify.com/v1/unit")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<apiKey>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"type\": \"email\",\n  \"target_country\": \"SG\",\n  \"unit\": \"island@gmail.com\"\n}"

response = http.request(request)
puts response.read_body
```

```java
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.post("https://api.apexverify.com/v1/unit")
  .header("X-API-Key", "<apiKey>")
  .header("Content-Type", "application/json")
  .body("{\n  \"type\": \"email\",\n  \"target_country\": \"SG\",\n  \"unit\": \"island@gmail.com\"\n}")
  .asString();
```

```php
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.apexverify.com/v1/unit', [
  'body' => '{
  "type": "email",
  "target_country": "SG",
  "unit": "island@gmail.com"
}',
  'headers' => [
    'Content-Type' => 'application/json',
    'X-API-Key' => '<apiKey>',
  ],
]);

echo $response->getBody();
```

```csharp
using RestSharp;

var client = new RestClient("https://api.apexverify.com/v1/unit");
var request = new RestRequest(Method.POST);
request.AddHeader("X-API-Key", "<apiKey>");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{\n  \"type\": \"email\",\n  \"target_country\": \"SG\",\n  \"unit\": \"island@gmail.com\"\n}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
```

```swift
import Foundation

let headers = [
  "X-API-Key": "<apiKey>",
  "Content-Type": "application/json"
]
let parameters = [
  "type": "email",
  "target_country": "SG",
  "unit": "island@gmail.com"
] as [String : Any]

let postData = JSONSerialization.data(withJSONObject: parameters, options: [])

let request = NSMutableURLRequest(url: NSURL(string: "https://api.apexverify.com/v1/unit")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "POST"
request.allHTTPHeaderFields = headers
request.httpBody = postData as Data

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```