# Obtener estado

Los estados en Persat pueden ser cambiados únicamente desde la web o desde la API.

Para obtener un estado particular que ya ha sido insertado en Persat se debe realizar un GET como el que se muestra a continuación.

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

#### Path Parameters

| Name                                        | Type   | Description               |
| ------------------------------------------- | ------ | ------------------------- |
| state\_id<mark style="color:red;">\*</mark> | number | Identificador del estado. |

#### 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": {
        "color": "ORANGE",
        "deleted": false,
        "id": 10,
        "name": "A revisar"
    }
}
```

{% endtab %}

{% tab title="404: Not Found no se encontró el estado de formulario" %}

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

{% endtab %}
{% endtabs %}

### Analizando la Respuesta

```json
{
    "success": true,
    "data": {
        "color": "ORANGE",
        "deleted": false,
        "id": 10,
        "name": "A revisar"
    }
}
```

**id:** es un número. Identificador del estado de formulario.

**deleted:** es un booleano que indica si el estado ha sido eliminado.&#x20;

**color:** es un string. Color designado para el estado.

Los colores disponibles son:

{% hint style="info" %}
Los colores disponibles son:

* RED
* ORANGE
* YELLOW
* GREEN
* LIGHT\_BLUE
* BLUE
* VIOLET
* PINK
  {% endhint %}

nam&#x65;**:** es un string.  Nombre del estado


---

# 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/obtener-estado.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.