Queries — Status and History
Query the current status or full history of any request using codigoQiTech.
Query Current Status
ENDPOINT
/v1/vehicles/contracts/status/METHOD
GETScope: vehicles/read
Request
Request Params
| Field | Type | Description | Req. |
|---|---|---|---|
| codigoQiTech | String | Unique request identifier (up to 255 characters) | YES |
Response (200)
Response Body
| Field | Type | Description |
|---|---|---|
| codigoQiTech | String | Unique request identifier |
| etapaAtual | String | Process stage (Lien Registration / Contract Registration / Contract Addendum / Contract Image) |
| status | String | Current process status (see Status Map) |
| msgRetornoProvedor | String | Provider return message (populated on rejection) |
| msgRetornoPlataforma | String | Platform return message (populated on rejection) |
| dataUltimaAtualizacao | String | Last update date (YYYY-MM-DD) |
| chassi | String | Vehicle VIN |
| ufDeLicenciamento | String | Vehicle licensing state (UF) |
| numGravame | String | Lien number (up to 8 chars; "0" if not yet available) |
Query History
ENDPOINT
/v1/vehicles/contracts/history/METHOD
GETScope: vehicles/read
Request
Request Params
| Field | Type | Description | Req. |
|---|---|---|---|
| codigoQiTech | String | Unique request identifier (up to 255 characters) | YES |
Response (200)
Response Body
| Field | Type | Description |
|---|---|---|
| codigoQiTech | String | Unique request identifier |
| historicoGarantia | String | Description of operations performed with date/time for each |
| msgRetornoProvedor | String | Provider return message |
| msgRetornoPlataforma | String | Platform return message |
| chassi | String | Vehicle VIN |
| ufDeLicenciamento | String | Licensing state (UF) |
| numGravame | String | Lien number (up to 8 characters) |
Information
For returns "Denied", "Invalid Data", or "Invalid", at least one of msgRetornoPlataforma and msgRetornoProvedor will be populated with the reason.