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

# Company

> The company object represents an organization in your account.

Companies store firmographic data such as industry, location, and website. They can be associated with [persons](/api-reference/objects/person) in your account.

## Fields

<ParamField path="id" type="string (uuid)" required>
  Unique identifier for the company.
</ParamField>

<ParamField path="objectType" type="string" required>
  Always `company`.
</ParamField>

<ParamField path="name" type="string | null">
  The company name.
</ParamField>

<ParamField path="website" type="string | null">
  The company website URL.
</ParamField>

<ParamField path="domain" type="string | null">
  The company domain.
</ParamField>

<ParamField path="logoUrl" type="string | null">
  URL to the company logo.
</ParamField>

<ParamField path="industries" type="string[]" required>
  List of industries the company operates in.
</ParamField>

<ParamField path="city" type="string | null">
  The city where the company is located.
</ParamField>

<ParamField path="state" type="string | null">
  The state or region where the company is located.
</ParamField>

<ParamField path="country" type="string | null">
  The country where the company is located.
</ParamField>

<ParamField path="createdAt" type="string (date-time)" required>
  Timestamp when the company was created.
</ParamField>

<ParamField path="updatedAt" type="string (date-time)" required>
  Timestamp when the company was last updated.
</ParamField>

## Example

```json theme={null}
{
  "id": "b5c6d7e8-f9a0-1234-bcde-f56789abcdef",
  "objectType": "company",
  "name": "Acme Corp",
  "website": "https://acme.com",
  "domain": "acme.com",
  "logoUrl": "https://logo.clearbit.com/acme.com",
  "industries": ["Software", "SaaS"],
  "city": "San Francisco",
  "state": "California",
  "country": "United States",
  "createdAt": "2024-01-05T12:00:00Z",
  "updatedAt": "2024-02-01T09:15:00Z"
}
```

## Used in

* [List companies](/api-reference/companies/list) - returns an array of company objects
* [Get a company](/api-reference/companies/get) - returns a single company object
