---
title: "Get a specific deal field"
description: "GET /deal_fields/{deal_field_id} — Returns one deal custom field by ID, including its type and — for select_box and multiple_choice fields — the choices available."
canonical_url: https://developer.onepagecrm.com/api/reference/deal-fields/get-deal_fields-deal_field_id/
source: Markdown mirror of https://developer.onepagecrm.com/api/reference/deal-fields/get-deal_fields-deal_field_id/
---

`GET /deal_fields/{deal_field_id}`

Returns one deal custom field by ID, including its type and — for select_box and multiple_choice fields — the choices available. Unlike contact custom fields, deal fields cannot be of type anniversary.

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

## Request

```bash
curl "https://app.onepagecrm.com/api/v3/deal_fields/{deal_field_id}" \
  -u $user_id:$api_key
```

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

## Path parameters

| Name | Type | Description |
| --- | --- | --- |
| `deal_field_id` | string | Deal Field ID |

## Responses

### 200

OK

```json
{
  "status": 0,
  "message": "OK",
  "timestamp": 1528373119,
  "data": {
    "deal_field": {
      "id": "5aad9b039007ba28c9ebad56",
      "name": "Deal size",
      "type": "select_box",
      "position": 2,
      "choices": [
        "Small",
        "Medium",
        "Large"
      ]
    }
  }
}
```

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/)