---
title: "In Request Bulk"
method: POST
path: "/v2/batch/query"
---

# In Request Bulk

`POST /v2/batch/query`

Discussions made regarding how to help the customer to correlation request and response objects:
- Respecting the natural order (requests vs. response)
- Using phone numbers as unique key
- Adding a correlation_id key

## Request body

- object
  - `phone_numbers` LookupBatchRequest[]
    - `correlation_id` string — Unique identifier used to match request with response
    - `phone_number` string, required
    - `fields` string[]
    - `country_code` string
    - `identity_match` IdentityMatchParameters
      - `first_name` string
      - `last_name` string
      - `address_line1` string
      - `address_line2` string
      - `city` string
      - `state` string
      - `postal_code` string
      - `address_country_code` string
      - `national_id` string
      - `date_of_birth` string
    - `reassigned_number` ReassignedNumberParameters
      - `last_verified_date` string
    - `sms_pumping_risk` RiskParameters
      - `partner_sub_id` string

## Response `200`

OK

- object
  - `phone_numbers` LookupBatchResponse[]
    - `correlation_id` string — Unique identifier used to match request with response
    - `twilio_error_code` integer — Twilio error code in case that the request to downstream fails
    - `calling_country_code` string
    - `country_code` string
    - `phone_number` string
    - `national_format` string
    - `valid` boolean
    - `validation_errors` string[]
    - `caller_name` CallerNameInfo
      - `caller_name` string
      - `caller_type` string
      - `error_code` integer
    - `sim_swap` SimSwapInfo
      - `last_sim_swap` LastSimSwapInfo
        - `last_sim_swap_date` string, date-time
        - `swapped_period` string
        - `swapped_in_period` boolean
      - `carrier_name` string
      - `mobile_country_code` string
      - `mobile_network_code` string
      - `error_code` integer
    - `call_forwarding` CallForwardingInfo
      - `call_forwarding_enabled` boolean
      - `error_code` integer
    - `line_type_intelligence` LineTypeIntelligenceInfo
      - `mobile_country_code` string
      - `mobile_network_code` string
      - `carrier_name` string
      - `type` string
      - `error_code` integer
    - `line_status` LineStatusInfo
      - `status` string
      - `error_code` integer
    - `identity_match` IdentityMatchInfo
      - `first_name_match` string
      - `last_name_match` string
      - `address_lines_match` string
      - `city_match` string
      - `state_match` string
      - `postal_code_match` string
      - `address_country_match` string
      - `national_id_match` string
      - `date_of_birth_match` string
      - `summary_score` integer
      - `error_code` integer
      - `error_message` string
    - `reassigned_number` ReassignedNumberInfo
      - `last_verified_date` string
      - `is_number_reassigned` string
      - `error_code` string
    - `sms_pumping_risk` SmsPumpingRiskInfo
      - `carrier_risk_category` string
      - `number_blocked` boolean
      - `number_blocked_date` string, date-time
      - `number_blocked_last_3_months` boolean
      - `sms_pumping_risk_score` integer
      - `error_code` integer
    - `phone_number_quality_score` unknown
    - `pre_fill` unknown

---

[API](https://skmtc.net/twilio/apis/lookups-v2.md) · [All operations](https://skmtc.net/twilio/apis/lookups-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twilio/lookups-v2/versions/306ca9c16537/schema)