---
title: "Searches for providers for the specified phone number"
method: GET
path: "/check_phone_number"
tags: ["Misc"]
---

# Searches for providers for the specified phone number

`GET /check_phone_number`

## Query parameters

- `phone_number` string, required
- `operator` string

## Response `200`

Success. There's some situations where we can't figure out the operator of the phone number
so we return a list of possible ones instead of a single match.

- object
  - `meta` object
    - `phone_number` string
    - `operator` string
    - `_endpoint` string
  - `data` union — Product-like object, or list of Product-like objects.
    - Product
      - `id` string
      - `name` string
      - `country_code` string
      - `country_name` string
      - `currency` string
      - `created_time` string
      - `recipient_type` string
      - `image` string
      - `in_stock` boolean
      - `packages` object
        - `id` string
        - `value` string
        - `price` number — Price of the package in the user's currency.
      - `range` object
        - `min` number
        - `max` number
        - `step` number
        - `price_rate` number — Price rate between the product currency and the user's currency.
    - Product[]
      - `id` string
      - `name` string
      - `country_code` string
      - `country_name` string
      - `currency` string
      - `created_time` string
      - `recipient_type` string
      - `image` string
      - `in_stock` boolean
      - `packages` object
        - `id` string
        - `value` string
        - `price` number — Price of the package in the user's currency.
      - `range` object
        - `min` number
        - `max` number
        - `step` number
        - `price_rate` number — Price rate between the product currency and the user's currency.
  - `operator_found` boolean — This can be used to know if the 'data' field is going to be an object or a list of objects.
  - `message` string

## Other responses

- `400` — Bad request. Missing parameters.
- `404` — Unable to find any providers for the specified phone number.
- `429` — Too many request. Check rate limit headers.

---

[API](https://skmtc.dev/bitrefill/apis/bitrefill-api-documentation.md) · [All operations](https://skmtc.dev/bitrefill/apis/bitrefill-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bitrefill/bitrefill-api-documentation/revisions/09e1bde6bae5/schema)