---
updatedAt: 2026-11-04T17:00:47.000Z
agentTools:
  projectIndex: https://docs.apollo.io/llms.txt
---

# [BETA] Validate email addresses and phone numbers

 

<table>
  <thead>
    <tr style="background-color :#FEFFD9; color:#000000">
      <th colspan="2" align="left">Endpoint essentials</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><strong>API key access</strong></td>
      <td><code>api/v1/enrich/create</code> or <code>Master API key</code></td>
    </tr>
    <tr>
      <td><strong>OAuth scopes</strong></td>
      <td>Not supported</td>
    </tr>
    <tr>
      <td><strong>Plan access</strong></td>
      <td>Requires a workspace on unified credits. Workspaces on a legacy credit plan receive a <code>403</code>.</td>
    </tr>
    <tr>
      <td><strong>Credit usage</strong></td>
      <td><code>8 or 20 credits per phone number, depending on plan</code>, <code>up to 1 credit per email address</code></td>
    </tr>
    <tr>
      <td colspan="2">
        Credits are charged for each row Apollo checks, whatever the verdict: 8 credits per phone number (20 on some earlier unified credit plans) and 1 credit per email address, including a <code>not_validated</code> result. An email check that the validator can't resolve costs 0 credits. Rows rejected in the <code>202</code> response, rows that fail before the check runs, and checks that the validator fails to run also cost 0 credits.<br><br>Before the checks run, Apollo confirms that you have enough credits for every accepted row. If you don't, no row is checked, each row returns a <code>credit_limit_exceeded</code> error, and the request consumes 0 credits.<br><br>Apollo stores each result for 30 days. If you check the same phone number or email address again within 30 days, you receive the stored result and the check is still charged. A value repeated inside one request is checked and charged once per row. Learn more about <a href="https://docs.apollo.io/docs/api-pricing">API pricing and credits</a>, or <a href="https://knowledge.apollo.io/hc/en-us/articles/9527776320781-Review-Credit-Usage-in-Apollo" target="_blank">review credit usage in Apollo</a>.
      </td>
    </tr>
  </tbody>
</table>

Validation checks whether an email address or phone number you already have is still good, so you can clean a list before you use it. Apollo runs the same validators that <a href="https://knowledge.apollo.io/hc/en-us/articles/34071089002509-Waterfall-Enrichment-Overview" target="_blank">waterfall enrichment</a> uses to verify the emails and phone numbers it finds.<br><br>Use this endpoint to validate up to 10 email addresses or up to 10 phone numbers in one request. Set `action` to `email_verifier` or `phone_verifier`, set `action_type` to `tool`, and pass one object per value in the `input_attributes` array: `{"email": "..."}` for email addresses, or `{"phone_number": "..."}` for phone numbers. One request validates one kind of value.<br><br>This endpoint checks values you send. It doesn't find new email addresses or phone numbers, and it doesn't check Do Not Call registry status. To find contact details for a person, use the <a href="https://docs.apollo.io/reference/bulk-people-enrichment">bulk people enrichment endpoint</a>.

### Validators

Apollo picks the validator for each `action`. Today, this endpoint uses these validators:

| `action`         | Validator |
| ---------------- | --------- |
| `email_verifier` | LeadMagic |
| `phone_verifier` | Trestle   |

Apollo plans to support more validators later. Each result names the validator that answered in its `validator` field.

### Getting the results

Validation runs in the background. This endpoint returns `202 Accepted` with a `request_id` and one entry per submitted row, in the order you sent them. Each entry has a `status` of `accepted` or `rejected`. Accepted entries carry a `record_id`, and rejected entries carry `errors`. A rejected row is never checked and costs nothing. The request `status` is `accepted` when every row was accepted and `partially_accepted` when some were rejected. If every row is rejected, the endpoint returns a `422` with `status: rejected`.

Send exactly one of these delivery options:

