> For the complete documentation index, see [llms.txt](https://placapi.gitbook.io/placapi-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://placapi.gitbook.io/placapi-docs/avaluo-comercial-fasecolda/catalogo-de-marcas-modelos-y-versiones.md).

# Catálogo de marcas, modelos y versiones

`POST https://placapi.com/api/catalogo`

Marcas, modelos, referencias y versiones de vehículos en Colombia, en cascada para poblar un selector: sin filtros trae las marcas y los años; con `marca`, sus referencias; con `marca` + `modelo` (o + `referencia`), las versiones. Cada versión trae su código —el mismo que acepta `/api/avaluo-por-codigo`—, el valor de mercado (`valorUsado`), el precio 0km (`valorNuevo`, solo en años que aún se venden nuevos) y la ficha técnica: cilindraje, potencia, airbags, puertas y tracción. No pide placa ni documento del propietario. Cada lista viene `null` cuando su filtro ya está decidido; con `listas=todas` vuelven todas. Un filtro que no existe en el catálogo —o una combinación válida que no tiene ni una versión, como una marca que no vendió ese año— responde 404 `consulta_sin_resultado` y no cobra. Costo: 1 crédito por consulta con datos.

## Parámetros

| Campo           | Tipo    | Obligatorio | Detalle                                                                                                                                                                                                                                                                                                                                                                                          |
| --------------- | ------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `categoria`     | string  | No          | Tipo de vehículo: `automovil` (default, incluye las SUV de pasajeros), `camioneta` (pickup y camioneta de carga), `moto` (incluye motocarro), `carga` (pesado de carga), `bus` (bus, buseta y microbús) o `remolque`. Los tres pesados comparten catálogo de marcas en la fuente, así que al elegir uno la lista de marcas puede incluir las de los otros dos; las versiones sí salen separadas. |
| `soloConPrecio` | boolean | No          | `true` por defecto: solo devuelve las versiones con valor publicado para el año pedido. En `false` aparecen también las que existen sin precio para ese año (Toyota 2024 pasa de 44 a 401 versiones, casi todas en 0).                                                                                                                                                                           |
| `marca`         | string  | No          | Marca por nombre (`Toyota`) o por id del catálogo (`178`). Sin tildes ni mayúsculas importa.                                                                                                                                                                                                                                                                                                     |
| `modelo`        | string  | No          | Año del modelo (`2024`). En el catálogo vehicular colombiano «modelo» es el año, no la línea.                                                                                                                                                                                                                                                                                                    |
| `referencia`    | string  | No          | Referencia/línea por nombre o id, resuelta dentro de la marca elegida. Admite prefijo: `Corolla` encuentra `COROLLA [12] [FL]`.                                                                                                                                                                                                                                                                  |
| `listas`        | string  | No          | `todas` devuelve `marcas`, `modelos` y `referencias` aunque su filtro ya esté decidido. Útil para repintar los tres selectores de un formulario con una sola llamada; por defecto cada lista se omite cuando ya elegiste ese filtro.                                                                                                                                                             |
| `pagina`        | number  | No          | Página de versiones (default 1).                                                                                                                                                                                                                                                                                                                                                                 |
| `porPagina`     | number  | No          | Versiones por página (default 50, máximo 200).                                                                                                                                                                                                                                                                                                                                                   |
| `refresh`       | boolean | No          | Ignora la caché y vuelve a consultar la fuente oficial. Ojo: una consulta refrescada con datos siempre cobra (el hit de caché no).                                                                                                                                                                                                                                                               |

## Ejemplo

```bash
curl -X POST 'https://placapi.com/api/catalogo' \
  -H 'x-api-key: pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"placa": "ABC123"}'
```

El esquema completo de la respuesta está en el [OpenAPI 3.1](https://placapi.com/openapi.json) y en la [referencia interactiva](https://placapi.github.io/reference.html).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://placapi.gitbook.io/placapi-docs/avaluo-comercial-fasecolda/catalogo-de-marcas-modelos-y-versiones.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.