---
title: "Get the list of company fields (for the logged API user's account)"
description: "GET /company_fields — Returns the custom fields defined for companies on your account — id, name, type, position and, for select_box and multiple_choice fields, their choices."
canonical_url: https://developer.onepagecrm.com/api/reference/company-fields/get-company_fields/
source: Markdown mirror of https://developer.onepagecrm.com/api/reference/company-fields/get-company_fields/
---

`GET /company_fields`

Returns the custom fields defined for companies on your account — id, name, type, position and, for select_box and multiple_choice fields, their choices. These are separate from contact custom fields and deal fields.

Resource: [Company Fields](https://developer.onepagecrm.com/api/reference/company-fields/) · [API Reference](https://developer.onepagecrm.com/api/reference/)

## Request

```bash
curl "https://app.onepagecrm.com/api/v3/company_fields" \
  -u $user_id:$api_key
```

Authentication is HTTP Basic — `user_id` as username, `api_key` as password.
See https://developer.onepagecrm.com/api/authentication/.

## Query parameters

| Name | Type | Description |
| --- | --- | --- |
| `sort_by` | string | Specify field by which to order the results (use in conjunction with `order`) |
| `order` | string | Specify the order (ascending or descending) of the sort of the results (use in conjunction with `sort_by`) |
| `page` | integer | Page number. Starts from 1. Default is 1. |
| `per_page` | integer | Number of records to return. Maximum 100 allowed. Default is 10. |

## Responses

### 200

OK

```json
{
  "status": 0,
  "message": "OK",
  "timestamp": 1528373119,
  "data": {
    "company_fields": [
      {
        "company_field": {
          "id": "5aad9b039007ba28c9ebad56",
          "name": "Company size",
          "type": "select_box",
          "position": 2,
          "choices": [
            "Small",
            "Medium",
            "Large"
          ]
        }
      }
    ],
    "total_count": 1,
    "page": 1,
    "per_page": 10,
    "max_page": 1
  }
}
```

Standard error responses: 400, 401, 403, 404, 409, 500 — shared across the API. See https://developer.onepagecrm.com/api/errors/.

## Related guides

- [Authentication](https://developer.onepagecrm.com/api/authentication/)
- [Errors](https://developer.onepagecrm.com/api/errors/)
- [Rate limits](https://developer.onepagecrm.com/api/rate-limits/)
- [Pagination](https://developer.onepagecrm.com/api/pagination/)
- [Sorting & time filters](https://developer.onepagecrm.com/api/sorting/)