# Listar almacenes

`GET https://api.fiscalisto.com/v1/warehouses`

Los almacenes del emisor, los más recientes primero: el de la Matriz y uno por sucursal se crean solos. Todos en una página.

## Parámetros

| Nombre | Dónde | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `issuer` | consulta |  | El emisor (iss_…). Puede omitirse si la llave o la cuenta tienen uno solo. |
| `include_archived` | consulta |  | true para incluir los archivados. |

## Con el SDK de TypeScript

```ts
import { Fiscalisto } from "fiscalisto";

// La llave viene de FISCALISTO_API_KEY.
const fiscalisto = new Fiscalisto();

const { data } = await fiscalisto.warehouses.list();
```

## Con el SDK de Python

```python
from fiscalisto import Fiscalisto

# La llave viene de FISCALISTO_API_KEY.
fiscalisto = Fiscalisto()

data = fiscalisto.warehouses.list()["data"]
```

## Con el SDK de PHP

```php
<?php

use Fiscalisto\Fiscalisto;

// La llave viene de FISCALISTO_API_KEY.
$fiscalisto = new Fiscalisto();

$data = $fiscalisto->warehouses->list()['data'];
```

## Con el SDK de .NET

```csharp
using Fiscalisto;

// La llave viene de FISCALISTO_API_KEY.
var fiscalisto = new FiscalistoClient();

var warehouseList = await fiscalisto.Warehouses.ListAsync();
```

## Con el SDK de Go

```go
package main

import (
	"context"
	"fmt"
	"log"

	fiscalisto "fiscalisto.com/go"
)

func main() {
	// La llave viene de FISCALISTO_API_KEY.
	client, err := fiscalisto.NewClient("")
	if err != nil {
		log.Fatal(err)
	}
	ctx := context.Background()

	warehouseList, err := client.Warehouses.List(ctx, nil)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", *warehouseList)
}
```

## Con el SDK de Java

```java
import com.fiscalisto.FiscalistoClient;

// La llave viene de FISCALISTO_API_KEY.
var fiscalisto = new FiscalistoClient();

var warehouseList = fiscalisto.warehouses().list();
System.out.println(warehouseList);
```

## Respuesta 200

Correcto.

Un objeto `WarehouseList`:

| Campo | Tipo | Siempre viene | Descripción |
| --- | --- | --- | --- |
| `object` | `"list"` | sí | Qué tipo de objeto es («invoice», «customer»…). |
| `data` | arreglo de objeto | sí | Los objetos de esta página. |
| `data[].id` | string | sí | Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). |
| `data[].livemode` | boolean | sí | true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. |
| `data[].object` | `"warehouse"` | sí | Qué tipo de objeto es («invoice», «customer»…). |
| `data[].issuer` | string | sí | El emisor del almacén. |
| `data[].name` | string | sí | Su nombre («Matriz», el de su sucursal, o el que le dieron en la app). |
| `data[].code` | string o null | sí | Su clave corta, o null. |
| `data[].type` | `warehouse`, `consignment` | sí | warehouse (almacén propio) o consignment (mercancía en consignación con un cliente, todavía suya). |
| `data[].branch` | string o null | sí | Su sucursal (brn_…), o null si es de la Matriz. |
| `data[].default` | boolean | sí | true si es el almacén del que vende y recibe su sucursal. |
| `data[].archived` | boolean | sí | true si está archivado. |
| `data[].created_at` | string (date-time) o null | sí | Cuándo se creó. |
| `has_more` | boolean | sí | true si hay más: pida la siguiente con starting_after igual al id del último. |
| `url` | string | sí | La ruta de esta lista. |

```json
{
  "object": "list",
  "data": [
    {
      "id": "whs_OufpKqnrvx9p1",
      "object": "warehouse",
      "livemode": false,
      "issuer": "iss_OufpKqnrvx9p",
      "name": "Matriz",
      "code": null,
      "type": "warehouse",
      "branch": null,
      "default": true,
      "archived": false,
      "created_at": "2026-10-27T09:12:00-06:00"
    }
  ],
  "has_more": false,
  "url": "/v1/warehouses"
}
```

## Errores

Puede responder 400, 401, 403, 404, 429, 500 con el cuerpo de error de siempre; cada código está en https://fiscalisto.com/docs/api/errores.md.