SIMIT — 免許停止
エンドポイント
GET https://api.verifik.co/v2/co/simit/suspensiones
SIMIT で、運転免許の停止・取消や関連制裁(ソースが返す場合は決議番号・日付など)を照会します。名義人は documentType と documentNumber で指定します。
ヘッダー
| 名前 | 値 |
|---|---|
| Accept | application/json |
| Authorization | Bearer <token> |
パラメーター
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
documentType | string | はい | 名義人の証明書種別。例: CC, PA, CE, TI, RC, NIT。 |
documentNumber | string | はい | 照会する番号(スペース・句読点なし)。長さ超過時は 409 になることがあります。 |
リクエスト
- Node.js
- Python
import axios from "axios";
const { data } = await axios.get("https://api.verifik.co/v2/co/simit/suspensiones", {
params: { documentType: "CC", documentNumber: "123456789" },
headers: {
Accept: "application/json",
Authorization: `Bearer ${process.env.VERIFIK_TOKEN}`,
},
});
console.log(data);
import os, requests
url = "https://api.verifik.co/v2/co/simit/suspensiones"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"documentType": "CC", "documentNumber": "123456789"}
r = requests.get(url, headers=headers, params=params)
print(r.json())
レスポンス
- 200
- 404
- 409
{
"data": {
"documentType": "CC",
"documentNumber": "123456789",
"firstName": "JUAN CARLOS",
"lastName": "PEREZ LOPEZ",
"fullName": "JUAN CARLOS PEREZ LOPEZ",
"suspensiones": [
{
"numeroResolucion": "RES-2024-000123",
"fechaSuspension": "2024/03/15",
"estado": "VIGENTE",
"motivo": "Sanción por acumulación de puntos"
}
]
},
"signature": {
"message": "Certified by Verifik.co",
"dateTime": "April 8, 2026 11:00 PM"
},
"id": "IDNT1"
}
{
"code": "NotFound",
"message": "Record not found."
}
{
"code": "MissingParameter",
"message": "missing documentType. missing documentNumber"
}
注記
- SIMIT はコロンビアの全国的交通違反・制裁データベースです。
dataのキー名や配列は上流の SIMIT に依存します(例は代表的な形)。suspensionesが空の場合は、その照会で停止がなかった可能性があります。