# Retrieve list of companies by search filters

Retrieve a paginated list of companies from the PMS based on specified search filters. Optional query parameters include company name, email address, telephone number, referrer, industry, market segment, and account ID. Each filter allows partial matches using wildcards for greater flexibility in searching. If no filters are provided, the endpoint returns all available companies. The response contains key details for each company, such as name, contact information, and industry, presented in a paginated format to facilitate navigation. This endpoint is ideal for managing corporate accounts, identifying business partnerships, and integrating company information with other systems. Pagination controls can be used to manage the size and order of results.

Endpoint: GET /api/v3/companies
Version: 3.0.4
Security: OAuth2

## Query parameters:

  - `companyName` (string)
    Company name to search for

  - `emailAddress` (string)
    Email address to search for

  - `telephoneNumber` (string)
    Telephone number to search for

  - `referrer` (string)
    Referrer to search for

  - `industry` (string)
    Industry to search for

  - `marketSegment` (string)
    Market segment to search for

  - `accountId` (integer)
    Account ID to search for

## Response 200 fields (application/json):

  - `content` (array)

  - `content.id` (integer)
    ID of the company

  - `content.source` (string)
    Source of the company

  - `content.companyName` (string)
    Name of the company

  - `content.industry` (string)
    Industry of the company

  - `content.accountCode` (string)
    Account code of the company

  - `content.postCode` (string)
    Postal code of the company's address

  - `content.city` (string)
    City where the company is located

  - `content.status` (string)
    Status of the company

  - `content.referrer` (string)
    Referrer of the company

  - `content.accountId` (integer)
    Account ID associated with the company

  - `content.marketSegment` (string)
    Market segment of the company

  - `content.telephoneNumber` (string)
    Telephone number of the company

  - `content.lifecycleStage` (string)
    Lifecycle stage of the company

  - `content.emailAddress` (string)
    Email address of the company

  - `content.addressLine1` (string)
    First line of the company's address

  - `content.addressLine2` (string)
    Second line of the company's address

  - `page` (object)

  - `page.size` (integer)

  - `page.totalElements` (integer)

  - `page.totalPages` (integer)

  - `page.number` (integer)