REST API

API de valoraciones

Integra el tasador ARST directamente en tu flujo. Autenticación por API key, respuesta en JSON, sin SDK propietario.

https://rv.arstdata.com/api/v1

Autenticación

Los endpoints de valoración requieren un API key en el header Authorization.

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Formato

Bearer token (sk_live_…)

Crédito

1 por llamada a /valuation o /comparable

Rate limit

30 req / min / IP

Alternativa

Cookie arst_token (sesión web)

Genera tu API key en Mi cuenta → API Keys. El valor en claro se muestra solo al crear la key.

Endpoints

Códigos de error

HTTP	Causa
`401`	API key ausente o inválida
`402`	Sin créditos — recarga en /pricing
`422`	Parámetros inválidos (país, combustible…)
`503`	Modelo no disponible para ese país

Ejemplo rápido

CURL

curl -X POST 'https://rv.arstdata.com/api/v1/valuation' \
  -H 'Authorization: Bearer sk_live_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "country": "ES",
    "brand": "BMW",
    "model": "320D",
    "year": 2020,
    "km": 65000,
    "fuel": "diesel",
    "current_price": 25000
  }'

Límites de uso

Rate limit30 req/min/IP

Timeout60 s (primera carga ~5–20 s)

Payload max8 KB

PaísesES DE FR IT NL AT BE PT GB NO SE FI PL

Combustiblesdiesel · petrol · electric · hybrid · lpg

Swagger UI interactivo

Prueba los endpoints en el navegador con tu API key

Genera tu API key

Mi cuenta → API Keys → Nueva clave