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

# Get File Verification Status

> Poll the processing status and result summary of an uploaded file.



## OpenAPI

````yaml /openapi-verifier.json get /verifyFileStatus/{file_id}
openapi: 3.1.0
info:
  title: Mailercloud Email Verifier API
  version: 1.0.0
  description: >-
    Verify email addresses programmatically — single/batch real-time
    verification and bulk file verification. Credit-based: each billable
    verification consumes one credit. Create API keys at
    [app.mailercloud.com/email-verifier/api-keys](https://app.mailercloud.com/email-verifier/api-keys).
servers:
  - url: https://verify.mailercloud.com
security:
  - bearerAuth: []
tags:
  - name: Verification
  - name: Bulk Files
paths:
  /verifyFileStatus/{file_id}:
    get:
      tags:
        - Bulk Files
      summary: Get File Verification Status
      description: Poll the processing status and result summary of an uploaded file.
      operationId: get-file-status
      parameters:
        - name: file_id
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: File status and result counts.
          content:
            application/json:
              schema:
                type: object
                properties:
                  file_id:
                    type: string
                  file_name:
                    type: string
                  status:
                    type: string
                  total_records:
                    type: integer
                  created_at:
                    type: string
                    format: date-time
                  deliverable:
                    type: integer
                  invalid:
                    type: integer
                  risky:
                    type: integer
        '401':
          description: Missing or invalid API key.
        '404':
          description: File not found.
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Your Email Verifier API key, sent as `Authorization: Bearer
        YOUR_API_KEY`. Create keys at
        [app.mailercloud.com/email-verifier/api-keys](https://app.mailercloud.com/email-verifier/api-keys).

````