---
title: "Get a single company or a list of companies"
method: GET
path: "/people/2/companies"
tags: ["customer-engagement", "people", "company-profile"]
---

# Get a single company or a list of companies

`GET /people/2/companies`

## 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/people/2/companies`
- Auth: one of:
  - HTTP basic
  - API key in header `Authorization`
  - API key in header `Authorization`
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`

Use this method with a query parameter to get a single company. If the query parameter is not specified, this method will return a list of companies.

## Query parameters

- `name` string
- `id` integer
- `externalId` string
- `domain` string
- `limit` integer
- `page` integer
- `includeTotalCount` boolean
- `orderBy` string
- `filter` string

## Response `200`

successful response

- F1f4d23441e1a2e5d9e00e8bea59bdb50b3ee0c91558c0dac55f3a711b5f2d3fCompaniesResponse
  - `companies` F1f4d23441e1a2e5d9e00e8bea59bdb50b3ee0c91558c0dac55f3a711b5f2d3fIamCompanyV2[]: List of companies.
    - `accountManager` string: Account manager.
    - `country` string: Country.
    - `createdAt` string: Date and time of creation. Has the following format: yyyy-MM-dd'T'HH:mm:ss.
    - `customAttributes` object: List of custom attributes for the company.
    - `customerStage` string: Customer stage.
    - `domains` string[]: List of domains for the company.
    - `externalId` string: Unique ID for a company from your or another external system, 256 characters max
    - `id` integer: Unique id of the entity.
    - `industry` string: Industry.
    - `modifiedAt` string: Date and time of last modification. Has the following format: yyyy-MM-dd'T'HH:mm:ss.
    - `modifiedFrom` 'API' | 'PORTAL' | 'WEB_SDK' | 'INTEGRATION' | 'PUSH' | 'FACEBOOK' | 'LINE' | 'TELEGRAM' | 'SALESFORCE' | 'DYNAMICS' | 'ZAPIER' | 'FORMS' | 'COMPUTED' | 'ANSWERS' | 'CONVERSATIONS'
    - `name` string, required: Company name.
    - `notes` string: Notes.
    - `origin` 'API' | 'PORTAL' | 'WEB_SDK' | 'INTEGRATION' | 'PUSH' | 'FACEBOOK' | 'LINE' | 'TELEGRAM' | 'SALESFORCE' | 'DYNAMICS' | 'ZAPIER' | 'FORMS' | 'COMPUTED' | 'ANSWERS' | 'CONVERSATIONS'
    - `region` string: Region.
    - `segment` string: Segment.
    - `serviceData` object: Company's service information.
    - `tags` string[]: List of tags for the company.
    - `vatNumber` string: VAT number.
  - `limit` integer: Limit how many rows will be returned (but possibly less, if the query itself yields fewer rows)
  - `orderBy` string: Results ordering
  - `page` integer: Page number
  - `totalCount` integer: Total amount of rows

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Requests
- `500`: Internal Server Error
- `4XX`: Error responses
- `5XX`: Error responses

---

[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)