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

# Look up a batch

> Looks up up to 10,000 numbers in one call. Results come back in the same order you sent them. Over the public URL, batches of 2,000 or fewer work best.



## OpenAPI

````yaml /openapi.json post /api/v1/verify
openapi: 3.0.3
info:
  title: Mobile Intel API
  version: '1'
  description: >-
    Look up US and Canadian (+1) phone numbers: line type, carrier, region and a
    valid, risky or invalid verdict. Every call needs your API key in the
    X-API-Key header and a real User-Agent header.
servers:
  - url: https://mobileintelapi.com
security:
  - apiKey: []
tags:
  - name: Lookup
  - name: Service
paths:
  /api/v1/verify:
    post:
      tags:
        - Lookup
      summary: Look up a batch
      description: >-
        Looks up up to 10,000 numbers in one call. Results come back in the same
        order you sent them. Over the public URL, batches of 2,000 or fewer work
        best.
      operationId: verifyBatch
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - numbers
              properties:
                numbers:
                  type: array
                  maxItems: 10000
                  items:
                    type: string
            example:
              numbers:
                - '+14169670000'
                - '2125550123'
      responses:
        '200':
          description: Results in input order.
          content:
            application/json:
              schema:
                type: object
                properties:
                  count:
                    type: integer
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/Result'
              example:
                count: 1
                results:
                  - status: success
                    phone: '+14169670000'
                    phone_valid: true
                    phone_type: fixed_line
                    phone_region: Toronto, ON
                    country: Canada
                    country_code: CA
                    country_prefix: '1'
                    international_number: +1 416-967-0000
                    local_number: (416) 967-0000
                    e164: '+14169670000'
                    carrier: Bell Ontario
                    mode: static
                    timezone:
                      - America/Toronto
                    geographical: true
                    verdict: valid
                    reasons:
                      - allocated fixed_line block, clean pattern
        '401':
          description: Missing or wrong API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                detail: invalid or missing X-API-Key
        '413':
          description: More than 10,000 numbers.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                detail: max 10000 numbers per batch
        '422':
          description: 'The body isn''t {"numbers": [...]}.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                detail:
                  - loc:
                      - body
                      - numbers
                    msg: Field required
                    type: missing
        '503':
          description: The key check is briefly unavailable. Retry shortly.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                detail: key store unreachable, try again shortly
components:
  schemas:
    Result:
      type: object
      properties:
        status:
          type: string
          example: success
        phone:
          type: string
          description: >-
            The number you sent, normalised to E.164 when it is a valid +1
            number.
        phone_valid:
          type: boolean
        phone_type:
          type: string
          enum:
            - mobile
            - fixed_line
            - voip
            - toll_free
            - premium_rate
            - unknown
          nullable: true
        phone_region:
          type: string
          nullable: true
        country:
          type: string
          nullable: true
        country_code:
          type: string
          nullable: true
        country_prefix:
          type: string
          nullable: true
        international_number:
          type: string
          nullable: true
          description: Display format, like +1 416-967-0000.
        local_number:
          type: string
          nullable: true
          description: Display format, like (416) 967-0000.
        e164:
          type: string
          nullable: true
          description: Normalised. Use this (or the input position) to match results.
        carrier:
          type: string
          nullable: true
          description: >-
            The carrier the number block was first allocated to. Ported numbers
            can show the old carrier.
        mode:
          type: string
          example: static
        timezone:
          type: array
          items:
            type: string
        geographical:
          type: boolean
          nullable: true
        verdict:
          type: string
          enum:
            - valid
            - risky
            - invalid
        reasons:
          type: array
          items:
            type: string
          description: Why the verdict was given.
    Error:
      type: object
      properties:
        detail:
          description: What went wrong.
          oneOf:
            - type: string
            - type: array
              items:
                type: object
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: X-API-Key
      description: Your API key from the dashboard.

````

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