> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cotizave.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Formatos JSON, CSV y XML

> Selecciona una representación y maneja los errores antes de interpretar el cuerpo.

<span id="como-se-pide" />

## Seleccionar formato

Usa `?format=json|csv|xml` o la cabecera `Accept` (`application/json`, `text/csv`, `application/xml`, `text/xml`). El query tiene prioridad. Sin una selección explícita, JSON es el formato por defecto; no uses el `Accept` de un navegador para elegir formatos automáticamente.

```bash theme={null}
curl --fail-with-body --max-time 10 -H "X-API-Key: $COTIZAVE_API_KEY" "https://api.cotizave.com/v1/fx/rates/reference?format=csv"
```

<span id="planes" />

## Acceso por plan

CSV y XML requieren **Esencial o superior**. JSON está disponible en todos los planes, sujeto al acceso al endpoint y al mercado. Elegir JSON no elimina el consumo normal de cuota.

<span id="csv" />

## Estructura CSV

CSV usa coma como separador y punto decimal. Los objetos se aplanan con nombres como `from.currency`. Si existe una colección de objetos, cada elemento forma una fila y los demás campos se repiten; las columnas de la colección llevan prefijo, como `rates.mid`. Las columnas incluyen la unión de campos presentes y pueden crecer.

Varias colecciones de objetos no caben en una tabla única: pueden producir `406 format_not_available`. Para `/route` usa JSON o XML. En hojas de cálculo selecciona explícitamente delimitador y formato numérico al importar.

<span id="xml" />

## Estructura XML

La raíz es `<response>`. Cada clave se representa como un elemento y los elementos de arrays se llaman `<item>`. Un campo nulo es un elemento vacío; un campo ausente se omite. Fragmento ilustrativo:

```xml theme={null}
<response><market>reference</market><type>reference</type><mid>475.0083</mid><updated_at>2026-10-19T04:00:00Z</updated_at><effective_date>2026-10-19</effective_date></response>
```

<span id="errores" />

## Comprobar el estado antes de interpretar

Los errores producidos por la API siguen siendo JSON aunque pidas CSV/XML; un proxy puede responder otro formato. `400 invalid_format` indica formato desconocido, `402 feature_not_in_plan` falta de acceso y `406 format_not_available` una representación incompatible. Los clientes JSON del inicio rápido son para JSON; no les pases `format=csv` o `xml`.

<span id="cobertura" />

## Cobertura

Esta selección se aplica a las rutas autenticadas con API Key descritas aquí. No habilita una utilidad desactivada, no convierte monedas y no cambia el idioma de los identificadores ni los nombres procedentes de la fuente.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.