---
title: Endpoint Specifications
description: "# API Reference ## Bulk Operations & Files ### POST /verifApiFile **Description:** Verify a file of email addresses. #### Parameters | Name | Type | Description | | --- | --- | --- | | secret | string | API…"
url: "https://verify550.com/documentation/endpoint-specifications-2/"
updated: "2025-10-11"
category: API Controller Documentation
---

# Endpoint Specifications

# API Reference

## Bulk Operations & Files

### POST /verifApiFile

**Description:** Verify a file of email addresses.

#### Parameters

| Name | Type | Description |
| --- | --- | --- |
| secret | string | API key |
| file | multipart/form-data | Email list file |

#### Responses

| Status | Body |
| --- | --- |
| 200 OK | ```json 10998 ``` |
| 401 Unauthorized | ``` Invalid key ``` |
| 402 Payment Required | ``` Insufficient credit ``` |

### POST /bulk

**Description:** Upload a bulk file for processing.

#### Parameters

| Name | Type | Description |
| --- | --- | --- |
| secret | string | API key |
| file | multipart/form-data | File to upload |

#### Responses

| Status | Body |
| --- | --- |
| 200 OK | ```json { "success": true, "id": 10952, "job_id": 1751481492, "message": "", "filename": "5kphones.csv" } ``` |
| 401 Unauthorized | ``` Invalid key ``` |
| 402 Payment Required | ``` Insufficient credit ``` |

### GET /file

**Description:** Download a processed file.

#### Parameters

| Name | Type | Description |
| --- | --- | --- |
| secret | string | API key |
| id | string | File ID |
| type | string | File type |

#### Responses

| Status | Body |
| --- | --- |
| 200 OK | ``` File content (binary) ``` |
| 401 Unauthorized | ``` Invalid key ``` |
| 404 Not Found | ``` File not found ``` |

### GET /fileOld

**Description:** Legacy endpoint for downloading processed files.

#### Parameters

| Name | Type | Description |
| --- | --- | --- |
| secret | string | API key |
| id | string | File ID |
| type | string | File type |

#### Responses

| Status | Body |
| --- | --- |
| 200 OK | ```json { "status": "success", "message": "File downloaded successfully", "file_url": "https://example.com/file.zip" } ``` |
| 400 Bad Request | ``` Missing parameters ``` |
| 401 Unauthorized | ``` Invalid key ``` |
| 404 Not Found | ``` File not found ``` |

## Zapier Integration Endpoints

### GET /zapier-auth

**Description:** Authenticates API keys for Zapier integration.

#### Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| api_key | string | Yes | User's API key |

#### Responses

| Status | Body |
| --- | --- |
| 200 OK | ```json { "status": "success", "message": "API Key is valid", "user_id": 12345, "key_name": "My Production Key" } ``` |
| 401 Unauthorized | ```json { "error": "Invalid API Key", "message": "The provided API Key is not valid" } ``` |

### POST /verify-single-email-zap

**Description:** Verifies a single email address via Zapier.

#### Parameters

| Parameter | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| api_key | Query | string | Yes | User's API key |
| email | Body | string | Yes | Email to verify |

#### Responses

| Status | Body |
| --- | --- |
| 200 OK | ```json { "status": "success", "verification_result": "valid", "timestamp": 1678901234 } ``` |
| 400 Bad Request | ```json { "status": "error", "code": 400, "error": "missing_parameters", "message": "Parameters "api_key" and "email" are required" } ``` |
| 401 Unauthorized | ```json { "status": "error", "code": 401, "error": "invalid_key", "message": "API key is not valid" } ``` |
| 402 Payment Required | ```json { "status": "error", "code": 402, "error": "insufficient_credit", "message": "Not enough credits" } ``` |
| 500 Server Error | ```json { "status": "error", "code": 500, "error": "verification_service_unavailable", "message": "Email verification service is currently unavailable" } ``` |

#### Verification Result Codes

| Code | Description |
| --- | --- |
| valid | Email address is valid |
| invalid | Email address is invalid |
| unknown | Verification status could not be determined |
| catch-all | Domain accepts all emails |
| disposable | Temporary/disposable email address |