> For the complete documentation index, see [llms.txt](https://docs.api.persat.com.ar/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.api.persat.com.ar/modulos/formularios-digitales/estados-de-formulario/listar-estados.md).

# Listar estados

Los estados se pueden listar a partir de un form group (conjunto de versiones de un formulario) o del id de un formulario. Para ello enviar la query correspondiente en la petición de tipo GET.

<mark style="color:blue;">`GET`</mark> `https://api.persat.com.ar/v1/digital-forms-states`

{% hint style="warning" %}
Siempre se debe enviar **form\_id** o **form\_group.**
{% endhint %}

#### Query Parameters

| Name             | Type    | Description                                                      |
| ---------------- | ------- | ---------------------------------------------------------------- |
| form\_id         | Number  | Identificador del formulario                                     |
| form\_group      | Number  | Identificador del grupo de formulario                            |
| without\_deleted | Boolean | Si se deben excluir los estados eliminados. Por defecto es false |

#### Headers

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

{% tabs %}
{% tab title="200: OK form\_group=14, without\_deleted=true" %}

```json
{
    "success": true,
    "data": {
        "form_group": 14,
        "states": [
            {
                "color": "ORANGE",
                "deleted": false,
                "id": 14,
                "name": "A revisar"
            },
            {
                "color": "BLUE",
                "deleted": false,
                "id": 26,
                "name": "Listo"
            },
            {
                "color": "RED",
                "deleted": false,
                "id": 27,
                "name": "Cancelado"
            },
            {
                "color": "GREEN",
                "deleted": false,
                "id": 28,
                "name": "Aprobado"
            }
        ]
    }
}
```

{% endtab %}

{% tab title="200: OK form\_id=1440," %}

```json
{
    "success": true,
    "data": {
        "form_group": 14,
        "states": [
            {
                "color": "ORANGE",
                "deleted": false,
                "id": 14,
                "name": "A revisar"
            },
            {
                "color": "BLUE",
                "deleted": false,
                "id": 26,
                "name": "Listo"
            },
            {
                "color": "RED",
                "deleted": false,
                "id": 27,
                "name": "Cancelado"
            },
            {
                "color": "GREEN",
                "deleted": false,
                "id": 28,
                "name": "Aprobado"
            }
            {
                "color": "LIGHT_BLUE",
                "deleted": true,
                "id": 29,
                "name": "Aprobado y facturado"
            }
        ]
    }
}
```

{% endtab %}

{% tab title="404 NOT\_FOUND no existe el formulario" %}

```json
{
    "success": false,
    "error": {
        "status": 404,
        "type": "NOT_FOUND",
        "userMessage": "No hay un formulario con id: 123123"
    }
}
```

{% endtab %}

{% tab title="404 NOT\_FOUND no existe el form\_group" %}

```json
{
    "success": false,
    "error": {
        "status": 404,
        "type": "NOT_FOUND",
        "userMessage": "No existe el form_group: 1923"
    }
}
```

{% endtab %}

{% tab title="400: Bad Request Error" %}

```javascript
{
    "success": false,
    "error": {
        "status": 400,
        "type": "BAD_REQUEST",
        "userMessage": "Es necesario que haya form_id o form_group"
    }
}
```

{% endtab %}
{% endtabs %}

### Analizando la Respuesta

**form\_group:** es un número. Identificador del grupo de formulario(conjunto de versiones de un formulario).

**states:** es un array de estados. Sus propiedades están descriptas en [Obtener estado](/modulos/formularios-digitales/estados-de-formulario/obtener-estado.md).&#x20;