* `webhook_url`: Apollo sends the results to this HTTPS URL when the checks finish. The URL must resolve to a public address. If delivery fails, Apollo retries it up to 3 times. A `4xx` response other than `408` or `429` isn't retried.
* `poll_only: true`: Apollo doesn't send a webhook. Pass the `request_id` to the <a href="https://docs.apollo.io/reference/poll-webhook-result">poll webhook result endpoint</a>. While the checks run, it returns a `404` with `error_code: result_pending` and `retry_after_seconds`. Wait that many seconds, then poll again.

Both options deliver the same result object, and the poll webhook result endpoint returns it for 30 days, even if webhook delivery failed.

### Reading the results

Match each result to the row you sent by its `id`, which is the `record_id` from the `202` response. Results can come back in any order, and a row that wasn't checked doesn't include the email address or phone number.

| Field               | Meaning                                                                                                                                                                    |
| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `validation_status` | `validated` when the validator confirmed that the email address accepts mail or that the phone number is valid and reachable. `not_validated` when it didn't confirm that. |
| `validator`         | The validator that answered, such as `leadmagic` or `trestle`.                                                                                                             |
| `email` or `phone`  | The value that was checked.                                                                                                                                                |
| `error`             | Present when the row wasn't checked. `code` and `message` explain why, for example `credit_limit_exceeded` when your credits ran out.                                      |
| `data_sources`      | The validator step behind the result, including the validator's raw status and the credits it used.                                                                        |

`not_validated` doesn't mean that the value is bad. It also covers a validator that couldn't reach a verdict, such as an email domain that accepts mail for any address. Say that the check didn't confirm the value rather than calling it invalid.

A row with neither `validation_status` nor `error` means the validator couldn't run the check, for example because the email address is malformed. That row costs 0 credits.

Phone numbers aren't format-checked before they're sent to the validator, so a malformed phone number is still checked, returns `not_validated`, and is charged. Send phone numbers in E.164 format, such as `+12025550143`.

