---
title: "Query companies"
method: POST
path: "/v6/company/query"
tags: ["Company Management"]
---

# Query companies

`POST /v6/company/query`

Query companies for the authenticated user

## Request body

- CompaniesGetParam
  - `cursor` string, nullable — Cursor from the previous paginated response
  - `limit` integer — Page size, i.e. number of items to return per page
  - `sort` CompaniesSort — Sort order for the items in the response.
    - `orderBy` 'NAME' — Sort column
    - `direction` 'ASC' | 'DESC' — Sort direction. Defaults to DESC
  - `filter` CompaniesFilterParam — Filter for items in the response.
    - `name` StringFilter — Name filter
      - `equal` string — Value - returns all records with specified field equal to this value.
      - `notEqual` string — Value - returns all records with specified field not equal to this value.
      - `greaterThan` string — Value - returns all records with specified field greater than to this value.
      - `greaterThanEqual` string — Value - returns all records with specified field greater than or equal to this value.
      - `lessThan` string — Value - returns all records with specified field less than to this value.
      - `lessThanEqual` string — Value - returns all records with specified field less than or equal to this value.
      - `contain` string — Value - returns all records with specified field containing this value.
    - `status` EnumStatusListFilter — Status filter
      - `in` string[]
      - `notIn` string[]
      - `equal` 'ACTIVE' | 'INACTIVE' | 'REMOVED'
      - `notEqual` 'ACTIVE' | 'INACTIVE' | 'REMOVED'
      - `greaterThan` 'ACTIVE' | 'INACTIVE' | 'REMOVED'
      - `greaterThanEqual` 'ACTIVE' | 'INACTIVE' | 'REMOVED'
      - `lessThan` 'ACTIVE' | 'INACTIVE' | 'REMOVED'
      - `lessThanEqual` 'ACTIVE' | 'INACTIVE' | 'REMOVED'
    - `entityType` OrgTypeListFilter — Entity type filter
      - `in` string[] — Include companies with these entity types
      - `notIn` string[] — Exclude companies with these entity types
      - `equal` 'SOLE_PROPRIETORSHIP' | 'LLP' | 'LLC' | 'S_CORP' | 'C_CORP' — Equal to entity type
      - `notEqual` 'SOLE_PROPRIETORSHIP' | 'LLP' | 'LLC' | 'S_CORP' | 'C_CORP' — Not equal to entity type
      - `greaterThan` 'SOLE_PROPRIETORSHIP' | 'LLP' | 'LLC' | 'S_CORP' | 'C_CORP' — Greater than entity type
      - `greaterThanEqual` 'SOLE_PROPRIETORSHIP' | 'LLP' | 'LLC' | 'S_CORP' | 'C_CORP' — Greater than or equal to entity type
      - `lessThan` 'SOLE_PROPRIETORSHIP' | 'LLP' | 'LLC' | 'S_CORP' | 'C_CORP' — Less than entity type
      - `lessThanEqual` 'SOLE_PROPRIETORSHIP' | 'LLP' | 'LLC' | 'S_CORP' | 'C_CORP' — Less than or equal to entity type
    - `businessType` BusinessTypeFilterParam — Business type filter
      - `id` BusinessTypeIdFilter — Filter by businessType ID
        - `in` string[] — Include companies with these businessType IDs
        - `notIn` string[] — Exclude companies with these businessType IDs

## Response `200`

Success

- PaginatedResponseCompanyGetDto
  - `result` 'SUCCESS' | 'FAILURE' — The result of the action performed.
  - `data` CompanyGetDto[] — The data generated by the action performed.
    - `id` string — Id of the company, required to update an existing company
    - `name` string, required — Name of the company
    - `apiCompanyId` string — Id of the company in your DB
    - `entityType` 'SOLE_PROPRIETORSHIP' | 'LLP' | 'LLC' | 'S_CORP' | 'C_CORP' — The type of entity
    - `owners` OwnerGetDto[], required
      - `userId` string, required — Id of the user in your DB
      - `email` string — Email address for the user
      - `firstName` string — First name for the user
      - `lastName` string — Last name for the user
      - `language` 'EN' | 'ES' | 'FR' | 'ZH' | 'ID' — Language used by the user
    - `address` AddressGetDto, nullable — Address of the vendor
      - `countryCode` 'USA' | 'CAN' | 'GBR' — Country Code of the address
      - `state` string — State/Province of the address
      - `city` string — City of the address
      - `zip` string — Zip/Postal code of the address
      - `phoneWork` string — The phone number
      - `address1` string — First line of the address
      - `address2` string — Second line of the address
    - `accountingMethod` 'ACCRUAL' | 'CASH' — Accounting method used by the company
    - `businessType` BusinessTypeInfo — Business type of the company
      - `id` string — Id of the business type
      - `name` string — Name of the business type
    - `availableFeatures` FeaturesGetDto — Available features for the company
      - `bankTransactions` boolean — Whether bank transactions are enabled for this user. Defaults to true.
      - `bills` boolean — Whether bills are enabled for this user. Defaults to true.
      - `bookkeeping` boolean — Whether bookkeeping is enabled for this user. Defaults to true.
      - `imports` boolean — Whether imports are enabled for this user. Defaults to true.
      - `invoicing` boolean — Whether invoicing is enabled for this user. Defaults to true.
      - `payroll` boolean — Whether payroll is enabled for this user. Defaults to true.
      - `reporting` boolean — Whether financial reporting is enabled for this user. Defaults to true.
      - `taxes` boolean — Whether tax estimates are enabled for this user. Defaults to true.
      - `timeTracking` boolean — Whether time tracking is enabled for this user. Defaults to true.
      - `mileage` boolean — Whether mileage is enabled for this user. Defaults to true.
    - `accessLevel` 'READ_WRITE' | 'READ_ONLY' | 'NONE' | 'READ_WRITE' | 'READ_ONLY' | 'NONE', nullable — The bookkeeper's access level for this company. Null otherwise
    - `status` 'ACTIVE' | 'INACTIVE' | 'REMOVED' — Status of the company
  - `cursor` ResponseCursor — Cursor to be used in your subsequent paginated request. Only populated if there are more pages available.
    - `after` string — After cursor - Fetches entities after this cursor. Useful for paging forwards.
    - `before` string — Before cursor - Fetches entities before this cursor. Useful for paging backwards.

## Other responses

- `400` — Bad request
- `401` — Not authenticated
- `403` — Not authorized
- `404` — Endpoint not found
- `500` — Internal server error

---

[API](https://skmtc.net/tight/apis/tight-api.md) · [All operations](https://skmtc.net/tight/apis/tight-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tight/tight-api/revisions/e9f0790a89af/schema)
