# Listar Zonas

Se pueden listar todas las zona, o también se pueden obtener las zonas asignadas a un determinado dispositivo.

<mark style="color:blue;">`GET`</mark> `https://api.persat.com.ar/v1/zones?device_id=12`

#### Query Parameters

| Name       | Type   | Description                                |
| ---------- | ------ | ------------------------------------------ |
| device\_id | Number | \[Opcional]. Identificador del dispositivo |

#### 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,
            "created": "2013-08-16T13:37:31.000Z",
            "name": " Cordoba (Capital)"
        },
        {
            "id": 2,
            "created": "2013-08-16T14:27:20.000Z",
            "name": " GBA Norte"
        },
        {
            "id": 3,
            "created": "2013-08-16T14:44:31.000Z",
            "name": " Au. BsAs - Rosario"
        },
        {
            "id": 4,
            "created": "2013-08-16T13:40:08.000Z",
            "name": " Mendoza (Capital)"
        },
        {
            "id": 5,
            "created": "2013-08-16T13:18:06.000Z",
            "name": " Rosario"
        },
        {
            "id": 6,
            "created": "2013-08-16T13:42:48.000Z",
            "name": " SM de Tucuman"
        },
        {
            "id": 7,
            "created": "2013-08-16T15:31:39.000Z",
            "name": "Argentina"
        },
        {
            "id": 8,
            "created": "2011-02-18T21:26:39.000Z",
            "name": "GBA Oeste"
        },
        {
            "id": 9,
            "created": "2011-02-14T01:13:05.000Z",
            "name": "GBA Sur"
        },
        {
            "id": 10,
            "created": "2025-09-09T14:47:44.000Z",
            "name": " Pedro"
        }
    ]
}
```

{% endtab %}

{% tab title="404: Not Found No se encontró el dispositivo" %}

```json
{
    "success": false,
    "error": {
        "status": 404,
        "type": "NOT_FOUND",
        "userMessage": "No existe un device con este id: 3123233213"
    }
}
```

{% endtab %}

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

```javascript
{
    "success": false,
    "error": {
        "status": 400,
        "type": "BAD_REQUEST",
        "userMessage": "device_id. Not a number"
    }
}
```

{% endtab %}
{% endtabs %}

### Analizando la Respuesta

```json
{
    "success": true,
    "data": [
        {
            "id": 1,
            "created": "2013-08-16T13:37:31.000Z",
            "name": " Cordoba (Capital)"
        },
        {
            "id": 2,
            "created": "2013-08-16T14:27:20.000Z",
            "name": " GBA Norte"
        }, { ... }
    ]
}
```

**data:** Array de Zonas. Cada item del array identifica la zona como se encuentra definido en [Obtener Zona](https://docs.api.persat.com.ar/entidades-basicas/zonas-de-trabajo/obtener-zona)
