La Consulta Vehicular devuelve la ficha de un vehículo registrado en SUNARP a partir de su placa: marca, modelo, año, color, número de serie, VIN, motor, sede registral, estado, anotaciones y propietarios, junto con la imagen del documento.Es un proceso en dos pasos:
POST con la placa → respuesta 202 con un task_id.
Obtener resultado con ese task_id hasta que el estado deje de ser pending.
SUNARP atiende un número limitado de consultas por minuto y cada una puede tardar varios segundos. Este endpoint acepta tus placas de inmediato, sin importar cuántas envíes de golpe, y las resuelve por detrás a ritmo controlado y con reintentos automáticos. Una consulta suelta suele resolverse en menos de 30 segundos; en un lote, el tiempo total depende del ritmo de la fuente.
La ruta síncrona POST /v2/consulta/vehicular está deprecada. Sigue respondiendo para las integraciones existentes, pero dejará de hacerlo en una fecha que comunicaremos con anticipación. Migra a este flujo en dos pasos.
¿Todavía no tienes un API token? El campo Authorization del panel Try it espera tu token Bearer. Revisa dónde obtener tu API token para conseguirlo.
Este endpoint requiere autenticación Bearer. Incluye tu API key en el header Authorization (si aún no sabes cómo obtener y usar tu API key, consulta la página de Autenticación):
Cada consulta descuenta 1 de tu cuota de Consulta Vehicular al ser aceptada (respuesta 202). Los headers X-Quota-Limit y X-Quota-Remaining de esa respuesta traen tu cuota total y la restante.
El campo plate es requerido o no tiene 6 caracteres alfanuméricos. Detalle en errors
429
Demasiadas solicitudes - se ha excedido el límite de rate
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Verifica API Documentation","colors":{"primary":"#6C3DF4","light":"#A78BFA","dark":"#6C3DF4"},"logo":{"light":"https://mintcdn.com/verificaid/g8rYWa4eEdhxrdlF/logo/light.svg?fit=max\u0026auto=format\u0026n=g8rYWa4eEdhxrdlF\u0026q=85\u0026s=10f01f31aee182a66bfc8e867016ba09","dark":"https://mintcdn.com/verificaid/g8rYWa4eEdhxrdlF/logo/dark.svg?fit=max\u0026auto=format\u0026n=g8rYWa4eEdhxrdlF\u0026q=85\u0026s=393e069d421aa5dbb5da491835bc88b9"},"favicon":"https://mintcdn.com/verificaid/g8rYWa4eEdhxrdlF/favicon.svg?fit=max\u0026auto=format\u0026n=g8rYWa4eEdhxrdlF\u0026q=85\u0026s=a4d7ab620df8acaddb3b282a21370325","api":{"openapi":"openapi.json","mdx":{"auth":{"method":"bearer"},"server":"https://api.verifica.id"}},"appearance":{"default":"system"},"navbar":{"links":[{"href":"https://wa.me/51973215774","label":"Support"}],"primary":{"type":"button","label":"Home","href":"https://verifica.id"}},"footer":{"socials":{"github":"https://github.com/verifica-id","youtube":"https://www.youtube.com/@verificaid"}},"fonts":{"heading":{"family":"General Sans","weight":600,"source":"fonts/general-sans.woff2","format":"woff2"},"body":{"family":"General Sans","weight":500,"source":"fonts/general-sans.woff2","format":"woff2"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Youtube demos","icon":"youtube","href":"https://www.youtube.com/@verificaid"},{"anchor":"Blog","icon":"newspaper","href":"https://verifica.id/blog/"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"verificaid","hasAudioNarration":false,"actualSubdomain":"verificaid","customDomains":["developers.verifica.id"],"gitSource":{"type":"github","owner":"verifica-id","repo":"mintlify-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6aee22eeac10b0c1189af195","clientVersion":"0.0.4087","searchFilterCounts":[{"language":"default","tag":"API Reference","count":17},{"language":"default","tag":"Documentation","count":6},{"language":"default","tag":"Consulta Datos Públicos","count":6},{"language":"default","tag":"Comenzando","count":3},{"language":"default","tag":"Soluciones Compliance","count":3},{"language":"default","tag":"Consulta Asertiva","count":3},{"language":"default","tag":"FirmaID","count":3},{"language":"default","tag":"Guías","count":3},{"language":"default","tag":"Match de Datos RENIEC","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"/* cyrillic-ext */\n@font-face {\n font-family: 'Fragment Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/fragmentmono/v6/4iCr6K5wfMRRjxp0DA6-2CLnB45HhrUI.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Fragment Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/fragmentmono/v6/4iCr6K5wfMRRjxp0DA6-2CLnB41HhrUI.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Fragment Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/fragmentmono/v6/4iCr6K5wfMRRjxp0DA6-2CLnB4NHhg.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n:root{--vid-paper: #FAFAF7}html:not(.dark),html:not(.dark) body,html:not(.dark) main,html:not(.dark) #content-area{background-color:var(--vid-paper)!important}code,pre,kbd,.font-mono{font-family:\"Fragment Mono\", ui-monospace, SFMono-Regular, Menlo, monospace}"}],"page":{"pagePath":"api-reference/vehicle/create-vehicle-query","slug":"/api-reference/vehicle/create-vehicle-query","pageMetadata":{"title":"Crear consulta vehicular","description":"Encola la consulta de un vehículo por su placa y devuelve un task_id.","api":"POST /api/v1/solutions/consulta/vehicular","auth":"bearer","href":"/api-reference/vehicle/create-vehicle-query"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Encola la consulta de un vehículo por su placa y devuelve un task_id.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Expandable,Heading,Note,ParamField,ResponseField,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`La `,_jsx(_components.strong,{children:`Consulta Vehicular`}),` devuelve la ficha de un vehículo registrado en SUNARP a partir de su placa: marca, modelo, año, color, número de serie, VIN, motor, sede registral, estado, anotaciones y propietarios, junto con la imagen del documento.`]}),`\n`,_jsxs(_components.p,{children:[`Es un proceso en `,_jsx(_components.strong,{children:`dos pasos`}),`:`]}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`POST`}),` con la placa → respuesta `,_jsx(_components.code,{children:`202`}),` con un `,_jsx(_components.code,{children:`task_id`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/api-reference/vehicle/get-vehicle-query`,children:`Obtener resultado`}),` con ese `,_jsx(_components.code,{children:`task_id`}),` hasta que el estado deje de ser `,_jsx(_components.code,{children:`pending`}),`.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`cuándo-usar-este-endpoint`,children:`Cuándo usar este endpoint`}),`\n`,_jsx(_components.p,{children:`SUNARP atiende un número limitado de consultas por minuto y cada una puede tardar varios segundos. Este endpoint acepta tus placas de inmediato, sin importar cuántas envíes de golpe, y las resuelve por detrás a ritmo controlado y con reintentos automáticos. Una consulta suelta suele resolverse en menos de 30 segundos; en un lote, el tiempo total depende del ritmo de la fuente.`}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`La ruta síncrona `,_jsx(_components.code,{children:`POST /v2/consulta/vehicular`}),` está `,_jsx(_components.strong,{children:`deprecada`}),`. Sigue respondiendo para las integraciones existentes, pero dejará de hacerlo en una fecha que comunicaremos con anticipación. Migra a este flujo en dos pasos.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`autenticación`,children:`Autenticación`}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`¿Todavía no tienes un API token?`}),` El campo `,_jsx(_components.code,{children:`Authorization`}),` del panel `,_jsx(_components.strong,{children:`Try it`}),` espera tu token Bearer. Revisa `,_jsx(_components.a,{href:`/api-reference/authentication#d%C3%B3nde-obtener-tu-api-token`,children:`dónde obtener tu API token`}),` para conseguirlo.`]})}),`\n`,_jsxs(_components.p,{children:[`Este endpoint requiere autenticación Bearer. Incluye tu API key en el header Authorization (si aún no sabes cómo obtener y usar tu API key, consulta la página de `,_jsx(_components.a,{href:`/api-reference/authentication`,children:`Autenticación`}),`):`]}),`\n`,_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Authorization: Bearer YOUR_API_KEY`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Heading,{level:`2`,id:`atributos-requeridos`,children:`Atributos Requeridos`}),`\n`,_jsx(ParamField,{body:`plate`,type:`string`,required:true,id:`param-plate`,children:_jsxs(_components.p,{children:[`Placa del vehículo. Exactamente 6 caracteres alfanuméricos, sin guion (por ejemplo `,_jsx(_components.code,{children:`B7K512`}),`).`]})}),`\n`,_jsx(Heading,{level:`2`,id:`respuesta`,children:`Respuesta`}),`\n`,_jsx(ResponseField,{name:`status`,type:`string`,id:`param-status`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`success`}),` cuando la consulta fue aceptada.`]})}),`\n`,_jsx(ResponseField,{name:`message`,type:`string`,id:`param-message`,children:_jsx(_components.p,{children:`Mensaje descriptivo.`})}),`\n`,_jsx(ResponseField,{name:`data`,type:`object`,id:`param-data`,children:_jsx(Expandable,{title:`propiedades de data`,children:_jsx(ResponseField,{name:`task_id`,type:`string`,id:`param-task-id`,children:_jsxs(_components.p,{children:[`Identificador de la consulta (UUID). Úsalo en `,_jsx(_components.a,{href:`/api-reference/vehicle/get-vehicle-query`,children:`Obtener resultado`}),`.`]})})})}),`\n`,_jsx(Heading,{level:`2`,id:`ejemplo-de-solicitud`,children:`Ejemplo de Solicitud`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`6`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`6`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --request`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --url`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.verifica.id/api/v1/solutions/consulta/vehicular`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Accept: application/json'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Content-Type: application/json'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Authorization: Bearer {TU-API-KEY}'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --data`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{\"plate\": \"B7K512\"}'`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`ejemplo-de-respuesta`,children:`Ejemplo de Respuesta`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`7`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"success\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Consulta recibida y en proceso.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"task_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"01a17d31-e5ef-7aa1-9c3b-2f6d8e4a1b70\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`consumo-de-cuota`,children:`Consumo de cuota`}),`\n`,_jsxs(_components.p,{children:[`Cada consulta descuenta `,_jsx(_components.strong,{children:`1`}),` de tu cuota de `,_jsx(_components.strong,{children:`Consulta Vehicular`}),` al ser aceptada (respuesta `,_jsx(_components.code,{children:`202`}),`). Los headers `,_jsx(_components.code,{children:`X-Quota-Limit`}),` y `,_jsx(_components.code,{children:`X-Quota-Remaining`}),` de esa respuesta traen tu cuota total y la restante.`]}),`\n`,_jsx(Heading,{level:`2`,id:`códigos-de-error`,children:`Códigos de Error`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Código`}),_jsx(_components.th,{children:`Descripción`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`401`}),_jsx(_components.td,{children:`Token de autenticación inválido o faltante`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`402`}),_jsx(_components.td,{children:`No tienes cuota disponible de Consulta Vehicular`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`422`}),_jsxs(_components.td,{children:[`El campo `,_jsx(_components.code,{children:`plate`}),` es requerido o no tiene 6 caracteres alfanuméricos. Detalle en `,_jsx(_components.code,{children:`errors`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`429`}),_jsx(_components.td,{children:`Demasiadas solicitudes - se ha excedido el límite de rate`})]})]})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Crear consulta vehicular","description":"Encola la consulta de un vehículo por su placa y devuelve un task_id.","api":"POST /api/v1/solutions/consulta/vehicular","auth":"bearer","href":"/api-reference/vehicle/create-vehicle-query"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Cuándo usar este endpoint","slug":"cuándo-usar-este-endpoint","depth":2,"children":[]},{"title":"Autenticación","slug":"autenticación","depth":2,"children":[]},{"title":"Atributos Requeridos","slug":"atributos-requeridos","depth":2,"children":[]},{"title":"Respuesta","slug":"respuesta","depth":2,"children":[]},{"title":"Ejemplo de Solicitud","slug":"ejemplo-de-solicitud","depth":2,"children":[]},{"title":"Ejemplo de Respuesta","slug":"ejemplo-de-respuesta","depth":2,"children":[]},{"title":"Consumo de cuota","slug":"consumo-de-cuota","depth":2,"children":[]},{"title":"Códigos de Error","slug":"códigos-de-error","depth":2,"children":[]}],"codeExamples":{},"endpoint":{"title":"Crear consulta vehicular","path":"/api/v1/solutions/consulta/vehicular","servers":[{"url":"https://api.verifica.id"}],"method":"post","request":{"security":[{"title":"Bearer Auth","parameters":{"header":{"Authorization":{"type":"http","scheme":"bearer","description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token."}},"query":{},"cookie":{}}}],"parameters":{"query":{},"header":{},"cookie":{},"path":{}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"plate":[{"type":"string","description":"Placa del vehículo. Exactamente 6 caracteres alfanuméricos, sin guion (por ejemplo `B7K512` ).","required":true}]}}],"examples":{"example":{"value":{"plate":"\u003cstring>"}}}}}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"status":[{"type":"string","description":"`success` cuando la consulta fue aceptada."}],"message":[{"type":"string","description":"Mensaje descriptivo."}],"data":[{"type":"object","properties":{"task_id":[{"type":"string","description":"Identificador de la consulta (UUID). Úsalo en Obtener resultado ."}]}}]}}],"examples":{"example":{"value":{"status":"\u003cstring>","message":"\u003cstring>","data":{"task_id":"\u003cstring>"}}}}}}},"deprecated":false}},"jsLinks":["/_mintlify/custom/verificaid/66aa1a3eaf0fdb69/fix-breadcrumbs-schema.js"],"subdomain":"verificaid","siteName":"Verifica API Documentation","title":"Crear consulta vehicular - Verifica API Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-06T18:56:51.017Z","originalFileLocation":"api-reference/vehicle/create-vehicle-query.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Encola la consulta de un vehículo por su placa y devuelve un task_id.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Verifica API Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/verificaid/V93VIEiN77Y1shdY/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/verificaid/V93VIEiN77Y1shdY/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/verificaid/V93VIEiN77Y1shdY/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/verificaid/V93VIEiN77Y1shdY/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/verificaid/V93VIEiN77Y1shdY/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/verificaid/V93VIEiN77Y1shdY/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/verificaid/V93VIEiN77Y1shdY/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/verificaid/V93VIEiN77Y1shdY/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/verificaid/V93VIEiN77Y1shdY/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Crear consulta vehicular - Verifica API Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Encola la consulta de un vehículo por su placa y devuelve un task_id.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Verifica API Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.verifica.id/api-reference/vehicle/create-vehicle-query\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://verificaid.mintlify.site/_mintlify/api/og/v2?division=Consulta+Datos+P%C3%BAblicos\u0026amp;title=Crear+consulta+vehicular\u0026amp;description=Encola+la+consulta+de+un+veh%C3%ADculo+por+su+placa+y+devuelve+un+task_id.\u0026amp;theme=ad959699d5d1872a9079357b\u0026amp;signature=90b8ca9d9ee0e63d3f45a15ca74e42f1feae89889b897877f071a3bda90071c2\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Crear consulta vehicular - Verifica API Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Encola la consulta de un vehículo por su placa y devuelve un task_id.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://verificaid.mintlify.site/_mintlify/api/og/v2?division=Consulta+Datos+P%C3%BAblicos\u0026amp;title=Crear+consulta+vehicular\u0026amp;description=Encola+la+consulta+de+un+veh%C3%ADculo+por+su+placa+y+devuelve+un+task_id.\u0026amp;theme=ad959699d5d1872a9079357b\u0026amp;signature=90b8ca9d9ee0e63d3f45a15ca74e42f1feae89889b897877f071a3bda90071c2\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/verificaid/V93VIEiN77Y1shdY/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Verifica API Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6C3DF4\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers.verifica.id/api-reference/vehicle/create-vehicle-query\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/vehicle/create-vehicle-query.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developers.verifica.id/#organization\",\"name\":\"Verifica API Documentation\",\"url\":\"https://developers.verifica.id\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/verificaid/g8rYWa4eEdhxrdlF/logo/light.svg?fit=max\u0026auto=format\u0026n=g8rYWa4eEdhxrdlF\u0026q=85\u0026s=10f01f31aee182a66bfc8e867016ba09\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developers.verifica.id#website\",\"name\":\"Verifica API Documentation\",\"url\":\"https://developers.verifica.id\",\"publisher\":{\"@id\":\"https://developers.verifica.id/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers.verifica.id/api-reference/vehicle/create-vehicle-query#webpage\",\"url\":\"https://developers.verifica.id/api-reference/vehicle/create-vehicle-query\",\"name\":\"Crear consulta vehicular\",\"description\":\"Encola la consulta de un vehículo por su placa y devuelve un task_id.\",\"dateModified\":\"2026-11-06T18:56:51.017Z\",\"isPartOf\":{\"@id\":\"https://developers.verifica.id#website\"},\"breadcrumb\":{\"@id\":\"https://developers.verifica.id/api-reference/vehicle/create-vehicle-query#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.verifica.id/api-reference/vehicle/create-vehicle-query#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Verifica API Documentation\",\"item\":\"https://developers.verifica.id\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Crear consulta vehicular\",\"item\":\"https://developers.verifica.id/api-reference/vehicle/create-vehicle-query\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developers.verifica.id/api-reference/vehicle/create-vehicle-query#apireference\",\"headline\":\"Crear consulta vehicular\",\"name\":\"Crear consulta vehicular\",\"description\":\"Encola la consulta de un vehículo por su placa y devuelve un task_id.\",\"url\":\"https://developers.verifica.id/api-reference/vehicle/create-vehicle-query\",\"mainEntityOfPage\":{\"@id\":\"https://developers.verifica.id/api-reference/vehicle/create-vehicle-query#webpage\"},\"dateModified\":\"2026-11-06T18:56:51.017Z\",\"publisher\":{\"@id\":\"https://developers.verifica.id/#organization\"},\"isPartOf\":{\"@id\":\"https://developers.verifica.id#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Verifica API Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Verifica API Documentation","nav":{"global":{"anchors":[{"anchor":"Youtube demos","icon":"youtube","href":"https://www.youtube.com/@verificaid"},{"anchor":"Blog","icon":"newspaper","href":"https://verifica.id/blog/"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"Consulta Asertiva","pages":[{"title":"Personas","api":"POST https://api.verifica.id/v2/consulta/personas","href":"/api-reference/data-validation/validate-person"},{"title":"Empresas","api":"POST https://api.verifica.id/v2/consulta/empresas","href":"/api-reference/data-validation/validate-company"},{"title":"Extranjeros","api":"POST https://api.verifica.id/v2/consulta/extranjeros","href":"/api-reference/data-validation/validate-foreigner"}]},{"group":"Match de Datos RENIEC","pages":[{"title":"Crear match","api":"POST /api/v1/solutions/match-reniec","href":"/api-reference/match-reniec/create-match"},{"title":"Consultar match","description":"Obtén el resultado de un Match de Datos RENIEC: score general y por campo","api":"GET /api/v1/solutions/match-reniec/{id}","href":"/api-reference/match-reniec/get-match"}]},{"group":"Consulta Datos Públicos","pages":[{"title":"Crear consulta vehicular","api":"POST /api/v1/solutions/consulta/vehicular","href":"/api-reference/vehicle/create-vehicle-query"},{"title":"Obtener resultado de consulta vehicular","description":"Consulta el estado y la ficha del vehículo de una consulta por su task_id","api":"GET /api/v1/solutions/consulta/vehicular/{task_id}","href":"/api-reference/vehicle/get-vehicle-query"},{"title":"Crear consulta VIN (asíncrona)","api":"POST /api/v1/solutions/consulta/vehicular-vin","href":"/api-reference/vin/create-vin-query-async"},{"title":"Obtener resultado de consulta VIN","api":"GET /api/v1/solutions/consulta/vehicular-vin/{task_id}","href":"/api-reference/vin/get-vin-query"},{"title":"Crear consulta de Récord de Conductor MTC","api":"POST /api/v1/solutions/consulta/record-conductor","href":"/api-reference/mtc/create-driver-record-query"},{"title":"Obtener resultado de Récord de Conductor MTC","api":"GET /api/v1/solutions/consulta/record-conductor/{task_id}","href":"/api-reference/mtc/get-driver-record-query"}]},{"group":"FirmaID","pages":[{"title":"Crear y Enviar Solicitud de Firma","api":"POST /api/v1/firmaid/send-request-new-signature","href":"/api-reference/firmaid/send-signature-request"},{"title":"Mostrar Firma","api":"GET /api/v1/firmaid/signature/{signature_id}","href":"/api-reference/firmaid/show-signature"},{"title":"Webhooks de FirmaID","tag":"POST","href":"/api-reference/firmaid/webhooks"}]},{"group":"Soluciones Compliance","pages":[{"title":"Obtener Reporte AML","api":"GET /api/v1/solutions/aml-report","href":"/api-reference/compliance/aml-report"},{"title":"Crear Sesión KYC Bravo","api":"POST /api/v1/solutions/kyc-bravo/session","href":"/api-reference/compliance/kyc-bravo-session"},{"title":"Consultar Último Proceso KYC","api":"POST /api/v1/solutions/kyc-bravo/sessions/last","href":"/api-reference/compliance/kyc-bravo-last-session"}]}]}]},"basePath":"","title":"Crear consulta vehicular - Verifica API Documentation","buildId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","deploymentId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-CBsVopKK.js","utils-DZAk68jJ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D32AYZrP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D_A5_cny.js","snippetPresets-xNRfS9th.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BIB25-tq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CydJ4w4j.js","shallow-CYPBeQSG.js","getApiPlaygroundDisplay-A5xJVBOu.js","CodeSnippet-BVRTgi3m.js","CodeSnippets-DjD6BSlt.js","Page-Dr40SSJq.js","getPastedJson-D4V4JyrR.js","icon-uhcnG22T.js","MethodPill-CM-ZQdGH.js","DuplicateIcon-B_WnOiNf.js","createIcon-CJsb8utt.js","DynamicMarkdown-D-2HDKEp.js","SectionHeading-KP5xmMgQ.js","axios-vUo_bRtp.js"]}