> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/Falasefemi2/companyflow/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Company

Retrieve detailed information about a specific company by its ID.

## Path Parameters

<ParamField path="id" type="string" required>
  Company UUID
</ParamField>

## Response

<ResponseField name="success" type="boolean">
  Indicates if the request was successful
</ResponseField>

<ResponseField name="data" type="object">
  The company object

  <ResponseField name="data.id" type="string">
    Company UUID
  </ResponseField>

  <ResponseField name="data.name" type="string">
    Company name
  </ResponseField>

  <ResponseField name="data.slug" type="string">
    Company slug identifier
  </ResponseField>

  <ResponseField name="data.industry" type="string">
    Industry sector
  </ResponseField>

  <ResponseField name="data.country" type="string">
    Country location
  </ResponseField>

  <ResponseField name="data.timezone" type="string">
    Timezone identifier
  </ResponseField>

  <ResponseField name="data.currency" type="string">
    Currency code
  </ResponseField>

  <ResponseField name="data.registration_number" type="string">
    Registration number
  </ResponseField>

  <ResponseField name="data.tax_id" type="string">
    Tax identification
  </ResponseField>

  <ResponseField name="data.address" type="string">
    Physical address
  </ResponseField>

  <ResponseField name="data.phone" type="string">
    Contact phone
  </ResponseField>

  <ResponseField name="data.logo_url" type="string">
    Logo URL
  </ResponseField>

  <ResponseField name="data.status" type="string">
    Company status
  </ResponseField>

  <ResponseField name="data.settings" type="object">
    Company settings (JSON)
  </ResponseField>

  <ResponseField name="data.created_at" type="string">
    Creation timestamp (ISO 8601)
  </ResponseField>

  <ResponseField name="data.updated_at" type="string">
    Last update timestamp (ISO 8601)
  </ResponseField>
</ResponseField>

## Request Example

```bash cURL theme={null}
curl -X GET https://api.companyflow.com/companies/123e4567-e89b-12d3-a456-426614174000 \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"
```

## Response Example

```json 200 OK theme={null}
{
  "success": true,
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "Acme Corporation",
    "slug": "acme-corp",
    "industry": "Technology",
    "country": "United States",
    "timezone": "America/New_York",
    "currency": "USD",
    "registration_number": "123456789",
    "tax_id": "98-7654321",
    "address": "123 Main St, New York, NY 10001",
    "phone": "+1-555-0100",
    "logo_url": "https://example.com/logo.png",
    "status": "active",
    "settings": null,
    "created_at": "2026-03-03T10:00:00Z",
    "updated_at": "2026-03-03T10:00:00Z"
  }
}
```

```json 400 Bad Request theme={null}
{
  "success": false,
  "message": "invalid company id"
}
```

```json 500 Internal Server Error theme={null}
{
  "success": false,
  "message": "internal server error"
}
```

## Error Responses

| Status Code | Description                                    |
| ----------- | ---------------------------------------------- |
| 400         | Invalid company ID format (must be valid UUID) |
| 500         | Internal server error                          |