---
title: "Gets the validation result of a batch of phone numbers."
method: GET
path: "/phone/bulk/v1/batches/{batch_id}/results"
tags: ["Bulk Phone"]
---

# Gets the validation result of a batch of phone numbers.

`GET /phone/bulk/v1/batches/{batch_id}/results`

## Request

- Base URL: `https://api.experianaperture.io`
- URL: `https://api.experianaperture.io/phone/bulk/v1/batches/{batch_id}/results`
- Auth: one of:
  - HTTP bearer
  - API key in header `Auth-Token`
- TypeScript: <https://skmtc.dev/experianaperture/apis/aperture-rest-api/docs/phone/bulk/v1/batches/:batch_id/results/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `batch_id` string, required

## Headers

- `Reference-Id` string
- `Add-Metadata` boolean

## Response `200`

OK

- BulkPhoneV1GetBatchResultsResponse: Bulk Phone V1 Get Results response.
  - `error` ResponseError: Error model containing the error details.
    - `type` string, nullable: A link to documentation that provides more details about the error you’ve encountered.
    - `title` string, nullable: The title of the error.
    - `detail` string, nullable: A description of the error.
    - `instance` string, nullable: The endpoint that returned the error.
  - `result` BulkPhoneV1GetBatchResultsResult: Bulk Phone V1 Get Batch Results result.
    - `batch_id` string, nullable: Batch ID.
    - `batch_reference_id` string, nullable: Optional reference identifier to track this batch.
    - `credits_charged` integer: The number of credits charged for this Batch.
    - `status` string, nullable: The current Batch status.
    - `reason` string, nullable: The reason of the current Batch status.
    - `statistics` BulkPhoneV1GetBatchResultsResponseStatistic[], nullable: The statistics of the phone numbers confidence level.
      - `name` string, nullable: Confidence.
      - `value` integer: Count.
    - `phones` BulkPhoneV1GetBatchResultsResponsePhone[], nullable: The phones validation results.
      - `number` string, nullable: The phone number that is the subject of the validation.
      - `validated_phone_number` string, nullable: The validated phone number. Also includes the international country calling code. Note that this field is returned even if the phone number has a confidence status of "Invalid".
      - `formatted_phone_number` string, nullable: The phone number in the format you specified in "output_format".
      - `phone_type` string, nullable: The type of phone number. Note: Landline is only supported in North America.
      - `confidence` string, nullable: The outcome (confidence level) of the validation.
      - `ported_date` string, nullable: The date the phone number was last ported, returned only if the number has been moved to a different network. This is an optional field and is included only when get_ported_date is set to true, which incurs an additional click.
      - `disposable_number` string, nullable: Indicates whether the phone number is a disposable number based on lookup list of disposable numbers. If the number can be found in the lookup list, the value returned will be "Yes". Otherwise, the value returned will be "Unknown". This value would be returned if the get_disposable_number boolean is set to true.
      - `metadata` BulkPhoneV1GetBatchResultsResponsePhoneMetadata: Metadata fields and values that can be returned, in addition to the main core information.
        - `original_operator_name` string, nullable: The name of the MSISDN operator where the phone number was originally registered.
        - `original_network_status` string, nullable: The status of the network where the phone number was originally registered.
        - `original_home_network_identity` string, nullable: The Mobile Country Code (MCC) and Mobile Network Code (MNC) where the phone number was originally registered.
        - `original_country_prefix` string, nullable: The international calling code of the country where the phone number was originally registered.
        - `original_country_name` string, nullable: The name of the country where the phone number was originally registered.
        - `original_country_iso` string, nullable: The 3-letter ISO code of the country where the phone number was originally registered.
        - `operator_name` string, nullable: The name of the MSISDN operator where the phone number is currently registered.
        - `network_status` string, nullable: The status of the network where the phone number is currently registered.
        - `home_network_identity` string, nullable: The Mobile Country Code (MCC) and Mobile Network Code (MNC) where the phone number is currently registered.
        - `country_prefix` string, nullable: The international calling code of the country where the phone number is currently registered.
        - `country_name` string, nullable: The name of the country where the phone number is currently registered.
        - `country_iso` string, nullable: The 3-letter ISO code of the country where the phone number is currently registered.
        - `is_ported` string, nullable: Indicates whether the phone number is ported or not.
        - `email_to_sms_address` string, nullable: Email address which can be used to send SMS messages to this phone number.
        - `email_to_mms_address` string, nullable: Email address which can be used to send MMS messages to this phone number.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `406`: Not Acceptable
- `408`: Request Timeout
- `429`: Too Many Requests
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/experianaperture/apis/aperture-rest-api.md) - [All operations](https://skmtc.dev/experianaperture/apis/aperture-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/experianaperture/apis/aperture-rest-api/revisions/e762934f3de5?raw)