INinfobip
channels
voice
number-reputation-hiya
business-registration

Register a new business

Register a new business for verification. A business must be registered and vetted before phone numbers can be added to it.

post/number-reputation/1/businesses

Request

  • Base URL
    https://api.infobip.com (the document declares no server; this is the origin it was published from)
  • Auth
    • API key in header Authorization
    • or API key in header Authorization
    • or HTTP basic
    • or OAuth 2
      Client credentials
      Token URL: https://api.infobip.com/auth/1/oauth2/token

Request body

legalNamestring required

Legal name of the business.

primaryNamestring required

Primary/display name of the business.

dunsNumberstring

DUNS number.

einVatNumberstring

EIN (US) or VAT number.

countrystring required

Country code in ISO-3166-1 alpha-2 format.

regionstring

State/province or territory. Required for US and CA businesses, using the two-character state code (e.g. NY, WA) or territory code (e.g. ON, BC). Ignored for all other countries.

citystring required

City name.

postcodestring

Postal/ZIP code.

streetAddressLine1string

Street address line 1.

streetAddressLine2string

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.

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.

websitestring required

Business website URL.

authorizedboolean required

Confirmation that the caller is authorized to register this business.

Example request

{
  "legalName": "Example Corp",
  "primaryName": "Example",
  "dunsNumber": "123456789",
  "einVatNumber": "12-3456789",
  "country": "US",
  "region": "NY",
  "city": "San Francisco",
  "postcode": "94105",
  "streetAddressLine1": "123 Main St",
  "streetAddressLine2": "Suite 100",
  "contact": {
    "firstName": "John",
    "lastName": "Doe",
    "email": "john.doe@example.com",
    "title": "CTO",
    "phoneNumber": "14155551234"
  },
  "website": "https://example.com",
  "authorized": true
}

Response

Success

businessIdstring uuid required

Unique business identifier (UUID).

Example response

{
  "businessId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Changes

No recorded changes to this operation across all 1 revision of this API.