# Company

The Company API can be used to create, update, retrieve, and delete records in a company object. The **relations** parameter with a value **contact** is required to obtain a company's contacts (i.e., employees).

### Attributes 

| ATTRIBUTE   | TYPE                                 | DESCRIPTION                                                                                                                                             |
| ----------- | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| id          | Integer                              | ID of the company                                                                                                                                       |
| fields      | JSON object (Entity Relations)       | Information about a company such as company name, website, industry, description, source, revenue, city, state, country, address, employees, foundation |
| contacts    | JSON Array Object (Entity Relations) | Information about company's contacts                                                                                                                    |
| dateCreated | datetime                             | Company creation timestamp                                                                                                                              |
| dateUpdated | datetime                             | Company updated timestamp                                                                                                                               |

### **Permissions**

To request a company endpoint you will need a valid API Key with company access permissions.

### **Relations between companies and other entities**

A company has many contacts. Contacts belong to a company.