---
title: "Retrieves a paginated list of customer companies with full details including contacts, billing address, and financial settings."
method: GET
path: "/api/Company"
tags: ["Company"]
---

# Retrieves a paginated list of customer companies with full details including contacts, billing address, and financial settings.

`GET /api/Company`

## Query parameters

- `UpdatedAfter` string, date-time
- `pageSize` integer
- `pageNumber` integer
- `Sort` string

## Response `200`

Returns a paginated list of companies with full details including contacts.

- CompanyList — Paginated collection of customer companies with full details.
  - `Companies` Company[] — The list of companies for the current page.
    - `CompanyID` integer — The unique identifier of the company.
    - `CompanyName` string — The display name of the company.
    - `BillingAddressLine` string — The first line of the company's billing address (street address).
    - `BillingAddressCity` string — The city of the company's billing address.
    - `BillingAddressState` string — The state or province of the company's billing address.
    - `BillingAddressPostCode` string — The postcode or ZIP code of the company's billing address.
    - `BillingCountryCode` string — The ISO 2-letter country code for the company's billing address.
    - `BillingAddress` string — The full formatted billing address string. If set, overrides the individual address fields.
    - `Phone` string — The company's primary phone number.
    - `Fax` string — The company's fax number.
    - `website` string — The company's website URL.
    - `TaxNumber` string — The company's tax registration number.
    - `Comments` string — Internal notes or comments about the company.
    - `CurrencyCode` string — The default currency code used for invoices and transactions with this company.
    - `DefaultTradingTermIDFK` integer — The ID of the default trading terms applied to invoices for this company.
    - `DateCreated` string, date-time — The UTC date and time when the company record was created.
    - `DateUpdated` string, date-time — The UTC date and time when the company record was last updated.
    - `Contacts` CompanyContact[] — The list of external contacts associated with this company.
      - `ContactID` integer — The unique identifier of the contact.
      - `CompanyIDFK` integer — The ID of the company this contact belongs to.
      - `CompanyName` string — The name of the company this contact belongs to.
      - `Firstname` string — The contact's first name.
      - `Lastname` string — The contact's last name.
      - `Email` string — The contact's email address.
      - `Phone` string — The contact's phone number.
      - `Mobile` string — The contact's mobile phone number.
      - `PositionTitle` string — The contact's job title or position.
      - `TimeZone` string — The contact's time zone identifier.
      - `DateCreated` string, date-time — The UTC date and time when the contact record was created.
      - `DateUpdated` string, date-time — The UTC date and time when the contact record was last updated.
      - `Roles` RoleDetails[] — The roles assigned to this contact (RoleCode/RoleName), mirroring the Get UserProfile response.
        - `RoleCode` string — Unique code for the role (e.g. Admin, PM, TimesheetUser).
        - `RoleName` string — Display name of the role.
    - `ViewCompanyURL` string — URL to view this company in the Avaza web application.
  - `TotalCount` integer — Total number of companies matching the query.
  - `PageNumber` integer — The current page number (1-based).
  - `PageSize` integer — The number of results per page.

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/avaza/apis/avaza-api-documentation.md) · [All operations](https://skmtc.net/avaza/apis/avaza-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/avaza/avaza-api-documentation/versions/1eeadf750514/schema)