Skip to main content

RUNT - ナンバープレートのみの車両記録

ナンバープレートのみで RUNT の公式車両情報を照会します。車両（ナンバー・詳細） とは異なり、所有者の documentType および documentNumber は不要です。

所有者書類がなくても、コロンビアのプレートについて氏名・技術・状態ブロックが必要な場合に使います。

API が返す内容​

  • informacionGeneral — プレート、ブランド、ライン、モデル、クラス、サービス、状態、登録フィールド（ある場合）
  • datosTecnicos — 技術フィールド（ある場合）
  • soat[] や tecnoMecanica[] などの期限付きブロック（ある場合）
  • その他の RUNT 車両ブロック（solicitudes、polizasResponsabilidadCivil など、応答に含まれる場合）
  • documentType と documentNumber は null になることがあります
  • Verifik による署名済み応答

API リファレンス​

エンドポイント​

GET https://api.verifik.co/v2/co/runt/vehicle-by-plate-only

plate をクエリパラメータとして送信します。ハンドラは完全な RUNT 車両形を返します。氏名・技術・状態セクションは利用可能なときに含まれます。所有者書類フィールドは必須ではなく、null で返ることがあります。

ヘッダー​

名前値
Acceptapplication/json
AuthorizationBearer <token>

パラメータ​

名前型必須説明例
platestringはいコロンビアのナンバープレート。英数字 5〜9 文字。AA123BA

リクエスト​

import axios from "axios";

const { data } = await axios.get("https://api.verifik.co/v2/co/runt/vehicle-by-plate-only", {
	params: { plate: "AA123BA" },
	headers: {
		Accept: "application/json",
		Authorization: `Bearer ${process.env.VERIFIK_TOKEN}`,
	},
});
console.log(data);

レスポンス​

{
	"data": {
		"datosTecnicos": {
			"noEjes": "2",
			"pasajerosSentados": "5",
			"pesoBrutoVehicular": "1650"
		},
		"documentNumber": null,
		"documentType": null,
		"garantiasFavorDe": [],
		"garantiasMobiliarias": [],
		"informacionBlindaje": {},
		"informacionGeneral": {
			"cilidraje": "1600",
			"claseVehiculo": "AUTOMOVIL",
			"clasificacion": "AUTOMOVIL",
			"color": "BLANCO PERLA",
			"estadoDelVehiculo": "ACTIVO",
			"fechaMatricula": "15/03/2018",
			"linea": "COROLLA",
			"marca": "TOYOTA",
			"modelo": "2020",
			"noChasis": "9FB10000001",
			"noLicenciaTransito": "110000001",
			"noMotor": "MTR0000001",
			"noPlaca": "AA123BA",
			"noVin": "9FB10000001",
			"organismoTransito": "SECRETARIA DISTRITAL DE MOVILIDAD DE BOGOTA",
			"prendas": "NO",
			"puertas": "4",
			"repotenciado": "NO",
			"tarjetaRegistro": null,
			"tarjetaServicio": "NO",
			"tieneGravamenes": "NO",
			"tipoCarroceria": "SEDAN",
			"tipoCombustible": "GASOLINA",
			"tipoServicio": "Particular"
		},
		"limitacionPropiedad": [],
		"normalizacionSaneamiento": [],
		"plate": "AA123BA",
		"polizasResponsabilidadCivil": [],
		"soat": [
			{
				"entidadExpideSoat": "SEGUROS DEL ESTADO S.A.",
				"estado": "VIGENTE",
				"fechaExpedicion": "01/01/2024",
				"fechaVencimiento": "31/12/2024",
				"fechaVigencia": "02/01/2024",
				"noPoliza": "SOAT-000001",
				"tipoTarifa": "221"
			}
		],
		"solicitudes": [
			{
				"entidad": "SECRETARIA DISTRITAL DE MOVILIDAD DE BOGOTA",
				"estado": "AUTORIZADA",
				"fechaSolicitud": "15/03/2018",
				"noSolicitud": "110000001",
				"tramitesRealizados": "Tramite matricula inicial"
			}
		],
		"tarjetaOperacion": {},
		"tecnoMecanica": [
			{
				"vigente": "SI"
			}
		],
		"vin": "9FB10000001"
	},
	"signature": {
		"dateTime": "September 16, 2026 8:00 PM",
		"message": "Certified by Verifik.co"
	},
	"id": "ABCDE"
}

注意​

  • AppFeature コードは colombia_api_runt_vehicle_by_plate_only です。
  • このルートは GET /v2/co/runt/vehicle-by-plate のプレートのみ版です。所有者の documentType / documentNumber は受け付けません。
  • ペイロードの documentType と documentNumber は null になることがあります。
  • 氏名・技術・状態ブロックは存在する場合に返されます。空の配列やオブジェクトは、そのセクションに行がなかったことを意味します。
  • サンドボックスでは AA123BA と ABC10001–ABC10010 が安定した 200 を返します。ERR40401 は 404 NotFound です。
  • 409 はバリデーションエラーと、サービスが一時的に利用できない場合に使われます。