POST /api/v1/vehiculo/revision-tecnica · Referencia

Autenticación

Authorizationstringheaderrequerido

Envía Bearer TU_API_KEY con una clave activa de DatosPerú. Tu cuenta debe estar verificada y tener acceso a este endpoint.

Usa el botón Probar para consultar aquí. En tu aplicación, guarda la clave en el servidor o en el almacén de credenciales de tu herramienta.

Cuerpo de la solicitud

application/json

Envía un objeto JSON con los siguientes campos. Todos los valores son cadenas de texto. Los campos adicionales se rechazan.

placastringrequerido

La placa a consultar

Formato ^[A-Za-z0-9-]{5,9}$

Respuesta

200application/json

Las respuestas usan el mismo formato: success, data y meta. Un campo con null indica que no hay un valor disponible.

successbooleanrequerido

true cuando la consulta se completa correctamente.

dataobject[] | nullrequerido

Resultado normalizado de la consulta. Los campos opcionales dependen de la fuente.

Ver 13 atributos de cada elemento

placastring | nullopcional

Placa del vehículo

tipo_documentostring | nullopcional

Tipo de documento (NRO DE CERTIFICADO, NRO DE INFORME)

numero_certificadostring | nullopcional

Número de certificado o informe

vigente_desdestring | nullopcional

Fecha de inicio de vigencia

vigente_hastastring | nullopcional

Fecha de fin de vigencia

resultado_inspeccionstring | nullopcional

Resultado de la inspección (APROBADO, DESAPROBADO)

estadostring | nullopcional

Estado del certificado (VENCIDO, VIGENTE, etc.)

empresa_certificadorastring | nullopcional

Nombre de la empresa certificadora

direccionstring | nullopcional

Dirección del centro de inspección

ambitostring | nullopcional

Ámbito de la inspección

tipo_serviciostring | nullopcional

Tipo de servicio del vehículo (PARTICULAR, etc.)

observacionesstring | nullopcional

Observaciones de la inspección

ordenstring | nullopcional

Orden cronológico del registro (ULTIMO, PENULTIMO, ANTEPENULTIMO)

metaobjectrequerido

Información para identificar la solicitud.

Ver 2 atributos

request_idstringrequerido

Identificador único de la solicitud.

Formato uuid

timestampstringrequerido

Fecha y hora de la respuesta en UTC.

Formato date-time

Ver JSON Schema de data

{
  "type": [
    "array",
    "null"
  ],
  "description": "Historial de revisiones técnicas del vehículo",
  "items": {
    "type": [
      "object",
      "null"
    ],
    "properties": {
      "placa": {
        "type": [
          "string",
          "null"
        ],
        "description": "Placa del vehículo"
      },
      "tipo_documento": {
        "type": [
          "string",
          "null"
        ],
        "description": "Tipo de documento (NRO DE CERTIFICADO, NRO DE INFORME)"
      },
      "numero_certificado": {
        "type": [
          "string",
          "null"
        ],
        "description": "Número de certificado o informe"
      },
      "vigente_desde": {
        "type": [
          "string",
          "null"
        ],
        "description": "Fecha de inicio de vigencia"
      },
      "vigente_hasta": {
        "type": [
          "string",
          "null"
        ],
        "description": "Fecha de fin de vigencia"
      },
      "resultado_inspeccion": {
        "type": [
          "string",
          "null"
        ],
        "description": "Resultado de la inspección (APROBADO, DESAPROBADO)"
      },
      "estado": {
        "type": [
          "string",
          "null"
        ],
        "description": "Estado del certificado (VENCIDO, VIGENTE, etc.)"
      },
      "empresa_certificadora": {
        "type": [
          "string",
          "null"
        ],
        "description": "Nombre de la empresa certificadora"
      },
      "direccion": {
        "type": [
          "string",
          "null"
        ],
        "description": "Dirección del centro de inspección"
      },
      "ambito": {
        "type": [
          "string",
          "null"
        ],
        "description": "Ámbito de la inspección"
      },
      "tipo_servicio": {
        "type": [
          "string",
          "null"
        ],
        "description": "Tipo de servicio del vehículo (PARTICULAR, etc.)"
      },
      "observaciones": {
        "type": [
          "string",
          "null"
        ],
        "description": "Observaciones de la inspección"
      },
      "orden": {
        "type": [
          "string",
          "null"
        ],
        "description": "Orden cronológico del registro (ULTIMO, PENULTIMO, ANTEPENULTIMO)"
      }
    },
    "additionalProperties": false
  }
}

Errores

error.code · error.message

Una respuesta de error incluye success: false y los detalles en error. El panel de ejemplos muestra su estructura.

401

API Key ausente, inválida o revocada. Revisa la credencial.

403

Cuenta, verificación o permiso insuficiente. Revisa tu acceso.

404

Sin resultados o ruta inexistente. Comprueba los datos y el endpoint.

422

Parámetros inválidos. Corrige el cuerpo antes de reintentar.

429

Límite por minuto o cuota del periodo. Revisa el código de error y tu consumo.

502 / 504

Error o demora de la fuente. Reintenta con espera y un máximo de intentos.

503

Servicio no disponible o pendiente de configuración. Consulta el estado.

Consumo y disponibilidad

Una consulta exitosa consume un crédito. El plan Gratis incluye 100 créditos cada 30 días. Los planes mantienen límites por minuto, incluso con créditos ilimitados. Consulta los planes vigentes.

Los errores del proveedor liberan la reserva de crédito. Si recibes HTTP 429, revisa Retry-After antes de volver a consultar.

DatosPerú es un servicio independiente de las entidades públicas mencionadas y utiliza JSON.pe como proveedor. Consulta información que tengas autorización para tratar.