get
https://example.com/api/accounts/terms
Obtiene los términos y condiciones disponibles y permite filtrarlos por mercado, tipo o versión.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Consultá los términos y condiciones disponibles y filtrá el resultado según el mercado, el tipo de término o la versión.
Antes de empezar
- Usá este endpoint cuando necesites recuperar los términos y condiciones vigentes para un flujo de alta o aceptación.
- Agregá filtros si querés limitar la búsqueda a un
market_type,terms_typeoversionespecíficos.
Cómo consultar términos y condiciones
GET /api/accounts/termsFiltrar por mercado
GET /api/accounts/terms?market_type=stock_marketFiltrar por tipo de término
GET /api/accounts/terms?terms_type=market_ordersFiltrar por versión
GET /api/accounts/terms?version=1.0.0Query parameters
| Parámetro | Tipo | Requerido | Default | Descripción |
|---|---|---|---|---|
market_type | string | No | — | Mercado al que pertenecen los términos. |
terms_type | string | No | — | Tipo de términos que querés consultar. |
version | string | No | — | Versión específica de los términos. |
show_id | boolean | No | false | Si enviás true, la respuesta incluye identificadores útiles para aceptar términos. |
Qué devuelve este endpoint
La respuesta devuelve un arreglo items. Cada elemento representa una versión disponible de términos y condiciones.
| Campo | Tipo | Descripción |
|---|---|---|
terms_and_conditions_id | integer | Identificador de los términos y condiciones. |
market_type | string | Mercado asociado. |
terms_type | string | Tipo de términos. |
version | string | Versión publicada. |
message | string | Texto descriptivo del término o nombre visible. |
Respuesta esperada
{
"items": [
{
"terms_and_conditions_id": 1,
"market_type": "stock_market",
"terms_type": "market_orders",
"version": "1.0.0",
"message": "Términos y condiciones"
}
]
}Cuándo usar este endpoint
Este endpoint es útil cuando necesitás:
- mostrar los términos vigentes al usuario
- identificar qué versión corresponde aceptar
- obtener el
terms_and_conditions_idpara usar enPOST /api/accounts/accept-terms-and-conditions
Errores frecuentes
422 Validation Error: alguno de los query parameters tiene un formato inválido.
Siguiente paso
Después de identificar los términos correctos, usá POST /api/accounts/accept-terms-and-conditions para registrar su aceptación.
