Registro Nacional · Costa Rica
Todo lo que el Registro
sabe de un vehículo,
en una llamada.
Consulte por placa o por VIN y reciba características, motor, propietarios y gravámenes en JSON. Sin scraping propio, sin sesiones que mantener.
Sin tarjeta. 7 días para probarlo.
- Si falla, no se cobra
-
Cada respuesta trae
cobraday su saldo restante. No hay que confiar: se verifica. - Historial del vehículo
- Quiénes fueron sus dueños anteriores y cuándo, qué gravámenes ha tenido, y qué cambió desde la última vez que se consultó.
- Vehículos de prueba
- Programe contra un caso con gravámenes sin consultar la placa de una persona real.
Pruébelo con una placa real
Una consulta por hora, sin crear cuenta.
Revisión técnica
Marchamo y traspaso son estimaciones referenciales sobre el valor fiscal, con las tarifas oficiales del año. El monto real lo dan el INS y la notaría.
Situación registral
Sus nombres e identificaciones se entregan por el API, a clientes identificados y con la consulta registrada; no en una demo abierta.
Qué trae cada respuesta
Lo que publica el Registro, más lo que se deduce o se consulta aparte: la
inspección y el vencimiento de Dekra, las estimaciones y el origen según la
NHTSA. Los nombres son los del JSON. Lo que el Registro no publica no se
inventa: el campo no viene o llega en null.
vehiculo
Vehículo
Lo que identifica al vehículo y lo distingue de otro igual, con sus pesos y medidas cuando el Registro los publica.
- marca
- estilo
- ano_fabricacion
- color
- carroceria
- traccion
- pbv
- vin
motor
Motor
La ficha mecánica que el Registro tiene inscrita.
- numero_motor
- cilindrada
- cilindros
- combustible
- potencia
propietarios
Propietarios
Los titulares registrales del vehículo.
- nombre
- tipo_identificacion
- numero_identificacion
gravamenes · anotaciones · infracciones · levantamientos
Situación registral
Si pesa algo sobre el vehículo: posee es true, false o null cuando el Registro no lo dijo. Los gravámenes y los levantamientos traen su detalle en items.
- posee
- items
inspeccion_tecnica
Inspección Dekra
El mes que toca la revisión, según el último dígito de la placa. Se puede hacer desde el mes anterior.
- mes
- mes_nombre
- desde_mes
vencimiento_dekra
Vencimiento Dekra
El día en que vence, según Dekra, y si de verdad venció: VIGENTE, VENCIDA o SIN_CONFIRMAR cuando lo que pasó fue un plazo de reinspección.
- fecha
- estado
- tipo
estimaciones
Estimaciones
Cuánto costarían el marchamo y el traspaso, sobre el valor fiscal y con las tarifas oficiales del año. Son referenciales.
- marchamo
- traspaso
- total
- rubros
/historial
Historia registral
Un endpoint aparte, GET /vehiculos/placa/{placa}/historial: la cronología del Registro con fechas, los traspasos y los gravámenes que ha tenido, cada acto con su categoría para distinguir una prenda de una afectación. Cuesta una consulta.
- movimientos
- traspasos
- gravamenes_historicos
- categoria
origen
Origen
Dónde se fabricó el vehículo, según su VIN y la NHTSA de Estados Unidos.
- pais_fabricacion
- fabricante
- anio_modelo
imagen
Foto del modelo
Una foto ilustrativa del mismo modelo y año, y del mismo color cuando la hay, de Wikimedia Commons, con licencia libre y el crédito listo para mostrar.
- url
- atribucion
- mismo_color
Se integra en una tarde
Una llamada HTTP con su clave en un encabezado. Sin SDK obligatorio, sin OAuth, sin tokens que renovar.
Si está valorando el otro camino, contamos en detalle qué implica consultar el Registro Nacional desde código: el ViewState, el WAF, el tope por cuenta y el parser que hay que mantener. Incluye cuándo sí le conviene hacerlo usted.
-
Sus claves las genera usted
Desde su portal, y las revoca cuando quiera.
-
Cada respuesta trae su saldo
En el cuerpo y en los encabezados. No hay que ir a preguntarlo.
-
Errores con nombre
vehiculo_no_encontradono es lo mismo queregistro_no_disponible, y su código lo puede distinguir.
# Por placa curl 'https://rnp.egobytes.com/api/v1/vehiculos/placa/BJK123' \ -H 'X-API-Key: rnp_su_clave' # Por VIN curl 'https://rnp.egobytes.com/api/v1/vehiculos/vin/8AJHA8CD704309461' \ -H 'X-API-Key: rnp_su_clave' # La historia registral: traspasos, movimientos y gravámenes históricos curl 'https://rnp.egobytes.com/api/v1/vehiculos/placa/BJK123/historial' \ -H 'X-API-Key: rnp_su_clave'
import os, requests r = requests.get( 'https://rnp.egobytes.com/api/v1/vehiculos/placa/BJK123', headers={'X-API-Key': os.environ['RNP_API_KEY']}, timeout=45, # el Registro tarda entre 3 y 10 s ) d = r.json() # Tres estados, no dos: None es "el Registro no lo dijo". posee = d['datos']['gravamenes']['posee'] print(d['datos']['vehiculo']['marca'], posee, d['saldo']['total'])
const r = await fetch( 'https://rnp.egobytes.com/api/v1/vehiculos/placa/BJK123', { headers: { 'X-API-Key': process.env.RNP_KEY } } ) const { datos, cobrada, saldo } = await r.json() // Solo se descontó si la consulta salió completa console.log(datos.vehiculo.marca, saldo.total)
$r = Http::withHeaders(['X-API-Key' => config('rnp.key')]) ->get('https://rnp.egobytes.com/api/v1/vehiculos/placa/BJK123'); $vehiculo = $r->json('datos.vehiculo'); $saldo = $r->json('saldo.total');
Precios
Se paga por consulta que sale bien. Las que fallan no se descuentan, y eso incluye las que el Registro devuelve a medias.
Mensual
Prepago · sin mensualidad
Precios en dólares, con el 13 % de IVA ya incluido. Se emite factura electrónica si la solicita.
Lo que este servicio no es
No es una certificación
Presentamos lo que publica el Registro Nacional. No lo generamos, no lo validamos y no lo certificamos. Para un trámite legal se necesita una certificación registral, y esto no la sustituye.
No es independiente del Registro
Si el Registro Nacional está caído o lento, esto también. Cuando pasa, la consulta no se cobra y la respuesta lo dice con un código que su sistema puede leer.
No es un buscador de personas
Los datos de propietarios llegan por el API, a clientes identificados y con cada consulta registrada. Nunca en la demo abierta de esta página.
Preguntas frecuentes
¿Existe un API para consultar placas de Costa Rica?
Sí. Registro Nacional CR API consulta el Registro Nacional de Costa Rica por placa o por VIN y devuelve la información en JSON. El Registro Nacional no publica un API propio, así que la consulta programática se hace a través de servicios como este.
¿Cómo consulto un vehículo por su número de placa desde mi programa?
Con una petición GET a https://rnp.egobytes.com/api/v1/vehiculos/placa/{placa}, enviando su clave en el encabezado X-API-Key. Para carga liviana se agrega el parámetro clase=CL y para motocicleta clase=MOT; en ambos casos en la ruta va solo lo que sigue al prefijo que lleva pintado la placa.
¿Qué datos devuelve la consulta de un vehículo?
Características del vehículo (marca, estilo, año, color, capacidad, VIN), datos de motor (número, cilindrada, cilindros, combustible), propietarios registrales con su identificación, y la situación registral: gravámenes, anotaciones, infracciones y levantamientos.
¿Se puede consultar un vehículo por VIN o número de chasis?
Sí, con una petición GET a https://rnp.egobytes.com/api/v1/vehiculos/vin/{vin}. Devuelve la misma información que la consulta por placa.
¿Se puede consultar el historial de un vehículo en Costa Rica: traspasos y gravámenes anteriores?
Sí, con una petición GET a https://rnp.egobytes.com/api/v1/vehiculos/placa/{placa}/historial. Devuelve la historia registral que publica el Registro Nacional: los movimientos en orden cronológico con su cita y su fecha, los traspasos con el dueño anterior de cada uno (quién fue, cuándo y con qué documento) y los gravámenes y afectaciones que el vehículo ha tenido, vigentes o no. Cada acto trae una categoría estable, por ejemplo PRENDA o AFECTACION, para distinguir una prenda de una denuncia sin leer el texto del Registro, y total_cambios_de_dueno cuenta solo los cambios de dueño de verdad. También dice qué cambió desde la última vez que se consultó esa placa. Se cobra como una consulta.
¿Cómo saber si un vehículo tiene gravámenes o prendas en Costa Rica?
La respuesta incluye un bloque de gravámenes con el campo posee y el detalle de cada asiento registral. Ese campo tiene tres estados: verdadero, falso, y nulo cuando el Registro Nacional no lo indicó, que no debe interpretarse como ausencia de gravámenes.
¿Cuánto cuesta consultar una placa por API en Costa Rica?
Los planes mensuales son: 100 consultas al mes por USD 11.30; 250 consultas al mes por USD 22.60 y 500 consultas al mes por USD 33.90. Las cuentas nuevas incluyen consultas gratuitas para probar, sin tarjeta.
¿Qué pasa si el Registro Nacional está caído?
La consulta devuelve un código de error identificable y no se cobra. Cada respuesta indica en el campo cobrada si se descontó del saldo o no.
¿Este servicio sustituye una certificación registral?
No. Presenta información publicada por el Registro Nacional de Costa Rica, pero no la genera, no la valida y no la certifica. Para cualquier trámite legal se requiere la certificación oficial del Registro Nacional.
¿Hay bibliotecas para PHP o JavaScript?
Sí. Para PHP, el paquete egobytes/rnp-api en Packagist. Para JavaScript y TypeScript, @egobytes/rnp-api en npm. La especificación OpenAPI está publicada en https://rnp.egobytes.com/openapi.json.
10 consultas para comprobarlo
Cree su cuenta, genere su clave y haga la primera llamada. Sin tarjeta, y 7 días para decidir.
Crear cuenta gratis