Skip to main content
GET
/
companies
Get all companies associated with the authenticated user
curl --request GET \
  --url https://pre-public-api.cobee.io/api/v3/companies \
  --header 'Authorization: Bearer <token>'
{
  "companies": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "legalId": "<string>",
      "legalName": "<string>",
      "state": "active",
      "contactEmail": "jsmith@example.com",
      "corporationId": "<string>",
      "countryISO2Code": "<string>",
      "deliveryAddress": {
        "streetName": "<string>",
        "streetNumber": "<string>",
        "details": "<string>",
        "street": "<string>",
        "postalCode": "<string>",
        "province": "<string>",
        "locality": "<string>",
        "district": "<string>"
      },
      "legalAddress": {
        "streetName": "<string>",
        "streetNumber": "<string>",
        "details": "<string>",
        "street": "<string>",
        "postalCode": "<string>",
        "province": "<string>",
        "locality": "<string>",
        "district": "<string>"
      }
    }
  ]
}

​
Overview

Retrieve a list of the companies associated with the authenticated user.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
legalId

Company CIF(s) to filter by. Can be a single CIF or multiple CIFs separated by commas

​
state
enum<string>

Company state to filter by

Available options:
active

Response

New response

​
companies
object[]