# Campos

> Lista de definiciones de campos de contactos y empresas

Source: https://docs.graph8.com/es/developers/fields/

Los campos son las definiciones de columnas para contactos y empresas. Utilice estos endpoints para descubrir los campos disponibles, tanto integrados como personalizados, antes de importar o actualizar registros.

---

## Listar campos de contactos

`GET /fields`

Devuelve todas las definiciones de campos de contactos, incluidos los campos base y cualquier campo personalizado. Pase `list_id` para incluir los campos personalizados específicos de una lista.

### Parámetros de consulta

| Parámetro | Tipo | Predeterminado | Descripción |
|-----------|------|----------------|-------------|
| `list_id` | integer | — | Incluir campos personalizados específicos de esta lista |

### Ejemplo

**cURL**

```bash
curl "https://be.graph8.com/api/v1/fields" \
  -H "Authorization: Bearer $API_KEY"
```

**Python**

```python
response = requests.get(
    f"{BASE_URL}/fields",
    headers=HEADERS
)
fields = response.json()
```

**TypeScript**

```typescript
const response = await fetch(`${BASE_URL}/fields`, {
  headers: { Authorization: `Bearer ${API_KEY}` }
});
const fields = await response.json();
```

### Respuesta

```json
{
  "data": [
    {
      "id": 1,
      "title": "First Name",
      "name": "CONTACT_FIRST_NAME",
      "data_type": "text",
      "is_global": true
    },
    {
      "id": 2,
      "title": "Work Email",
      "name": "CONTACT_WORK_EMAIL",
      "data_type": "text",
      "is_global": true
    },
    {
      "id": 150,
      "title": "Lead Score",
      "name": "custom_lead_score",
      "data_type": "number",
      "is_global": false
    }
  ]
}
```

---

## Listar campos de empresas

`GET /fields/companies`

Devuelve todas las definiciones de campos de empresas, incluidos los campos base y cualquier campo personalizado.

### Parámetros de consulta

| Parámetro | Tipo | Predeterminado | Descripción |
|-----------|------|----------------|-------------|
| `list_id` | integer | — | Incluir campos personalizados específicos de esta lista |

### Ejemplo

**cURL**

```bash
curl "https://be.graph8.com/api/v1/fields/companies" \
  -H "Authorization: Bearer $API_KEY"
```

**Python**

```python
response = requests.get(
    f"{BASE_URL}/fields/companies",
    headers=HEADERS
)
fields = response.json()
```

**TypeScript**

```typescript
const response = await fetch(`${BASE_URL}/fields/companies`, {
  headers: { Authorization: `Bearer ${API_KEY}` }
});
const fields = await response.json();
```

### Respuesta

```json
{
  "data": [
    {
      "id": 1,
      "title": "Company Name",
      "name": "COMPANY_NAME",
      "data_type": "text",
      "is_global": true
    },
    {
      "id": 2,
      "title": "Domain",
      "name": "COMPANY_DOMAIN",
      "data_type": "text",
      "is_global": true
    }
  ]
}
```