# Listar Campos Personalizados

Para obtener los campos personalizados de la ficha de clientes, se debe enviar un GET como el que se especifica a continuación.

<mark style="color:blue;">`GET`</mark> `https://api.persat.com.ar/v1/client-custom-fields`

#### Headers

| Name                                            | Type   | Description     |
| ----------------------------------------------- | ------ | --------------- |
| Authorization<mark style="color:red;">\*</mark> | String | Bearer API\_KEY |

{% tabs %}
{% tab title="200: OK La consulta se ejecutó con éxito" %}

```json
{
    "success": true,
    "data": [
        {
            "id": 1,
            "name": "Nombre del encargado",
            "field_type": "TEXT",
            "required": true
        },
        {
            "id": 2,
            "name": "Cuenta corriente",
            "field_type": "NUMBER",
            "required": false
        },
        {
            "id": 4,
            "name": "Teléfono",
            "field_type": "TELEPHONE",
            "required": false            
        },
        {
            "id": 5,
            "name": "email",
            "field_type": "EMAIL",
            "required": true            
        },
        {
            "id": 6,
            "name": "Link a drive",
            "field_type": "LINK",
            "required": false            
        }
    ]
}
```

{% endtab %}
{% endtabs %}

### Analizando la Respuesta

En caso que no haya ningun error, obtenemos para nuestro caso de ejemplo algo asi:

```json
{
    "success": true,
    "data": [
        {
            "id": 1,
            "name": "Nombre del encargado",
            "field_type": "TEXT",
            "required": true
        },
        {
            "id": 2,
            "name": "Cuenta corriente",
            "field_type": "NUMBER",
            "required": false
        },
        {
            "id": 4,
            "name": "Teléfono",
            "field_type": "TELEPHONE",
            "required": false
        },
        {
            "id": 5,
            "name": "email",
            "field_type": "EMAIL",
            "required": true
        },
        {
            "id": 6,
            "name": "Link a drive",
            "field_type": "LINK",
            "required": false
        }
    ]
}
```

**id:** Identificador del campo personalizado.

**name:** Nombre del campo personalizado.

**field\_type:** Tipo de campo. Como se explica en [Obtener un cliente](/entidades-basicas/clientes/obtener-un-cliente.md)&#x20;

**required:** Booleano indicando si es un campo obligatorio.

{% hint style="info" %}
Una forma rápida de averiguar los ids de los custom fields la podes obtener aqui: [Campos personalizados.](/entidades-basicas/clientes.md#campos-personalizados-de-la-ficha-de-clientes)
{% endhint %}

{% hint style="warning" %}
Si bien cada uno de los campos personalizados tiene un **field\_type** que se usa para la validación para los usuarios web y movil. Dicha validación no se realiza desde la API.

<mark style="color:orange;">**En resumen**</mark>, todos los campos se reciben, modifican e insertan como si fueran strings, independientemente del tipo.

La validación corre por cuenta del programador
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.api.persat.com.ar/entidades-basicas/clientes/listar-campos-personalizados.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.