---
agentTools:
  projectIndex: https://validto.readme.io/llms.txt
---

# Verify a bulk validation list

The verification of the bulk validation list can be initiated using this endpoint. You can initiate verification once the progress of the list is ‘ready’ for verification, also the auto_verify was not enabled. After initiating verification you can examine the progress of the email list, once the verification of the list turns to ‘completed’ you can download your results.

## Response

```json
HTTP/1.1 200 OK
{
    "job_id": "pb49raml26hlkyuaykopl6wtg58k6vssq5t0w",
    "success": true,
    "message": "Job verification will be attempted shortly. Call /status endpoint to know the status of the Job"
}
```

## Response parameters

| Parameter       | Type           | Definition                                                           |
| :-------------- | :------------- | :------------------------------------------------------------------- |
| **`"job_id"`**  | \[string]      | The job\_id corresponding to the list you need to start verification |
| **`"success"`** | \[true, false] | Whether the API request call was successful or not.                  |
| **`"message"`** | \[string]      | Describes the start result                                           |

> 🚧 Verification cannot stop
>
> The bulk validation email list can initiate verification only once. Once verification started, not able to stop, pause, or cancel the on-going verification. Also the verification cannot restart again for the same list.

## Other Responses

The response you get when the API key is invalid:

```json
HTTP/1.1 401 Unauthorized
{   
   "result":"Invalid API Key",
   "success": false
}
```

The response you get when you provide invalid job\_id:

```json
HTTP/1.1 400 BadRequest
{
    "result": "Job not found. Invalid jobId",
    "success": false
}
```

The response you get when your account is under review or restricted:

```json
HTTP/1.1 400 BadRequest
{
    "result": "Verify restricted",
    "success": false
}
```

The response you get when the verification already started:

```json
HTTP/1.1 400 BadRequest
{
    "result": "Verification has already started.",
    "success": false
}
```

The response you get when you have insufficient credit to begin verification:

```json
HTTP/1.1 HTTP/1.1 402 Payment Required
{
    "result": "Insufficient verification credits. Please order a plan.",
    "success": false
}
```

The response you get when the job not found:

```json
HTTP/1.1 400 BadRequest
{
    "result": "Job not found.",
    "success": false
}
```

The response you get when then job is preparing for verification:

```json
HTTP/1.1 400 BadRequest
{
    "result": "Job is not ready for verification, please call the /status endpoint and start verification once the status of the job turns to ready.",
    "success": false
}
```

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Bulk Validation",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://api.validto.com/v1/"
    }
  ],
  "security": [
    {}
  ],
  "paths": {
    "/bulk/{job_id}": {
      "patch": {
        "summary": "Verify a bulk validation list",
        "description": "The verification of the bulk validation list can be initiated using this endpoint. You can initiate verification once the progress of the list is ‘ready’ for verification, also the auto_verify was not enabled. After initiating verification you can examine the progress of the email list, once the verification of the list turns to ‘completed’ you can download your results.",
        "operationId": "verify-a-bulk-validation-list",
        "parameters": [
          {
            "name": "job_id",
            "in": "path",
            "description": "The jobId corresponding to the list you need to start verification",
            "schema": {
              "type": "string"
            },
            "required": true
          },
          {
            "name": "apikey",
            "in": "query",
            "description": "API key",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "RAW_BODY": {
                    "type": "string",
                    "description": "The required action to start the verification",
                    "default": "{ \"action\" : \"start\" }",
                    "format": "json"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "HTTP/1.1 200 OK\n{\n    \"job_id\": \"pb49raml26hlkyuaykopl6wtg58k6vssq5t0w\",\n    \"success\": true,\n    \"message\": \"Job verification will be attempted shortly. Call /status endpoint to know the status of the Job\"\n}"
                  }
                }
              }
            }
          }
        },
        "deprecated": false,
        "x-readme": {
          "code-samples": [
            {
              "language": "node",
              "code": "var request = require('request');\nvar options = {\n  'method': 'PATCH',\n  // Replace jobId with your list's jobId and replace API_KEY with your API Key\n  'url': 'https://api.validto.com/v1//bulk/jobId?apikey=API_KEY',\n  'headers': {\n  },\n  'body': JSON.stringify({\n    'action': 'start'\n  })\n};\nrequest(options, function (error, response) {\n  if (error) throw new Error(error);\n  console.log(response.body);\n});"
            },
            {
              "language": "go",
              "code": "New! Keyboard shortcuts … Drive keyboard shortcuts have been updated to give you first-letters navigation\ngo_API_bulk_start.go\npackage main\n\nimport (\n  \"fmt\"\n  \"net/http\"\n  \"io/ioutil\"\n)\n\nfunc main() {\n // Replace jobId with your list's jobId and API_KEY with your API Key\n  url := \"https://api.validto.com/v1/bulk/{job_id}?apikey=API_KEY\"\n  method := \"PATCH\"\n\n  client := &http.Client {\n  }\n  req, err := http.NewRequest(method, url, nil)\n\n  if err != nil {\n    fmt.Println(err)\n    return\n  }\n\n  res, err := client.Do(req)\n  if err != nil {\n    fmt.Println(err)\n    return\n  }\n  defer res.Body.Close()\n\n  body, err := ioutil.ReadAll(res.Body)\n  if err != nil {\n    fmt.Println(err)\n    return\n  }\n  fmt.Println(string(body))\n}"
            }
          ],
          "samples-languages": [
            "node",
            "go"
          ]
        }
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": false,
    "proxy-enabled": false
  },
  "x-readme-fauxas": true,
  "_id": "615ea5d6a644b300e1b0011a:615d3fe24eb9f50010a458db"
}
```