Companies

List Companies

Returns a paginated list of all your companies filtered by optional parameters

get/companies

Request

  • Base URL
    https://api.pax8.com/v1
  • URL
    https://api.pax8.com/v1/companies
  • Auth
    OAuth 2
    Client credentials
    Token URL: https://token-manager.pax8.com/oauth/token

Query parameters

pagenumber

The page number to request for in the companies list

sizenumber

Return this number of company records per page

sort'name' | 'city' | 'country' | 'stateOrProvince' | 'postalCode'

Return companies sorted by this field and direction. Formatted as fieldName,direction - ex. sort=name,desc

citystring
Example:Greenwood Village

Return only companies matching this city value

countrystring
Example:United States

Return only companies matching this country value

stateOrProvincestring
Example:Colorado

Return only companies matching this stateOrProvince value

postalCodestring
Example:80111

Return only companies matching this postalCode value

selfServiceAllowedboolean

Return only companies matching this selfServiceAllowed value

billOnBehalfOfEnabledboolean

Return only companies matching this billOnBehalfOfEnabled value

orderApprovalRequiredboolean

Return only companies matching this orderApprovalRequired value

status'Active' | 'Inactive' | 'Deleted'

Return only companies matching this status value

Response

Successful operation

Example response

{
  "content": [
    {
      "name": "Pax8",
      "address": {
        "street": "5500 S Quebec St",
        "street2": "Ste. 350",
        "city": "Greenwood Village",
        "stateOrProvince": "CO",
        "postalCode": "80111",
        "country": "US"
      },
      "phone": "555-555-5555",
      "website": "https://www.pax8.com/",
      "contacts": [
        {
          "id": "18d6329e-93f9-46a5-9df7-37e4c29d2840",
          "firstName": "John",
          "lastName": "Doe",
          "email": "john@doe.com",
          "phone": "555-555-5555",
          "createdDate": "2020-05-12"
        }
      ]
    }
  ],
  "page": {
    "size": 50,
    "totalElements": 237,
    "totalPages": 5,
    "number": 1
  }
}

Changes

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