# 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;


---

# 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/modulos/formularios-digitales/estados-de-formulario/listar-estados.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.