> 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/gestion-de-entregas/administrar-etiquetas/obtener-etiqueta.md).

# Obtener Etiqueta

Para obtener los datos de una etiqueta conocida, se debe realizar la siguiente consulta.

<mark style="color:blue;">`GET`</mark> `https://api.persat.com.ar/v1/deliveries-labels/label_id`

#### Path Parameters

| Name                                        | Type   | Description                                                 |
| ------------------------------------------- | ------ | ----------------------------------------------------------- |
| label\_id<mark style="color:red;">\*</mark> | Number | Nro. de identificación de la etiqueta que se desea obtener. |

#### 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": 15,
        "name": "Urgente",
        "color": "RED_2"
    }
}
```

{% endtab %}

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

```json
{
    "success": false,
    "error": {
        "status": 400,
        "type": "BAD_REQUEST",
        "userMessage": "'label_id' debe ser un number (entero) obligatorio"
    }
}
```

{% endtab %}

{% tab title="404: Not Found Etiqueta inexistente" %}

```json
{
    "success": false,
    "error": {
        "status": 404,
        "type": "NOT_FOUND",
        "userMessage": "No existe el label con id: 3215"
    }
}
```

{% endtab %}
{% endtabs %}

### Análisis de la Respuesta

```json
{
    "success": true,
    "data": {
        "id": 15,
        "name": "Urgente",
        "color": "RED_2"
    }
}
```

**data.id:** Number identificando de forma univoca a la etiqueta

**data.name:** String. Nombre de la etiqueta. Máx. 20 caracteres.

**data.color:** String que identifica el color de la etiqueta. La lista de colores disponibles es la siguiente

<figure><img src="/files/XyKfxcPKWjixJkntiUxi" alt=""><figcaption></figcaption></figure>

Cada uno de los colores tiene 3 tonos disponibles.

* RED\
  RED\_2\
  RED\_3
* ORANGE\
  ORANGE\_2\
  ORANGE\_3
* YELLOW\
  YELLOW\_2\
  YELLOW\_3
* GREEN\
  GREEN\_2\
  GREEN\_3
* LIGHTBLUE\
  LIGHTBLUE\_2\
  LIGHTBLUE\_3
* BLUE\
  BLUE\_2\
  BLUE\_3
* VIOLET\
  VIOLET\_2\
  VIOLET\_3
* PINK\
  PINK\_2\
  PINK\_3
* BLACK\
  BLACK\_2\
  BLACK\_3