> For the complete documentation index, see [llms.txt](https://docs.caf.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.caf.io/caf-api/core-api/transaction-details/background-check/kyc/driver.md). # Driver ## DENATRAN Driver Data + Traffic Violations Consultation of driver data and possible CPF traffic violations with Denatran. **Section:** `denatranDriverViolations` **Required parameters:** `cpf` {% tabs %} {% tab title="Schema" %} | Attribute | Type | Description | | ------------------------------------------------------------ | ------- | -------------------------------------------------------------------------------------------------------------- | | statusCode | String | Query status ([details](/caf-api/core-api/transaction-details/background-check/data-structure.md#status-code)) | | data | Object | Return data | | data.message | String | Description of the query status | | data.driver | Object | Contains the driver's information | | data.driver.isDriver | Boolean | If you have a driver for the document entered (T/F) | | data.driver.cnhNumber | String | CNH number | | data.driver.cnhIssuerAgency | String | CNH issuing agency | | data.driver.driverName | String | Driver's name | | data.driver.driverGender | String | Sex of the driver | | data.driver.driverBirthDate | String | Driver's date of birth | | data.driver.driverCpf | String | Driver's CPF | | data.driver.documentType | String | Document Type | | data.driver.driverDocumentType | String | Identity document type | | data.driver.driverDocumentIssuer | String | Document issuing agency | | data.driver.documentNumber | String | Document number | | data.driver.driverNationality | String | Nationality | | data.driver.driverMotherName | String | Mother's name | | data.driver.driverFatherName | String | Father's name | | data.driver.driverFirstLicenseDate | String | Date of first driver's license | | data.driver.pguId | String | PGU Code | | data.driver.cnhCategory | String | CNH Category | | data.driver.addressUsedCnhRequest | String | Cadastral address used in the CNH | | data.driver.addressStreet | String | Street address | | data.driver.addressNumber | String | Address number | | data.driver.addressComplement | String | Address complement | | data.driver.addressNeighborhood | String | Neighborhood | | data.driver.addressZipCode | String | ZIP code | | data.driver.addressCityCode | String | City code | | data.driver.addressCityName | String | City name | | data.driver.addressState | String | Address state | | data.driver.cnhStatus | String | CNH Status | | data.driver.previousCnhStatus | String | Previous CNH status | | data.driver.cnhExpirationDate | String | CNH expiration date | | data.driver.ufDomain | String | UF Domain | | data.driver.renachFormNumber | Number | Renach form number | | data.driver.cnhFormNumber | Number | CNH form number | | data.driver.impedimentListNumber | Number | Impediment list number | | data.driver.ufDocumentIssuer | String | State of the Document Sender | | data.driver.placeOfBirth | String | Birthplace | | data.driver.birthplaceCode | String | IBGE code of birthplace | | data.driver.birthplaceName | String | Name of birthplace | | data.driver.requestReason1 | String | Reason for request 1 | | data.driver.requestReason2 | String | Reason for request 2 | | data.driver.requestReason3 | String | Reason for request 3 | | data.driver.requestReason4 | String | Reason for request 4 | | data.driver.ufFirstDriverLicense | String | UF of first qualification | | data.driver.relegatedCategory | String | Downgraded Category | | data.driver.authorizedCategory | String | Authorized Category | | data.driver.ufCurrentDriverLicense | String | UF of current qualification | | data.driver.cnhRemarksTable | String | Current Observation Board | | data.driver.ufTransferApplicant | String | UF of the transfer requester | | data.driver.permitHolder | Number | Permissionary | | data.driver.cancellation | String | Cancellation | | data.driver.lastRecordEmissionDate | String | History Issue Date | | data.driver.lastTransitionUpdateId | String | Transaction code from the last update | | data.driver.lastTransitionUpdateDate | String | Transaction date of the last update | | data.driver.courseTppRating | String | TPP course rating | | data.driver.ufCourseTpp | String | TPP course UF | | data.driver.courseTeRating | String | TE course rating | | data.driver.ufCourseTe | String | UF of TE course | | data.driver.courseTcpRating | String | TCP course rating | | data.driver.ufCourseTcp | String | UF of course TCP | | data.driver.courseTveRating | String | TVE course rating | | data.driver.ufCourseTve | String | UF of course TVE | | data.driver.courseTciRating | String | TCI course rating | | data.driver.ufCourseTci | String | UF of TCI course | | data.driver.courseTmtRating | String | TMT course rating | | data.driver.ufCourseTmt | String | UF of TMT course | | data.driver.courseTmfRating | String | TMF course rating | | data.driver.ufCourseTmf | String | UF of TMF course | | data.driver.ufRecyclingCourseViolator | String | UF of offender refresher course | | data.driver.modalityRecyclingCourseViolator | String | Modality of the offender refresher course | | data.driver.ufRefreshCourseCnh | String | UF of the CNH renewal course | | data.driver.refreshCourseCnh | String | Modality of the CNH renewal course | | data.driver.nationalRegistrationForeigner | String | Foreign national registration | | data.driver.countryOriginDriverLicense | String | Country of origin of the foreign qualification | | data.driver.foreignDriverLicenseId | String | Identification of the foreign qualification | | data.driver.expirationDatePid | String | PID expiration date | | data.driver.ufExpeditionPid | String | UF of dispatch of the PID | | data.driver.numberFormCnhBasedPid | String | PID-based CNH form number | | data.driver.requestReasonPid1 | String | Reason for PID 1 request | | data.driver.requestReasonPid2 | String | Reason for PID 2 request | | data.driver.requestReasonPid3 | String | Reason for PID 3 request | | data.driver.requestReasonPid4 | String | Reason for PID 4 request | | data.driver.statusPid | String | PID Status | | data.driver.medicalRestrictions | String | Medical restrictions | | data.driver.quantityIncidentsImpediments | String | Number of Occurrences and/or Impediments | | data.violations | Array | List of traffic violations | | data.violations\[x].violationId | String | Infraction Code | | data.violations\[x].violationBreakdownId | String | Infraction Deployment Code | | data.violations\[x].violationDescription | String | Infraction Description | | data.violations\[x].renainfId | String | Renainf Code | | data.violations\[x].violationRegistrationDate | String | Date of Infraction Registration | | data.violations\[x].actuatorAgencyState | String | UF of the Authorizing Body | | data.violations\[x].plate | String | Plate | | data.violations\[x].renavamId | String | Renavam Code | | data.violations\[x].modelBrandId | String | Vehicle make and model code | | data.violations\[x].modelBrandDescription | String | Description of the vehicle make and model | | data.violations\[x].vehicleTypeId | Number | Vehicle type code | | data.violations\[x].vehicleTypeDescription | String | Vehicle type description | | data.violations\[x].vehicleColorId | Number | Vehicle color code | | data.violations\[x].vehicleColorDescription | String | Vehicle Color Description | | data.violations\[x].vehicleKindId | Number | Vehicle type code | | data.violations\[x].vehicleKindDescription | String | Description of the vehicle type | | data.violations\[x].vehicleBodyworkId | Number | Vehicle body code | | data.violations\[x].vehicleBodyworkDescription | String | Description of the vehicle body | | data.violations\[x].vehicleCategoryId | Number | Vehicle category code | | data.violations\[x].vehicleCategoryDescription | String | Vehicle category description | | data.violations\[x].vehicleJurisdictionState | String | UF of the vehicle's jurisdiction | | data.violations\[x].informedRegistrationState | String | State where the vehicle was registered | | data.violations\[x].registrationCityId | Number | Code of the municipality where the vehicle is registered | | data.violations\[x].registrationCityDescription | String | Description of the municipality where the vehicle is registered | | data.violations\[x].vehicleCoutryId | Number | Vehicle country code | | data.violations\[x].vehicleCoutryDescription | String | Country description of the vehicle | | data.violations\[x].restrictionId1 | Number | Restriction code 1 | | data.violations\[x].restrictionDescription1 | String | Description of Constraint 1 | | data.violations\[x].restrictionId2 | Number | Restriction code 2 | | data.violations\[x].restrictionDescription2 | String | Description of Constraint 2 | | data.violations\[x].restrictionId3 | Number | Restriction code 3 | | data.violations\[x].restrictionDescription3 | String | Description of Constraint 3 | | data.violations\[x].restrictionId4 | Number | Restriction code 4 | | data.violations\[x].restrictionDescription4 | String | Description of Constraint 4 | | data.violations\[x].restrictionIndicatorRenajud | Boolean | Renajud restriction indicator | | data.violations\[x].restrictionIndicatorRenavam | Boolean | Renavam restriction indicator | | data.violations\[x].burglaryTheftIndicatorRenavam | Boolean | Theft or Renavam indicator | | data.violations\[x].actuatorAgencyId | String | Code of the Notary Body | | data.violations\[x].actuatorAgencyDescription | String | Description of the Notifying Body | | data.violations\[x].autoInfractionNumber | String | Infraction notice number | | data.violations\[x].autoSignatureId | Number | Infringement notice signature indicator | | data.violations\[x].autoSignatureDescription | String | Description of signature on the infraction notice | | data.violations\[x].driverCnhModelId | Number | Driver's CNH model code | | data.violations\[x].driverCnhModelDescription | String | Description of the driver's CNH model | | data.violations\[x].driverCnhRegistrationNumber | String | Driver's CNH registration number code | | data.violations\[x].driverCnhExpeditionState | String | Description of the driver's CNH registration number | | data.violations\[x].violationDate | String | Date of infraction | | data.violations\[x].violationTime | String | Time of the infraction | | data.violations\[x].violationOccurrencePlace | String | Place where the infraction occurred | | data.violations\[x].violationCityId | String | City code of the infraction | | data.violations\[x].violationCityDescription | String | Description of the city of infringement | | data.violations\[x].autoTypeId | Number | Auto type code | | data.violations\[x].autoTypeDescription | String | Description of the auto type | | data.violations\[x].notLicensedDriverDocumentNumber | String | Document number of the unlicensed driver | | data.violations\[x].notLicensedDriverDocumentTypeId | Number | Unlicensed driver document number code | | data.violations\[x].notLicensedDriverDocumentTypeDescription | String | Description of the document number of the unlicensed driver | | data.violations\[x].actualMeasurement | String | Actual Measurement | | data.violations\[x].allowedLimit | String | Allowed Limit | | data.violations\[x].measurementConsidered | String | Measurement Considered | | data.violations\[x].measurementUnitId | Number | Unit of measure code | | data.violations\[x].measurementUnitDescription | String | Description of the unit of measure | | data.violations\[x].violationFullValue | String | Full value of the violation | | data.violations\[x].vehicleOwnerOriginId | Number | Code of the origin of the possessor | | data.violations\[x].vehicleOwnerOriginDescription | String | Description of the origin of the possessor | | data.violations\[x].ownerDocumentTypeId | Number | Code of the document type of the possessor | | data.violations\[x].ownerDocumentTypeDescription | String | Description of the possessor's document type | | data.violations\[x].ownerIdentificationNumber | String | Owner identification number | | data.violations\[x].ownerName | String | Owner's name | | data.violations\[x].notificationNoticeIssueDate | String | Date of issuance of the notice of violation | | data.violations\[x].defenseNoticeLimitDate | String | Deadline for defense of the infraction | | data.violations\[x].notificationNoticeIndicator | Boolean | Notification of notice indicator | | data.violations\[x].numberNotificationPenalty | String | Number of the penalty notice | | data.violations\[x].penaltyNotificationIssueDate | String | Date of issuance of penalty notice | | data.violations\[x].penaltyNotificationExpirationDate | String | Due date of penalty notice | | data.violations\[x].penaltyType | Number | Penalty Type | | data.violations\[x].penaltyDescription | String | Description of the penalty | | data.violations\[x].violatorActualName | String | Name of the real offender | | data.violations\[x].violatorActualCnhModelId | Number | Model code of the real offender's CNH | | data.violations\[x].violatorActualCnhModelDescription | String | Description of the model of the real offender's CNH | | data.violations\[x].violatorActualCnhRegistrationNumber | String | CNH registration number of the real offender | | data.violations\[x].driverActualCnhExpeditionState | String | UF of issue of the real driver's CNH | | data.violations\[x].scoreAnalysisStatusId | String | Score Analysis Status Indicator | | data.violations\[x].scoreAnalysisStatusDescription | String | Score Analysis Status Description | | data.violations\[x].scoredCnhModelId | Number | Model code of the scored CNH | | data.violations\[x].scoredCnhModelDescription | String | Description of the model of the scored CNH | | data.violations\[x].scoredCnhRegistrationNumber | String | Registration number of the scored CNH | | data.violations\[x].scoredCnhExpeditionState | String | UF of expedition of the scored CNH | | data.violations\[x].enforceabilityId | Number | Demandability Indicator | | data.violations\[x].enforceabilityDescription | String | Description of the enforceability indicator | | data.violations\[x].paymentState | String | Uf of payment | | data.violations\[x].violationPaymentDate | String | Date of payment of the infraction | | data.violations\[x].violationPaidValue | String | Paid amount of the infraction | | data.violations\[x].paymentRegistrationDate | String | Record date of payment of the infraction | | data.violations\[x].paymentsAmount | Number | Total payments | | data.violations\[x].occurrenceTypeId | Number | Occurrence type code | | data.violations\[x].occurrenceTypeDescription | String | Description of the type of occurrence | | data.violations\[x].occurrenceOriginDescription | String | Description of the origin of the occurrence | | data.violations\[x].proccessNumber | String | Case number | | {% endtab %} | | | {% tab title="Example" %} ```json { "statusCode": "01", "data": { "message": "Consulta realizada com sucesso", "driver": { "isDriver": true, "cnhIssuerAgency": "SSP/DI", "driverName": "JOHN DOE", "driverGender": "MASCULINO", "driverBirthDate": "08/05/1987", "driverCpf": "123.456.789-00", "documentType": "CARTEIRA IDENTIDADE", "driverDocumentType": "CARTEIRA IDENTIDADE", "driverDocumentIssuer": "SSP", "driverNationality": "BRASILEIRO", "driverMotherName": "MARIA DOE", "driverFatherName": "JOSEPH DOE", "driverFirstLicenseDate": "26/07/2017", "pguId": "000000000", "cnhCategory": "AB", "addressUsedCnhRequest": "R. Tiradentes, 1077 - sala 505 - Centro, Venâncio Aires - RS, 95800-000", "addressStreet": "R. Tiradentes", "addressNumber": "1077", "addressComplement": "sala 505", "addressNeighborhood": "Centro", "addressZipCode": "95800-000", "addressCityCode": "43188", "addressCityName": "Venâncio Aires", "addressState": "RS", "cnhStatus": "CONFIRMADA", "previousCnhStatus": "ALTERADA", "cnhExpirationDate": "07/05/2032", "ufDomain": "RS", "ufDocumentIssuer": "RS", "placeOfBirth": "VENANCIO AIRES", "birthplaceCode": "43188", "birthplaceName": "VENANCIO AIRES", "requestReason1": "RENOVACAO DE EXAMES", "requestReason2": "INEXISTENTE", "requestReason3": "INEXISTENTE", "requestReason4": "INEXISTENTE", "ufFirstDriverLicense": "RS", "relegatedCategory": "", "authorizedCategory": "AB", "ufCurrentDriverLicense": "RS", "cnhRemarksTable": "99", "ufTransferApplicant": "", "permitHolder": 2, "cancellation": "", "lastRecordEmissionDate": "07/05/2022", "lastTransitionUpdateId": "180", "lastTransitionUpdateDate": "09/05/2022", "courseTppRating": "INEXISTENTE", "ufCourseTpp": "", "courseTeRating": "INEXISTENTE", "ufCourseTe": "", "courseTcpRating": "INEXISTENTE", "ufCourseTcp": "", "courseTveRating": "INEXISTENTE", "ufCourseTve": "", "courseTciRating": "INEXISTENTE", "ufCourseTci": "", "courseTmtRating": "INEXISTENTE", "ufCourseTmt": "", "courseTmfRating": "INEXISTENTE", "ufCourseTmf": "", "ufRecyclingCourseViolator": "", "modalityRecyclingCourseViolator": "INEXISTENTE", "ufRefreshCourseCnh": "", "refreshCourseCnh": "INEXISTENTE", "nationalRegistrationForeigner": "", "countryOriginDriverLicense": "INEXISTENTE", "foreignDriverLicenseId": "", "expirationDatePid": "", "ufExpeditionPid": "", "numberFormCnhBasedPid": "0000000000", "requestReasonPid1": "INEXISTENTE", "requestReasonPid2": "INEXISTENTE", "requestReasonPid3": "INEXISTENTE", "requestReasonPid4": "INEXISTENTE", "statusPid": "", "medicalRestrictions": "", "quantityIncidentsImpediments": "0" }, "violations": [ { "violationId": "51620", "violationBreakdownId": "516201", "violationDescription": "Dirigir o veículo com CNH vencida há mais de 30 dias", "renainfId": "RS123456789", "violationRegistrationDate": "15/03/2022", "actuatorAgencyState": "RS", "plate": "ABC1234", "renavamId": "12345678901", "modelBrandId": "123456", "modelBrandDescription": "FIAT/UNO MILLE", "vehicleTypeId": 1, "vehicleTypeDescription": "AUTOMOVEL", "vehicleColorId": 1, "vehicleColorDescription": "BRANCA", "vehicleKindId": 1, "vehicleKindDescription": "PASSAGEIRO", "vehicleBodyworkId": 1, "vehicleBodyworkDescription": "HATCH", "vehicleCategoryId": 1, "vehicleCategoryDescription": "PARTICULAR", "vehicleJurisdictionState": "RS", "informedRegistrationState": "RS", "registrationCityId": 4308607, "registrationCityDescription": "GUAIBA", "vehicleCoutryId": 1, "vehicleCoutryDescription": "BRASIL", "restrictionId1": 0, "restrictionDescription1": "", "restrictionId2": 0, "restrictionDescription2": "", "restrictionId3": 0, "restrictionDescription3": "", "restrictionId4": 0, "restrictionDescription4": "", "restrictionIndicatorRenajud": false, "restrictionIndicatorRenavam": false, "burglaryTheftIndicatorRenavam": false, "actuatorAgencyId": "43086", "actuatorAgencyDescription": "DETRAN/RS", "autoInfractionNumber": "A123456789", "autoSignatureId": 1, "autoSignatureDescription": "CONDUTOR ASSINOU", "driverCnhModelId": 1, "driverCnhModelDescription": "MODELO ATUAL", "driverCnhRegistrationNumber": "00000000000", "driverCnhExpeditionState": "RS", "violationDate": "15/03/2022", "violationTime": "14:30", "violationOccurrencePlace": "AV BRASIL, 1000", "violationCityId": "4308607", "violationCityDescription": "GUAIBA", "autoTypeId": 1, "autoTypeDescription": "AUTO DE INFRACAO", "notLicensedDriverDocumentNumber": "", "notLicensedDriverDocumentTypeId": 0, "notLicensedDriverDocumentTypeDescription": "", "actualMeasurement": "", "allowedLimit": "", "measurementConsidered": "", "measurementUnitId": 0, "measurementUnitDescription": "", "violationFullValue": "293.47", "vehicleOwnerOriginId": 1, "vehicleOwnerOriginDescription": "CONDUTOR", "ownerDocumentTypeId": 1, "ownerDocumentTypeDescription": "CPF", "ownerIdentificationNumber": "12345678900", "ownerName": "JOHN DOE", "notificationNoticeIssueDate": "20/03/2022", "defenseNoticeLimitDate": "05/04/2022", "notificationNoticeIndicator": true, "numberNotificationPenalty": "P123456789", "penaltyNotificationIssueDate": "10/04/2022", "penaltyNotificationExpirationDate": "10/05/2022", "penaltyType": 1, "penaltyDescription": "MULTA GRAVISSIMA", "violatorActualName": "JOHN DOE", "violatorActualCnhModelId": 1, "violatorActualCnhModelDescription": "MODELO ATUAL", "violatorActualCnhRegistrationNumber": "00000000000", "driverActualCnhExpeditionState": "RS", "scoreAnalysisStatusId": "1", "scoreAnalysisStatusDescription": "PONTUADA", "scoredCnhModelId": 1, "scoredCnhModelDescription": "MODELO ATUAL", "scoredCnhRegistrationNumber": "00000000000", "scoredCnhExpeditionState": "RS", "enforceabilityId": 1, "enforceabilityDescription": "EXIGIVEL", "paymentState": "", "violationPaymentDate": "", "violationPaidValue": "", "paymentRegistrationDate": "", "paymentsAmount": 0, "occurrenceTypeId": 1, "occurrenceTypeDescription": "INFRACAO", "occurrenceOriginDescription": "DETRAN/RS", "proccessNumber": "" } ] } } ``` {% endtab %} {% tab title="Validations Rules" %} | Rule | Description | | -------------------------------- | ----------------------------------------------------------------- | | driver\_has\_traffic\_violations | Checks if there are any infringements for the document consulted. | | {% endtab %} | | | {% endtabs %} | | ## Driver data Returns essential information about the driver, including details of the National Driver's License (CNH), basic personal data, unpaid infractions, possible restrictions and a history of completed courses and exams. **Section:** `driverViolations` **Required parameter:** `cpf, registrationNumber (cnh)` {% tabs %} {% tab title="Schema" %} | Attribute | Type | Description | | ---------------------------------------------- | ------ | -------------------------------------------------------------------------------------------------------------- | | statusCode | String | Query status ([details](/caf-api/core-api/transaction-details/background-check/data-structure.md#status-code)) | | message | String | Descriptive with query status | | data | Object | Return data | | data.driverName | String | Driver's name | | data.cpf | String | CPF | | data.driverBirthDate | String | Driver's date of birth | | data.state | String | State | | data.driverMotherName | String | Mother's name | | data.driverFatherName | String | Father's name | | data.renachNumber | String | Renach number | | data.cnhNumber | String | Driver's license number | | data.cnhStatus | String | Driver's license status | | data.cnhCategory | String | Driver's license category | | data.cnhEmissionDate | String | Driver's license emission date | | data.cnhExpirationDate | String | Driver's license expiration date | | data.driverFirstLicenseDate | String | Date of first driver's license | | data.cnhObservation | String | Driver's license observation | | data.cnhOrdinance | String | Driver's license ordinance | | data.cnhImpediment | String | Driver's license impediment | | data.violations | Array | List of violations | | data.violations\[x].violationNumber | String | Violation number | | data.violations\[x].violationIssuer | String | Violation issuer | | data.violations\[x].violationDate | String | Violation date | | data.violations\[x].violationDescription | String | Violation description | | data.violations\[x].violationLicensePlate | String | Violation license plate | | data.violations\[x].violationLocation | String | Violation location | | data.violations\[x].violationPoints | String | Violation points | | data.violations\[x].violationNumberFine | String | Violation fine number | | data.violations\[x].violationProcess | String | Violation process | | data.violations\[x].violationSituation | String | Violation situation | | data.violations\[x].violationPointsResponsible | String | Violation points responsible | | data.violations\[x].violationValue | String | Violation value | | data.exams | Array | List of exams | | data.exams\[x].examDescription | String | Exam description | | data.exams\[x].examAllowedCategory | String | Exam allowed category | | data.exams\[x].examIntendedCategory | String | Exam intended category | | data.exams\[x].examCnpjEntity | String | Exam entity CNPJ | | data.exams\[x].examCpfProfessional1 | String | Exam professional CPF | | data.exams\[x].examCpfProfessional2 | String | Exam professional CPF | | data.exams\[x].examDate | String | Exam date | | data.exams\[x].examExpirationDate | String | Exam expiration date | | data.exams\[x].examCity | String | Exam city | | data.exams\[x].examState | String | Exam state | | data.exams\[x].examObservation | String | Exam observation | | data.exams\[x].examRestrictionsText | String | Exam restrictions message | | data.exams\[x].examResult | String | Exam result | | data.exams\[x].examUpdateType | String | Exam update type | | data.courses | Array | List of courses | | data.courses\[x].courseDescription | String | Course description | | data.courses\[x].courseWorkload | String | Course workload | | data.courses\[x].courseCategory | String | Course category | | data.courses\[x].courseCnpjEntity | String | Course entity CNPJ | | data.courses\[x].courseCpfProfessional | String | Course professional CPF | | data.courses\[x].courseStartDate | String | Course start date | | data.courses\[x].courseEndDate | String | Course end date | | data.courses\[x].courseExpirationDate | String | Course expiration date | | data.courses\[x].courseMode | String | Course mode | | data.courses\[x].courseCity | String | Course city | | data.courses\[x].courseState | String | Course state | | data.courses\[x].courseCertificateNumber | String | Course certificate number | | data.courses\[x].courseUpdateType | String | Course updateType | | data.blocks | Array | List of blocks | | data.blocks\[x].blockDescription | String | Block description | | data.blocks\[x].blockBlockDate | String | Block date | | data.blocks\[x].blockStartPenaltyDate | String | Block penalty start date | | data.blocks\[x].blockEndPenaltyDate | String | Block penalty end date | | data.blocks\[x].blockReleaseBlockDate | String | Block release date | | data.blocks\[x].blockGeneratorDoc | String | Block generator doc | | data.blocks\[x].blockReleaseBlockGeneratorDoc | String | Block release date generator doc | | data.blocks\[x].blockBlockReason | String | Block reason | | data.blocks\[x].blockReleaseBlockReason | String | Block release reason | | data.blocks\[x].blockRespAgency | String | Block responsible agency | | data.blocks\[x].blockReleaseBlockRespAgency | String | Block release responsible agency | | data.blocks\[x].blockDetranReleaseBlockState | String | Block release Detran state | | data.blocks\[x].blockPenaltyTerm | String | Block penalty term | | data.blocks\[x].blockTotalPenaltyTerm | String | Block total penalty term | | data.blocks\[x].blockCnhCollection | String | Block Driver's license collection | | data.blocks\[x].blockReleaseRequirements | String | Block release requirements | | data.blocks\[x].blockUpdateType | String | Block update type | | data.blocks\[x].blockBlockDecisionType | String | Block decision type | | data.blocks\[x].blockState | String | Block state | | {% endtab %} | | | {% tab title="Example" %} ```json { "statusCode": "01", "message": "Consulta realizada com sucesso.", "data": { "driverName": "Mario Lima", "cpf": "45678912300", "driverBirthDate": "1985-03-10", "state": "RS", "driverMotherName": "Laura Lima", "driverFatherName": "Carlos Lima", "renachNumber": "456789123", "cnhNumber": "789123456", "cnhStatus": "EMITIDA", "cnhCategory": "D", "cnhEmissionDate": "2010-03-10", "cnhExpirationDate": "2030-03-10", "driverFirstLicenseDate": "2005-03-10", "cnhObservation": "A", "cnhOrdinance": "000", "cnhImpediment": "NADA CONSTA", "violations": [ { "violationNumber": "003", "violationIssuer": "Detran RS", "violationDate": "2022-05-20", "violationDescription": "Uso de celular ao volante", "violationLicensePlate": "GHI-7890", "violationLocation": "Porto Alegre", "violationPoints": "4", "violationNumberFine": "789012", "violationProcess": "Em andamento", "violationSituation": "Não paga", "violationPointsResponsible": "Mario Lima", "violationValue": "100.00" } ], "exams": [ { "examDescription": "Exame Psicotécnico", "examAllowedCategory": "D", "examIntendedCategory": "D", "examCnpjEntity": "23.456.789/0001-00", "examCpfProfessional1": "456.789.123-00", "examCpfProfessional2": "321.654.987-00", "examDate": "2010-03-10", "examExpirationDate": "2030-03-10", "examCity": "Porto Alegre", "examObservation": "", "examRestrictionsText": "", "examResult": "Apto", "examUpdateType": "Inclusão", "examState": "RS" } ], "courses": [ { "courseDescription": "Curso de Transporte Coletivo", "courseWorkload": "50 horas", "courseCategory": "D", "courseCnpjEntity": "23.456.789/0001-00", "courseCpfProfessional": "456.789.123-00", "courseStartDate": "2010-03-10", "courseEndDate": "2010-04-10", "courseExpirationDate": "2030-03-10", "courseMode": "Presencial", "courseCity": "Porto Alegre", "courseCertificateNumber": "789123", "courseUpdateType": "Inclusão", "courseState": "RS" } ], "blocks": [ { "blockDescription": "Suspensão do direito de dirigir", "blockBlockDate": "2022-06-01", "blockEndPenaltyDate": "2022-12-01", "blockStartPenaltyDate": "2022-06-01", "blockReleaseBlockDate": "2022-12-01", "blockReleaseBlockGeneratorDoc": "456789", "blockGeneratorDoc": "123456", "blockBlockReason": "Excesso de pontos", "blockReleaseBlockReason": "Cumprimento da penalidade", "blockReleaseBlockRespAgency": "Detran RS", "blockRespAgency": "Detran RS", "blockPenaltyTerm": "6 meses", "blockTotalPenaltyTerm": "6 meses", "blockCnhCollection": "Sim", "blockReleaseRequirements": "Curso de reciclagem", "blockUpdateType": "Inclusão", "blockBlockDecisionType": "Administrativo", "blockState": "RS", "blockDetranReleaseBlockState": "RS" } ] } } ``` {% endtab %} {% tab title="Validations Rules" %} | Rule | Description | | ----------------------------------------- | ---------------------------------------------------- | | driver\_has\_pending\_traffic\_violations | Checks if the driver has pending traffic violations. | | {% endtab %} | | | {% endtabs %} | | --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.caf.io/caf-api/core-api/transaction-details/background-check/kyc/driver.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.