The request-level `status` is `success` when processing finished. It doesn't mean every row was validated, so check `total_failures` and each row's `validation_status` or `error`.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "apollo-rest-api",
    "summary": "Programmatic access to Apollo's sales intelligence and engagement platform — data enrichment, prospect and company search, and go-to-market workflow management.",
    "description": "The Apollo API provides programmatic access to [Apollo](https://www.apollo.io/), the all-in-one sales intelligence and engagement platform. Use it to enrich people and company data (individually or in bulk), search Apollo's database of over 240 million contacts and 30 million companies, and manage accounts, contacts, deals, sequences, tasks, calls, and conversations in your go-to-market workflows.\n\n## Base URL\n\nAll API requests are made to `https://api.apollo.io/api/v1`.\n\n## Authentication\n\n- **Apollo users** authenticate with an API key passed in the `x-api-key` request header. See [Create API Keys](https://docs.apollo.io/docs/create-api-key).\n- **Apollo partners** building integrations on behalf of mutual users authenticate with the [OAuth 2.0 authorization flow](https://docs.apollo.io/docs/use-oauth-20-authorization-flow-to-access-apollo-user-information-partners).\n\n## Rate limits & credits\n\nRate limits and credit consumption depend on your [Apollo pricing plan](https://docs.apollo.io/docs/api-pricing). Check your current limits and usage with the [view API usage stats and rate limits](https://docs.apollo.io/reference/view-api-usage-stats) endpoint. For more details, see [Rate Limits](https://docs.apollo.io/reference/rate-limits) and the [API FAQs](https://docs.apollo.io/docs/apollo-api-faqs).\n\nNew to the API? Start with the [Apollo API overview](https://docs.apollo.io/reference/apollo-api).",
    "termsOfService": "https://www.apollo.io/terms/api",
    "contact": {
      "name": "Apollo API Support",
      "url": "https://docs.apollo.io/"
    },
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://api.apollo.io/api/v1"
    }
  ],
  "tags": [
    {
      "name": "Enrichment",
      "description": "Enrich people and company records, individually or in bulk."
    }
  ],
  "components": {
    "securitySchemes": {
      "apiKey": {
        "type": "apiKey",
        "in": "header",
        "name": "x-api-key",
        "description": "[Recommended] API key, passed in the `x-api-key` request header.\nSee [Create API Keys](https://docs.apollo.io/docs/create-api-key)."
      },
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT",
        "description": "OAuth 2.0 access token, used by Apollo partners building integrations.\nSee the [OAuth 2.0 authorization flow](https://docs.apollo.io/docs/use-oauth-20-authorization-flow-to-access-apollo-user-information-partners)."
      }
    },
    "schemas": {
      "ErrorDetails": {
        "type": "object",
        "description": "Machine-readable detail for an error that uses the new format, returned alongside the endpoint's existing error fields. The legacy error fields at the root level (`error`, `error_code`, `message`, etc) are removed on 2027-02-16, after which `error_details` is the only error payload. Some errors already return `error_details` on its own.",
        "properties": {
          "code": {
            "type": "string",
            "description": "Stable identifier in the form `DOMAIN.CATEGORY.REASON`. Branch on this value; the human-readable `message` can change.",
            "example": "AUTH.AUTHENTICATION.CREDENTIALS_MISSING"
          },
          "message": {
            "type": "string",
            "description": "Human-readable explanation of what went wrong.",
            "example": "This request carried no credential Apollo could authenticate."
          },
          "suggestions": {
            "type": "array",
            "description": "Ordered, actionable next steps. Each entry carries a `label`, and where relevant the `parameter`, `header`, or `url` it refers to.",
            "items": {
              "type": "object",
              "properties": {
                "label": {
                  "type": "string",
                  "example": "Send your API key in the X-Api-Key header"
                },
                "url": {
                  "type": "string",
                  "example": "https://docs.apollo.io/reference/authentication"
                },
                "parameter": {
                  "type": "string",
                  "example": "webhook_url"
                },
                "parameters": {
                  "type": "array",
                  "description": "Several parameters, any one of which satisfies the requirement.",
                  "items": {
                    "type": "string"
                  },
                  "example": [
                    "name",
                    "domain",
                    "website_url",
                    "linkedin_url"
                  ]
                },
                "header": {
                  "type": "string",
                  "example": "X-Api-Key"
                },
                "example": {
                  "type": "string",
                  "description": "A valid sample value for the parameter named above."
                },
                "retry_after_seconds": {
                  "type": "integer",
                  "description": "On a rate-limit refusal, how long to wait before retrying.",
                  "example": 60
                }
              }
            }
          },
          "context": {
            "type": "object",
            "description": "Values from your request that explain the refusal. Each entry is an object rather than a bare value, so read `context.<key>.value`. Absent when the error needs no context.",
            "additionalProperties": {
              "type": "object",
              "properties": {
                "value": {
                  "oneOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "number"
                    },
                    {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    }
                  ]
                },
                "description": {
                  "type": "string"
                }
              }
            },
            "example": {
              "window": {
                "value": "hourly",
                "description": "The rate-limit window your request exceeded"
              }
            }
          }
        }
      }
    }
  },
  "security": [
    {
      "apiKey": []
    },
    {
      "bearerAuth": []
    }
  ],
  "paths": {
    "/enrich": {
      "post": {
        "summary": "[BETA] Validate email addresses and phone numbers",
        "description": "## Endpoint essentials\n\n**API key access:** `api/v1/enrich/create` or `Master API key`\n\n**OAuth scopes:** Not supported\n\n**Plan access:** Requires a workspace on unified credits. Workspaces on a legacy credit plan receive a `403`.\n\n**Credit usage:** `8 or 20 credits per phone number, depending on plan`, `up to 1 credit per email address`\n\nCredits are charged for each row Apollo checks, whatever the verdict: 8 credits per phone number (20 on some earlier unified credit plans) and 1 credit per email address, including a `not_validated` result. An email check that the validator can't resolve costs 0 credits. Rows rejected in the `202` response, rows that fail before the check runs, and checks that the validator fails to run also cost 0 credits.\n\nBefore the checks run, Apollo confirms that you have enough credits for every accepted row. If you don't, no row is checked, each row returns a `credit_limit_exceeded` error, and the request consumes 0 credits.\n\nApollo stores each result for 30 days. If you check the same phone number or email address again within 30 days, you receive the stored result and the check is still charged. A value repeated inside one request is checked and charged once per row. Learn more about [API pricing and credits](https://docs.apollo.io/docs/api-pricing), or <a href=\"https://knowledge.apollo.io/hc/en-us/articles/9527776320781-Review-Credit-Usage-in-Apollo\" target=\"_blank\">review credit usage in Apollo</a>.\n\nValidation checks whether an email address or phone number you already have is still good, so you can clean a list before you use it. Apollo runs the same validators that <a href=\"https://knowledge.apollo.io/hc/en-us/articles/34071089002509-Waterfall-Enrichment-Overview\" target=\"_blank\">waterfall enrichment</a> uses to verify the emails and phone numbers it finds.<br><br>Use this endpoint to validate up to 10 email addresses or up to 10 phone numbers in one request. Set `action` to `email_verifier` or `phone_verifier`, set `action_type` to `tool`, and pass one object per value in the `input_attributes` array: `{\"email\": \"...\"}` for email addresses, or `{\"phone_number\": \"...\"}` for phone numbers. One request validates one kind of value.<br><br>This endpoint checks values you send. It doesn't find new email addresses or phone numbers, and it doesn't check Do Not Call registry status. To find contact details for a person, use the <a href=\"https://docs.apollo.io/reference/bulk-people-enrichment\">bulk people enrichment endpoint</a>.\n\n### Validators\n\nApollo picks the validator for each `action`. Today, this endpoint uses these validators:\n\n| `action` | Validator |\n|---|---|\n| `email_verifier` | LeadMagic |\n| `phone_verifier` | Trestle |\n\nApollo plans to support more validators later. Each result names the validator that answered in its `validator` field.\n\n### Getting the results\n\nValidation runs in the background. This endpoint returns `202 Accepted` with a `request_id` and one entry per submitted row, in the order you sent them. Each entry has a `status` of `accepted` or `rejected`. Accepted entries carry a `record_id`, and rejected entries carry `errors`. A rejected row is never checked and costs nothing. The request `status` is `accepted` when every row was accepted and `partially_accepted` when some were rejected. If every row is rejected, the endpoint returns a `422` with `status: rejected`.\n\nSend exactly one of these delivery options:\n\n- `webhook_url`: Apollo sends the results to this HTTPS URL when the checks finish. The URL must resolve to a public address. If delivery fails, Apollo retries it up to 3 times. A `4xx` response other than `408` or `429` isn't retried.\n- `poll_only: true`: Apollo doesn't send a webhook. Pass the `request_id` to the <a href=\"https://docs.apollo.io/reference/poll-webhook-result\">poll webhook result endpoint</a>. While the checks run, it returns a `404` with `error_code: result_pending` and `retry_after_seconds`. Wait that many seconds, then poll again.\n\nBoth options deliver the same result object, and the poll webhook result endpoint returns it for 30 days, even if webhook delivery failed.\n\n### Reading the results\n\nMatch each result to the row you sent by its `id`, which is the `record_id` from the `202` response. Results can come back in any order, and a row that wasn't checked doesn't include the email address or phone number.\n\n| Field | Meaning |\n|---|---|\n| `validation_status` | `validated` when the validator confirmed that the email address accepts mail or that the phone number is valid and reachable. `not_validated` when it didn't confirm that. |\n| `validator` | The validator that answered, such as `leadmagic` or `trestle`. |\n| `email` or `phone` | The value that was checked. |\n| `error` | Present when the row wasn't checked. `code` and `message` explain why, for example `credit_limit_exceeded` when your credits ran out. |\n| `data_sources` | The validator step behind the result, including the validator's raw status and the credits it used. |\n\n`not_validated` doesn't mean that the value is bad. It also covers a validator that couldn't reach a verdict, such as an email domain that accepts mail for any address. Say that the check didn't confirm the value rather than calling it invalid.\n\nA row with neither `validation_status` nor `error` means the validator couldn't run the check, for example because the email address is malformed. That row costs 0 credits.\n\nPhone numbers aren't format-checked before they're sent to the validator, so a malformed phone number is still checked, returns `not_validated`, and is charged. Send phone numbers in E.164 format, such as `+12025550143`.\n\nThe request-level `status` is `success` when processing finished. It doesn't mean every row was validated, so check `total_failures` and each row's `validation_status` or `error`.",
        "operationId": "validate-emails-and-phone-numbers",
        "tags": [
          "Enrichment"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "action",
                  "action_type",
                  "input_attributes"
                ],
                "properties": {
                  "action": {
                    "type": "string",
                    "enum": [
                      "email_verifier",
                      "phone_verifier"
                    ],
                    "description": "What to validate. Use `email_verifier` for email addresses or `phone_verifier` for phone numbers."
                  },
                  "action_type": {
                    "type": "string",
                    "enum": [
                      "tool"
                    ],
                    "description": "Set to `tool`."
                  },
                  "input_attributes": {
                    "type": "array",
                    "maxItems": 10,
                    "description": "The values to validate, one object per value, up to 10 objects. Send `email` objects with `email_verifier` and `phone_number` objects with `phone_verifier`. A row without the field the action needs is rejected.",
                    "items": {
                      "type": "object",
                      "properties": {
                        "email": {
                          "type": "string",
                          "description": "An email address to validate. <br><br>Example: `jane.doe@example.com`"
                        },
                        "phone_number": {
                          "type": "string",
                          "description": "A phone number to validate, in E.164 format. Phone numbers are not format-checked, so a malformed number is still checked and charged. <br><br>Example: `+12025550143`"
                        }
                      }
                    }
                  },
                  "webhook_url": {
                    "type": "string",
                    "description": "The HTTPS URL where Apollo sends the results when the checks finish. It must resolve to a public address. Required unless `poll_only` is `true`. Do not send it together with `poll_only: true`."
                  },
                  "poll_only": {
                    "type": "boolean",
                    "default": false,
                    "description": "Set to `true` to retrieve the results with the <a href=\"https://docs.apollo.io/reference/poll-webhook-result\">poll webhook result</a> endpoint instead of a webhook. When `poll_only` is `true`, omit `webhook_url`."
                  }
                }
              },
              "examples": {
                "Validate email addresses (poll)": {
                  "value": {
                    "action": "email_verifier",
                    "action_type": "tool",
                    "poll_only": true,
                    "input_attributes": [
                      {
                        "email": "jane.doe@example.com"
                      },
                      {
                        "email": "sam.lee@example.org"
                      }
                    ]
                  }
                },
                "Validate phone numbers (webhook)": {
                  "value": {
                    "action": "phone_verifier",
                    "action_type": "tool",
                    "webhook_url": "https://example.com/apollo/validation",
                    "input_attributes": [
                      {
                        "phone_number": "+12025550143"
                      },
                      {
                        "phone_number": "+12025550178"
                      }
                    ]
                  }
                }
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "202",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "request_id": {
                      "type": "string",
                      "description": "The ID of this request. Pass it to the poll webhook result endpoint.",
                      "example": "5139398567364803549"
                    },
                    "status": {
                      "type": "string",
                      "enum": [
                        "accepted",
                        "partially_accepted",
                        "rejected"
                      ],
                      "description": "`accepted` when every row was accepted, `partially_accepted` when some were rejected, and `rejected` (with a `422`) when every row was rejected."
                    },
                    "total_submitted": {
                      "type": "integer",
                      "description": "The number of rows you sent."
                    },
                    "accepted_count": {
                      "type": "integer",
                      "description": "The number of rows that will be checked."
                    },
                    "rejected_count": {
                      "type": "integer",
                      "description": "The number of rows that were rejected."
                    },
                    "results": {
                      "type": "array",
                      "description": "One entry per row you sent, in the order you sent them.",
                      "items": {
                        "type": "object",
                        "properties": {
                          "status": {
                            "type": "string",
                            "enum": [
                              "accepted",
                              "rejected"
                            ],
                            "description": "`accepted` when the row will be checked. `rejected` when it was refused and will not be checked or charged."
                          },
                          "record_id": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "The ID of the accepted row. The matching result carries this value as its `id`. `null` for a rejected row."
                          },
                          "errors": {
                            "type": [
                              "array",
                              "null"
                            ],
                            "items": {
                              "type": "string"
                            },
                            "description": "Why the row was rejected. `null` for an accepted row."
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "Partially accepted": {
                    "value": {
                      "request_id": "5139398567364803549",
                      "status": "partially_accepted",
                      "total_submitted": 2,
                      "accepted_count": 1,
                      "rejected_count": 1,
                      "results": [
                        {
                          "status": "accepted",
                          "record_id": "6a1f0c2e9b3d4a0012c4e8f1",
                          "errors": null
                        },
                        {
                          "status": "rejected",
                          "record_id": null,
                          "errors": [
                            "input provides no usable identifier; supply at least one of: email"
                          ]
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "401",
            "content": {
              "text/plain": {
                "examples": {
                  "Check API key": {
                    "value": "Invalid API key. See https://docs.apollo.io/reference/authentication for how to authenticate."
                  }
                }
              }
            }
          },
          "403": {
            "description": "403",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string",
                      "description": "A message that explains the error."
                    },
                    "request_id": {
                      "type": "string",
                      "description": "The ID of the request that failed."
                    },
                    "error_code": {
                      "type": "string",
                      "description": "Returned when the API key does not include this endpoint."
                    },
                    "error_details": {
                      "$ref": "#/components/schemas/ErrorDetails"
                    }
                  }
                },
                "examples": {
                  "API key without access to this endpoint": {
                    "value": {
                      "error": "This API key is not authorized to access api/v1/enrich/create. Request an API key from your administrator that includes this endpoint in its configured scope.",
                      "error_code": "API_INACCESSIBLE",
                      "error_details": {
                        "code": "AUTH.AUTHORIZATION.ENDPOINT_ACCESS_DENIED",
                        "message": "Your team is not permitted to call this endpoint.",
                        "suggestions": [
                          {
                            "label": "Contact support@apollo.io if you need access to this endpoint",
                            "url": "https://knowledge.apollo.io"
                          }
                        ],
                        "context": {
                          "endpoint": {
                            "value": "api/v1/enrich/create",
                            "description": "The endpoint your request named"
                          }
                        }
                      }
                    }
                  },
                  "Validation not enabled": {
                    "value": {
                      "error": "You do not have access to this verification tool.",
                      "request_id": "5139398567364803549"
                    }
                  },
                  "Legacy credit plan": {
                    "value": {
                      "error": "This tool is available only to teams on unified credits.",
                      "request_id": "5139398567364803549"
                    }
                  },
                  "Unsupported action": {
                    "value": {
                      "error": "Your team does not have access to waterfall enrichment.",
                      "request_id": "5139398567364803549"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "422",
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "title": "Every row rejected",
                      "type": "object",
                      "properties": {
                        "request_id": {
                          "type": "string",
                          "description": "The ID of this request. Pass it to the poll webhook result endpoint.",
                          "example": "5139398567364803549"
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "accepted",
                            "partially_accepted",
                            "rejected"
                          ],
                          "description": "`accepted` when every row was accepted, `partially_accepted` when some were rejected, and `rejected` (with a `422`) when every row was rejected."
                        },
                        "total_submitted": {
                          "type": "integer",
                          "description": "The number of rows you sent."
                        },
                        "accepted_count": {
                          "type": "integer",
                          "description": "The number of rows that will be checked."
                        },
                        "rejected_count": {
                          "type": "integer",
                          "description": "The number of rows that were rejected."
                        },
                        "results": {
                          "type": "array",
                          "description": "One entry per row you sent, in the order you sent them.",
                          "items": {
                            "type": "object",
                            "properties": {
                              "status": {
                                "type": "string",
                                "enum": [
                                  "accepted",
                                  "rejected"
                                ],
                                "description": "`accepted` when the row will be checked. `rejected` when it was refused and will not be checked or charged."
                              },
                              "record_id": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "The ID of the accepted row. The matching result carries this value as its `id`. `null` for a rejected row."
                              },
                              "errors": {
                                "type": [
                                  "array",
                                  "null"
                                ],
                                "items": {
                                  "type": "string"
                                },
                                "description": "Why the row was rejected. `null` for an accepted row."
                              }
                            }
                          }
                        }
                      }
                    },
                    {
                      "title": "Invalid request",
                      "type": "object",
                      "properties": {
                        "error": {
                          "type": "string",
                          "description": "A message that explains the error."
                        },
                        "request_id": {
                          "type": "string",
                          "description": "The ID of the request that failed."
                        }
                      }
                    }
                  ]
                },
                "examples": {
                  "Every row rejected": {
                    "value": {
                      "request_id": "5139398567364803549",
                      "status": "rejected",
                      "total_submitted": 1,
                      "accepted_count": 0,
                      "rejected_count": 1,
                      "results": [
                        {
                          "status": "rejected",
                          "record_id": null,
                          "errors": [
                            "input provides no usable identifier; supply at least one of: email"
                          ]
                        }
                      ]
                    }
                  },
                  "More than 10 rows": {
                    "value": {
                      "error": "input_attributes accepts at most 10 records per request",
                      "request_id": "5139398567364803549"
                    }
                  },
                  "No delivery option": {
                    "value": {
                      "error": "webhook_url is required",
                      "request_id": "5139398567364803549"
                    }
                  },
                  "webhook_url with poll_only": {
                    "value": {
                      "error": "Do not pass 'webhook_url' with poll_only=true",
                      "request_id": "5139398567364803549"
                    }
                  },
                  "webhook_url not HTTPS": {
                    "value": {
                      "error": "webhook_url must use HTTPS",
                      "request_id": "5139398567364803549"
                    }
                  },
                  "webhook_url not public": {
                    "value": {
                      "error": "webhook_url must not point to an internal address",
                      "request_id": "5139398567364803549"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "429",
            "content": {
              "application/json": {
                "examples": {
                  "Too many requests": {
                    "value": "{\n  \"message\": \"The maximum number of api calls allowed for api/v1/enrich/create is 100 times per hour. Please upgrade your plan from https://app.apollo.io/#/settings/plans/upgrade.\",\n  \"error_details\": {\n    \"code\": \"USAGE.RATE_LIMIT.API_RATE_LIMIT_EXCEEDED\",\n    \"message\": \"You have made more API requests than your plan allows in this time window.\",\n    \"suggestions\": [\n      {\n        \"label\": \"Wait until the rate limit resets, then retry the API request.\"\n      },\n      {\n        \"label\": \"Check the Apollo Docs to understand API rate limits and how to use response headers to prevent rate-limit errors.\",\n        \"url\": \"https://docs.apollo.io/reference/rate-limits\"\n      }\n    ],\n    \"context\": {\n      \"window\": {\n        \"value\": \"hour\",\n        \"description\": \"The rate limit window that was exhausted, such as \\\"minute\\\" or \\\"hour\\\"\"\n      }\n    }\n  }\n}"
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [
      {
        "key": "Cache-Control",
        "value": "no-cache"
      },
      {
        "key": "Content-Type",
        "value": "application/json"
      }
    ],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```