# Get the API key's company

**GET** `/company`

## Responses

### 200

Company

**application/json**

_Schema ref:_ `#/components/schemas/GetCompanyResponse` (GetCompanyResponse)

```json
{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "id": {
          "type": "integer"
        },
        "name": {
          "type": "string",
          "description": "Trade name shown in Cockpit"
        },
        "legal_name": {
          "type": "string",
          "nullable": true
        },
        "registration_number": {
          "type": "string",
          "nullable": true,
          "description": "Company registration number for its country: SIREN in France, CRN in the UK, EIN in the US, etc."
        },
        "country": {
          "type": "string",
          "nullable": true,
          "description": "Head office country, ISO 3166-1 alpha-2",
          "example": "FR"
        },
        "currency": {
          "type": "string",
          "nullable": true,
          "description": "ISO 4217 currency of the head office country, used for catalog pricing and carts",
          "example": "EUR"
        },
        "acquisition_mode": {
          "type": "string",
          "enum": [
            "LEASING",
            "BUY"
          ],
          "description": "LEASING: monthly lease. BUY: one-time purchase.",
          "example": "LEASING"
        },
        "hrms_integration": {
          "type": "object",
          "nullable": true,
          "properties": {
            "provider": {
              "type": "string",
              "enum": [
                "GOOGLE",
                "HIBOB",
                "BAMBOOHR",
                "PERSONIO",
                "LUCCA",
                "FACTORIAL",
                "PAYFIT",
                "RIPPLING"
              ],
              "description": "HR software the company syncs employees from"
            },
            "status": {
              "type": "string",
              "enum": [
                "CONNECTED",
                "SETUP_IN_PROGRESS"
              ],
              "description": "SETUP_IN_PROGRESS is connected, but the first employee import is not confirmed yet"
            },
            "last_synced_at": {
              "type": "string",
              "nullable": true,
              "description": "Last employee sync, ISO 8601"
            }
          },
          "required": [
            "provider",
            "status",
            "last_synced_at"
          ],
          "description": "The HR software connection, or null when none is connected. Connect one from Cockpit's settings."
        }
      },
      "required": [
        "id",
        "name",
        "legal_name",
        "registration_number",
        "country",
        "currency",
        "acquisition_mode",
        "hrms_integration"
      ]
    }
  },
  "required": [
    "data"
  ]
}
```

### 401

Missing, invalid, or revoked API key

**text/plain**

```json
{
  "type": "string",
  "example": "Unauthorized"
}
```

### 404

Not found

**application/json**

_Schema ref:_ `#/components/schemas/CompanyNotFoundErrorResponse` (CompanyNotFoundErrorResponse)

```json
{
  "type": "object",
  "properties": {
    "error": {
      "type": "string",
      "enum": [
        "COMPANY_NOT_FOUND"
      ]
    }
  },
  "required": [
    "error"
  ]
}
```

### 429

Rate limit exceeded. The RateLimit-* headers give the limit and the reset time.

**text/plain**

```json
{
  "type": "string",
  "example": "Too many requests, please try again later."
}
```

### 500

Unexpected server error

**application/json**

_Schema ref:_ `#/components/schemas/InternalErrorResponse` (InternalErrorResponse)

```json
{
  "type": "object",
  "properties": {
    "error": {
      "type": "string",
      "enum": [
        "INTERNAL_ERROR"
      ]
    }
  },
  "required": [
    "error"
  ]
}
```

### 503

Rate limiting is temporarily unavailable; retry with backoff

**application/json**

_Schema ref:_ `#/components/schemas/RateLimiterUnavailableResponse` (RateLimiterUnavailableResponse)

```json
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string"
    }
  },
  "required": [
    "message"
  ]
}
```

## Security

```json
[
  {
    "bearerAuth": []
  }
]
```

**bearerAuth:** Bearer token using a Fleet platform API key (flt_sk_…).

---

_Generated from the OpenAPI specification for raw Markdown / tooling use._
