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

# Get businesses

`GET /number-reputation/1/businesses`

## 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`
- 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`

Returns businesses registered under the customer's account with their current vetting status.

## Query parameters

- `businessName` string
- `status` 4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611PublicHiyaBusinessStatus[]
- `registeredFrom` string, date-time
- `registeredTo` string, date-time
- `page` integer
- `size` integer

## Response `200`

Success

- F0c12807aec90d20a332deb5d4c4ff89651a8119eb6a5fa7e1d6e803f3c0e71bHiyaBusinessPage
  - `results` Eb9826dda36bfa834ba8eec2d30e3749cbed4dee9bcabc5eb783ccaddacf60a3PublicBusiness[]: The list of the results for this page.
    - `businessId` string, uuid, required: Unique business identifier (UUID).
    - `legalName` string, required: Legal name of the business.
    - `primaryName` string, required: Primary/display name of the business.
    - `dunsNumber` string: DUNS number.
    - `einVatNumber` string: EIN (US) or VAT number.
    - `country` string, required: Country code in [ISO-3166-1 alpha-2](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes) format.
    - `region` string: State/province.
    - `city` string, required: City name.
    - `postcode` string: Postal/ZIP code.
    - `streetAddressLine1` string: Street address line 1.
    - `streetAddressLine2` string: Street address line 2.
    - `industry` 'ACCOUNTING_OR_FINANCE' | 'BILLING_AND_COLLECTIONS' | 'BUSINESS_SERVICES' | 'CHARITY_OR_FUNDRAISING' | 'COMMUNICATIONS' | 'CUSTOMER_SERVICE' | 'DELIVERY_OR_SHIPPING' | 'EDUCATION' | 'FINANCIAL_SERVICES' | 'GOVERNMENT_OR_PUBLIC_SERVICES' | 'HEALTHCARE_OR_PHARMACY' | 'INSURANCE' | 'LEGAL_SERVICES' | 'NOTIFICATIONS_OR_SCHEDULING' | 'REAL_ESTATE' | 'RETAIL' | 'SALES' | 'SOFTWARE_OR_TECHNOLOGY_OR_MEDIA' | 'SURVEYS_AND_MARKET_RESEARCH' | 'TRAVEL_OR_HOSPITALITY' | 'OTHER', required: Business industry.
    - `contact` Eb9826dda36bfa834ba8eec2d30e3749cbed4dee9bcabc5eb783ccaddacf60a3PublicContact: Primary contact details.
      - `firstName` string, required: Contact first name.
      - `lastName` string, required: Contact last name.
      - `email` string, required: Contact email address.
      - `title` string, required: Contact job title.
      - `phoneNumber` string, required: Contact phone number.
    - `numberOfEmployees` 'BETWEEN_1_AND_10' | 'BETWEEN_11_AND_50' | 'BETWEEN_51_AND_200' | 'BETWEEN_201_AND_500' | 'BETWEEN_501_AND_2000' | 'BETWEEN_2001_AND_10000' | 'MORE_THAN_10001', required: Employee count range.
    - `website` string, required: Business website URL.
    - `registered` string, date-time, required: Date and time when the business was registered.
    - `updated` string, date-time, required: Date and time when the business was last updated.
    - `status` 'PENDING' | 'REGISTERED' | 'ERROR_DUNS_MISMATCH' | 'UNKNOWN', required: Current vetting status.
    - `registeredTns` integer, required: Number of phone numbers registered under this business.
  - `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
- `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)