APapaleo
Company

Get a list of companies

Get the list of companies. <br>You must have at least one of these scopes: 'companies.read, companies.manage'.<br>For fine-grained clients, you must have this permission: 'core.companies.read'.

get/rateplan/v1/companies

Request

  • Base URL
    https://api.apaleo.com (the document declares no server; this is the origin it was published from)
  • URL
    https://api.apaleo.com/rateplan/v1/companies
  • Auth
    OAuth 2
    Implicit: https://identity.apaleo.com/connect/authorize
    Scopes: companies.read, companies.manage, admin

Query parameters

propertyIdstring

Filter by the specified property

ratePlanIdsstring[]

Return companies with any of the specified rate plans

corporateCodesstring[]

Return companies that have any of the requested corporate codes.

textSearchstring

This will filter all companies for the provided free text. Currently it only looks up if the company name contains one of the provided values

pageNumberinteger

Page number to retrieve. Default: 1. If the page has no items, the API returns 204 No Content.

pageSizeinteger

Items per page. Default: 500. Maximum: 500.

Response

Success.

countinteger required

Total count of items

Example response

{
  "companies": [
    {
      "id": "MUC-UMBRELLA",
      "code": "UMBRELLA",
      "propertyId": "MUC",
      "name": "Umbrella Corp.",
      "invoicingEmail": "umbrella@corp.com",
      "phone": "+49 89 12345678",
      "taxId": "Tax 123456",
      "additionalTaxId": "123456789",
      "additionalTaxId2": "987654321",
      "invoiceNetworkIdentity": {
        "network": "Peppol",
        "id": "0208:123456789"
      },
      "address": {
        "addressLine1": "Marienplatz 1",
        "postalCode": "80331",
        "city": "München",
        "countryCode": "DE"
      },
      "canCheckOutOnAr": true,
      "ratePlans": [
        {
          "id": "MUC-DBL",
          "code": "DBL",
          "corporateCode": "UMBRELLAINC",
          "name": "Double room flexible"
        }
      ]
    },
    {
      "id": "BER-ACME",
      "code": "ACME",
      "propertyId": "BER",
      "name": "ACME Inc.",
      "invoicingEmail": "acme@inc.com",
      "phone": "+49 30 98765432",
      "taxId": "Tax 5552221",
      "additionalTaxId": "993874520",
      "additionalTaxId2": "025478399",
      "invoiceNetworkIdentity": {
        "network": "Peppol",
        "id": "0208:123456789"
      },
      "address": {
        "addressLine1": "Marienplatz 1",
        "postalCode": "80331",
        "city": "München",
        "countryCode": "DE"
      },
      "canCheckOutOnAr": false,
      "ratePlans": [
        {
          "id": "BER-SGL",
          "code": "SGL",
          "corporateCode": "ACMEINC",
          "name": "Single room flexible"
        }
      ]
    }
  ],
  "count": 0
}

Changes

No recorded changes to this operation across all 5 revisions of this API.