> ## Documentation Index > Fetch the complete documentation index at: https://docs.mailglyph.com/llms.txt > Use this file to discover all available pages before exploring further. # List bulk email validations > List recent bulk Email Validation jobs with cursor pagination. ## OpenAPI ````yaml openapi.json GET /v1/verify/files openapi: 3.0.3 info: title: MailGlyph API description: >- Email platform API for transactional emails, campaigns, and marketing automation version: 1.0.0 contact: name: MailGlyph Support url: https://mailglyph.com servers: - url: https://api.mailglyph.com description: Production server security: - ApiKeyAuth: [] tags: - name: Public API description: Public API endpoints for sending emails and tracking events - name: Events description: Event ingestion and querying - name: Contacts description: Contact management operations - name: Templates description: Email template management - name: Campaigns description: Email campaign management - name: Segments description: Audience segmentation - name: Workflows description: Workflow automation paths: /v1/verify/files: get: tags: - Public API summary: List bulk email validation jobs description: >- List recent bulk email validation jobs for the project attached to the secret API key. operationId: listBulkEmailValidations parameters: - name: limit in: query required: false schema: type: integer minimum: 1 maximum: 100 default: 20 - name: cursor in: query required: false schema: type: string - name: search in: query required: false schema: type: string description: Search by original filename. - name: status in: query required: false schema: type: string enum: - QUEUED - UPLOADING - PROCESSING - COMPLETED - FAILED - ACTION_REQUIRED responses: '200': description: Bulk email validation jobs content: application/json: schema: type: object required: - success - data properties: success: type: boolean data: $ref: '#/components/schemas/BulkEmailValidationJobList' examples: jobs: summary: Bulk validation jobs value: success: true data: items: - id: 8a607588-1d7c-4d4f-9807-2a625fb20b14 status: COMPLETED originalFilename: emails_list_input.csv fileSizeBytes: 234 localEmailCount: 6 reservedCredits: 3 confirmedEmailCount: 6 creditUsed: 3 valid: 2 invalid: 1 unknown: 0 catchall: 0 duplicates: 2 spamTrap: 0 toxicDomains: 0 readyForDownload: true errorCode: null errorMessage: null lastValidationStatus: finished createdAt: '2026-06-18T10:12:30.000Z' updatedAt: '2026-06-18T10:14:05.000Z' completedAt: '2026-06-18T10:14:05.000Z' - id: 8a607588-1d7c-4d4f-9807-2a625fb20b14 status: PROCESSING originalFilename: emails_list_input.csv fileSizeBytes: 234 localEmailCount: 6 reservedCredits: 6 confirmedEmailCount: 6 creditUsed: null valid: 2 invalid: 1 unknown: 0 catchall: 0 duplicates: 2 spamTrap: 0 toxicDomains: 0 readyForDownload: false errorCode: null errorMessage: null lastValidationStatus: Started Processing createdAt: '2026-06-18T10:12:30.000Z' updatedAt: '2026-06-18T10:13:10.000Z' completedAt: null nextCursor: null '401': description: Invalid or missing secret API key content: application/json: schema: $ref: '#/components/schemas/Error' security: - ApiKeyAuth: [] components: schemas: BulkEmailValidationJobList: type: object required: - items - nextCursor properties: items: type: array items: $ref: '#/components/schemas/BulkEmailValidationJob' nextCursor: type: string nullable: true Error: type: object properties: code: type: integer error: type: string message: type: string time: type: integer BulkEmailValidationJob: type: object required: - id - status - originalFilename - fileSizeBytes - localEmailCount - reservedCredits - valid - invalid - unknown - catchall - duplicates - spamTrap - toxicDomains - readyForDownload - createdAt - updatedAt properties: id: type: string format: uuid description: MailGlyph file validation job ID. status: type: string enum: - QUEUED - UPLOADING - PROCESSING - COMPLETED - FAILED - ACTION_REQUIRED originalFilename: type: string fileSizeBytes: type: integer minimum: 0 localEmailCount: type: integer minimum: 0 description: Email count detected before validation processing. reservedCredits: type: integer minimum: 0 description: Credits currently reserved or finally used for this job. confirmedEmailCount: type: integer nullable: true minimum: 0 description: Confirmed total after processing starts. valid: type: integer minimum: 0 invalid: type: integer minimum: 0 unknown: type: integer minimum: 0 catchall: type: integer minimum: 0 duplicates: type: integer minimum: 0 spamTrap: type: integer minimum: 0 toxicDomains: type: integer minimum: 0 readyForDownload: type: boolean errorCode: type: string nullable: true errorMessage: type: string nullable: true createdAt: type: string format: date-time updatedAt: type: string format: date-time completedAt: type: string format: date-time nullable: true creditUsed: type: integer nullable: true minimum: 0 description: Final billable credit count when completed. lastValidationStatus: type: string nullable: true description: Latest validation processing status when available. securitySchemes: ApiKeyAuth: type: http scheme: bearer bearerFormat: API Key description: >- API Key authentication. **Secret keys (sk_*)** are required for all endpoints except `/v1/track`. **Public keys (pk_*)** only work with the `/v1/track` endpoint for client-side event tracking. Workspaces can have multiple active keys, and sender-domain operations enforce per-key domain scope when configured. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.