---
title: "Get business phone numbers"
method: GET
path: "/number-reputation/1/businesses/{businessId}/numbers"
tags: ["channels", "voice", "number-reputation-hiya", "reputation-number-registration"]
---

# Get business phone numbers

`GET /number-reputation/1/businesses/{businessId}/numbers`

## Request

- Base URL: `https://api.infobip.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.infobip.com/number-reputation/1/businesses/{businessId}/numbers`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `Authorization`
  - HTTP basic
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`

Get phone numbers registered under a specific business.

## Path parameters

- `businessId` string, uuid, required

## Query parameters

- `phoneNumbers` string[]
- `jobName` string
- `status` 4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611PublicHiyaPhoneNumberStatus[]
- `reputationAvailable` 4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611PublicHiyaReputationAvailability[]
- `registeredFrom` string, date-time
- `registeredTo` string, date-time
- `lastUpdatedFrom` string, date-time
- `lastUpdatedTo` string, date-time
- `page` integer
- `size` integer

## Response `200`

Success

- F0c12807aec90d20a332deb5d4c4ff89651a8119eb6a5fa7e1d6e803f3c0e71bHiyaPhoneNumberPage
  - `results` Eb9826dda36bfa834ba8eec2d30e3749cbed4dee9bcabc5eb783ccaddacf60a3PublicPhoneNumber[]: The list of the results for this page.
    - `phoneNumber` string, required: Phone number.
    - `jobName` string: Registration job/batch name.
    - `registered` string, date-time: Date and time when the number was registered.
    - `status` 'PENDING' | 'REGISTERED' | 'NOT_FOUND' | 'ERROR_INVALID' | 'ERROR_REGISTERED' | 'ERROR_FRAUD' | 'ERROR_UNEXPECTED' | 'UNKNOWN', required: Current registration status.
    - `reputationAvailable` 'AVAILABLE' | 'UNAVAILABLE' | 'NOT_FOUND' | 'UNKNOWN': Whether reputation data is available for this number.
    - `currentReputation` Eb9826dda36bfa834ba8eec2d30e3749cbed4dee9bcabc5eb783ccaddacf60a3PublicReputationDetail: Last known reputation metrics.
      - `flagStatus` 'FLAGGED' | 'MIXED_HIGH' | 'MIXED_LOW' | 'UNFLAGGED' | 'UNKNOWN', required: Overall spam flag status.
      - `flagCategory` string: Category of spam flag (e.g. Telemarketer, Survey).
      - `maturityMetric` 'GOOD' | 'NORMAL' | 'POOR' | 'VERY_POOR' | 'UNKNOWN': Is the number well-established or fresh/new?
      - `desirabilityMetric` 'GOOD' | 'NORMAL' | 'POOR' | 'VERY_POOR' | 'UNKNOWN': Do recipients answer calls from this number?
      - `engagementMetric` 'GOOD' | 'NORMAL' | 'POOR' | 'VERY_POOR' | 'UNKNOWN': Do recipients stay on the line?
      - `reactionMetric` 'GOOD' | 'NORMAL' | 'POOR' | 'VERY_POOR' | 'UNKNOWN': Do recipients block or report the caller?
    - `lastUpdated` string, date-time: Date and time when the reputation was last refreshed.
  - `paging` 4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611PageInfo: Contains information about the page.
    - `page` integer, required: Requested page number.
    - `size` integer, required: Requested page size.
    - `totalPages` integer, required: The total number of pages of the results matching the requested parameters.
    - `totalResults` integer, required: The total number of the results matching the requested parameters.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `429`: Too Many Requests
- `500`: Internal Server Error
- `502`: Bad gateway

---

[API](https://skmtc.dev/infobip/apis/infobip-openapi-specification.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification/revisions/9dcbbaf902de?raw)