Patentes

Consultar patente

A partir de un dominio (patente), obtené los datos del vehículo. Elegí qué incluir con flags: radicación, detalles con valuación fiscal, y/o titular. Datos de fuentes públicas oficiales.

POST/api/v1/patentes/consulta—Consulta à la carte de un vehículo por dominio

Necesitás una API key de producto Patentes API. Una key de otro producto devuelve 403 FORBIDDEN.

Body

Parámetro	Tipo	Obligatorio	Descripción
`dominio`	string	Sí	Patente. Formato viejo ABC123 o Mercosur AB123CD (sin espacios ni guiones).
`radicacion`	boolean	No	Incluir registro seccional de radicación. Costo 1 crédito.
`detalles`	boolean	No	Incluir marca/modelo/año + valuación fiscal. Costo 2 créditos.
`titular`	boolean	No	Incluir titular (nombre/CUIT/DNI/domicilio/deuda). Costo 5 créditos.

Body — informe completo

{ "dominio": "AB123CD", "radicacion": true, "detalles": true, "titular": true }

Se corren solo las operaciones en true. Al menos una debe serlo. Un informe completo son las 3 = 8 créditos.

Costo en créditos

Operación	Devuelve	Cobertura	Costo
`radicacion`	Registro seccional (dirección, localidad, provincia)	Nacional	1
`detalles`	Marca/modelo/año + valuación fiscal oficial	Nacional	2
`titular`	Titular: nombre, CUIT/DNI, domicilio, deuda	~10 jurisdicciones	5

Solo se cobra lo que se obtiene. Si una operación falla o no está disponible (p.ej. titular fuera de las provincias de servicio), no consume su crédito y no bloquea a las demás.

Ejemplo de request

curl -X POST https://www.argenapi.com/api/v1/patentes/consulta \
  -H "Authorization: Bearer TU_API_KEY_PATENTES" \
  -H "Content-Type: application/json" \
  -d '{"dominio": "AB123CD", "radicacion": true, "detalles": true, "titular": true}'

Respuesta (200)

Cada operación pedida aparece en data (onull si no se obtuvo) y enoperaciones con su estado de cobro.

Respuesta — informe completo en CABA

{
  "success": true,
  "dominio": "AB123CD",
  "data": {
    "radicacion": {
      "dominio": "AB123CD",
      "tipo_vehiculo": "AUTOMOTOR",
      "registro_seccional": "02045 - CAPITAL FEDERAL N° 045",
      "direccion": "AV. CORRIENTES 1234",
      "localidad": "CABA",
      "provincia": "CAPITAL FEDERAL",
      "codigo_postal": "C1043",
      "telefono": "(011)43811234"
    },
    "detalles": {
      "patente": "AB123CD",
      "marca": "TOYOTA",
      "modelo": "COROLLA XEI 1.8 CVT",
      "anio": 2021,
      "valuacion": 25000000,
      "valuacion_fmt": "25.000.000",
      "descripcion": "COROLLA XEI 1.8 CVT 4 PUERTAS"
    },
    "titular": {
      "dominio": "AB123CD",
      "jurisdiccion": "CAPITAL FEDERAL",
      "titular": {
        "nombre": "GARCIA MARIA LAURA",
        "cuit": "27301234567",
        "dni": "30123456",
        "domicilio": "AV. CORRIENTES 1234, CABA",
        "vehiculo": "TOYOTA COROLLA XEI 1.8",
        "anio": 2021,
        "deuda": 0
      }
    }
  },
  "operaciones": {
    "radicacion": { "ok": true, "cobrado": true, "costo": 1, "cache": false, "consulta_id": "...", "provincia": "CAPITAL FEDERAL" },
    "detalles":   { "ok": true, "cobrado": true, "costo": 2, "cache": false, "consulta_id": "...", "provincia": null },
    "titular":    { "ok": true, "cobrado": true, "costo": 5, "cache": false, "consulta_id": "...", "provincia": "CAPITAL FEDERAL" }
  },
  "costo_total": 8,
  "credits_remaining": 192,
  "grupo_id": "...",
  "request_id": "..."
}

Respuesta — titular fuera de servicio (Buenos Aires): no cobra

{
  "success": true,
  "dominio": "HVF808",
  "data": {
    "radicacion": { "provincia": "BUENOS AIRES", "...": "..." },
    "titular": null
  },
  "operaciones": {
    "radicacion": { "ok": true,  "cobrado": true,  "costo": 1, "provincia": "BUENOS AIRES" },
    "titular":    { "ok": false, "cobrado": false, "costo": 5, "error_code": "OUT_OF_SERVICE", "provincia": "BUENOS AIRES" }
  },
  "costo_total": 1,
  "credits_remaining": 199,
  "grupo_id": "...",
  "request_id": "..."
}

Cobertura de Titular

Disponible en ~10 jurisdicciones: CABA, Córdoba (capital), Santa Fe, Tucumán, Jujuy, Catamarca, Santa Cruz, La Pampa, La Rioja y Misiones. No disponible en el resto (incluida Buenos Aires): en esos casos titular vuelve con OUT_OF_SERVICE y no se cobra. Radicación y detalles son nacionales.

Códigos por operación

error_code	Significado	Cobra
`OUT_OF_SERVICE`	Titular no disponible en esa provincia	No
`NOT_FOUND`	Patente no encontrada	No
`NO_VALUATION`	Vehículo identificado pero sin valuación fiscal	No
`UPSTREAM_ERROR`	Error del servicio de datos	No (se reembolsa)

Errores de la request

Status	Código	Causa
`402`	INSUFFICIENT_CREDITS	Créditos insuficientes para las operaciones pedidas
`422`	INVALID_INPUT	Dominio inválido o ninguna operación en true
`403`	FORBIDDEN	API key de otro producto
`401`	UNAUTHORIZED	API key faltante/invalida/revocada
`429`	RATE_LIMITED	Exceso de requests

Si success estrue pero ninguna operación fue cobrable (p.ej. patente inexistente), el status es 422 ycosto_total es 0.