https://docs.verifik.co/assets/js/31df0ccb.fde65072.js

1"use strict";(self.webpackChunkverifik_documentation=self.webpackChunkverifik_documentation||[]).push([["12398"],{27596(e,n,r){r.r(n),r.d(n,{metadata:()=>i,default:()=>p,frontMatter:()=>o,contentTitle:()=>c,toc:()=>u,assets:()=>d});var i=JSON.parse('{"id":"vehicle-validation/colombia/vehicle-validation-colombia-runt-vehicle-owners","title":"RUNT - Vehicle owners by plate","description":"Retrieve a Colombian vehicle and its ownership records using only the license plate.","source":"@site/docs/vehicle-validation/colombia/runt-vehicle-owners.mdx","sourceDirName":"vehicle-validation/colombia","slug":"/vehicle-validation/colombia/runt-vehicle-owners","permalink":"/vehicle-validation/colombia/runt-vehicle-owners","draft":false,"unlisted":false,"editUrl":"https://github.com/Open-Verifik/verifik-documentation/tree/main/docs/vehicle-validation/colombia/runt-vehicle-owners.mdx","tags":[],"version":"current","frontMatter":{"id":"vehicle-validation-colombia-runt-vehicle-owners","title":"RUNT - Vehicle owners by plate","description":"Retrieve a Colombian vehicle and its ownership records using only the license plate.","sidebar_label":"RUNT - Vehicle owners","slug":"/vehicle-validation/colombia/runt-vehicle-owners","keywords":["colombia_api_runt_owners","GET /v2/co/runt/propietarios","Colombia vehicle owners API"]},"sidebar":"tutorialSidebar","previous":{"title":"RUNT - Vehicle by plate (basic)","permalink":"/vehicle-validation/colombia/runt-vehiculo"},"next":{"title":"RUNT - Vehicle records by VIN","permalink":"/vehicle-validation/colombia/runt-vehicle-by-vin"}}'),t=r(74848),a=r(28453),l=r(50773),s=r(57250);let o={id:"vehicle-validation-colombia-runt-vehicle-owners",title:"RUNT - Vehicle owners by plate",description:"Retrieve a Colombian vehicle and its ownership records using only the license plate.",sidebar_label:"RUNT - Vehicle owners",slug:"/vehicle-validation/colombia/runt-vehicle-owners",keywords:["colombia_api_runt_owners","GET /v2/co/runt/propietarios","Colombia vehicle owners API"]},c,d={},u=[{value:"Endpoint",id:"endpoint",level:3},{value:"Headers",id:"headers",level:3},{value:"Parameters",id:"parameters",level:3},{value:"Request",id:"request",level:3},{value:"Response",id:"response",level:3},{value:"Notes",id:"notes",level:3}];function h(e){let n={code:"code",h3:"h3",li:"li",p:"p",pre:"pre",strong:"strong",table:"table",tbody:"tbody",td:"td",th:"th",thead:"thead",tr:"tr",ul:"ul",...(0,a.R)(),...e.components};return(0,t.jsxs)(t.Fragment,{children:[(0,t.jsx)(n.p,{children:"Retrieve a Colombian vehicle's basic details and ownership records using only its license plate. This service is useful for ownership verification, onboarding, and vehicle due diligence."}),"\n",(0,t.jsx)(n.h3,{id:"endpoint",children:"Endpoint"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{children:"GET https://api.verifik.co/v2/co/runt/propietarios\n"})}),"\n",(0,t.jsxs)(n.p,{children:["The response includes ",(0,t.jsx)(n.code,{children:"plate"}),", ",(0,t.jsx)(n.code,{children:"brand"}),", ",(0,t.jsx)(n.code,{children:"line"}),", ",(0,t.jsx)(n.code,{children:"model"}),", and an ",(0,t.jsx)(n.code,{children:"owners"})," array with owner identity, ownership period, financing, pledge, and registry details when available. ",(0,t.jsx)(n.code,{children:"GET /v2/co/runt/vehiculo/owners"})," is a legacy alias of the same handler; new integrations should use ",(0,t.jsx)(n.code,{children:"propietarios"}),"."]}),"\n",(0,t.jsx)(n.h3,{id:"headers",children:"Headers"}),"\n",(0,t.jsxs)(n.table,{children:[(0,t.jsx)(n.thead,{children:(0,t.jsxs)(n.tr,{children:[(0,t.jsx)(n.th,{children:"Name"}),(0,t.jsx)(n.th,{children:"Value"})]})}),(0,t.jsxs)(n.tbody,{children:[(0,t.jsxs)(n.tr,{children:[(0,t.jsx)(n.td,{children:"Accept"}),(0,t.jsx)(n.td,{children:(0,t.jsx)(n.code,{children:"application/json"})})]}),(0,t.jsxs)(n.tr,{children:[(0,t.jsx)(n.td,{children:"Authorization"}),(0,t.jsx)(n.td,{children:(0,t.jsx)(n.code,{children:"Bearer <token>"})})]})]})]}),"\n",(0,t.jsx)(n.h3,{id:"parameters",children:"Parameters"}),"\n",(0,t.jsxs)(n.table,{children:[(0,t.jsx)(n.thead,{children:(0,t.jsxs)(n.tr,{children:[(0,t.jsx)(n.th,{children:"Name"}),(0,t.jsx)(n.th,{children:"Type"}),(0,t.jsx)(n.th,{children:"Required"}),(0,t.jsx)(n.th,{children:"Description"}),(0,t.jsx)(n.th,{children:"Example"})]})}),(0,t.jsx)(n.tbody,{children:(0,t.jsxs)(n.tr,{children:[(0,t.jsx)(n.td,{children:(0,t.jsx)(n.code,{children:"plate"})}),(0,t.jsx)(n.td,{children:"string"}),(0,t.jsx)(n.td,{children:"Yes"}),(0,t.jsx)(n.td,{children:"Colombian license plate containing 5\u20139 alph

1anumeric characters."}),(0,t.jsx)(n.td,{children:(0,t.jsx)(n.code,{children:"CRL299"})})]})})]}),"\n",(0,t.jsx)(n.h3,{id:"request",children:"Request"}),"\n",(0,t.jsxs)(l.A,{children:[(0,t.jsx)(s.A,{value:"node",label:"Node.js",children:(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-javascript",children:'import axios from "axios";\n\nconst { data } = await axios.get("https://api.verifik.co/v2/co/runt/propietarios", {\n	params: { plate: "CRL299" },\n	headers: {\n		Accept: "application/json",\n		Authorization: `Bearer ${process.env.VERIFIK_TOKEN}`,\n	},\n});\nconsole.log(data);\n'})})}),(0,t.jsx)(s.A,{value:"python",label:"Python",children:(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-python",children:'import os, requests\n\nurl = "https://api.verifik.co/v2/co/runt/propietarios"\nheaders = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv(\'VERIFIK_TOKEN\')}"}\nresponse = requests.get(url, headers=headers, params={"plate": "CRL299"})\nprint(response.json())\n'})})})]}),"\n",(0,t.jsx)(n.h3,{id:"response",children:"Response"}),"\n",(0,t.jsxs)(l.A,{children:[(0,t.jsx)(s.A,{value:"200",label:"200",children:(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-json",children:'{\n	"data": {\n		"plate": "CRL299",\n		"brand": "CHEVROLET",\n		"line": "CRUZE",\n		"model": "2012",\n		"owners": [\n			{\n				"documentIssueDate": null,\n				"documentNumber": "********",\n				"documentType": "CC",\n				"entity": "ENTIDAD FINANCIERA",\n				"financingTime": 42.03,\n				"financingType": "Prenda",\n				"firstName": "OWNER",\n				"fullName": "OWNER EXAMPLE",\n				"lastName": "EXAMPLE",\n				"ownerId": 10000001,\n				"ownershipDuration": {\n					"days": 23,\n					"months": 6,\n					"years": 8\n				},\n				"ownershipEndDate": "2020-02-13T05:00:00.000+0000",\n				"ownershipStartDate": "2011-07-21T05:00:00.000+0000",\n				"pledge": "Prenda levantada",\n				"registraduriaStatus": null,\n				"vehicleRegistryNumber": "15514772"\n			}\n		]\n	},\n	"signature": {\n		"dateTime": "September 8, 2026 11:00 PM",\n		"message": "Certified by Verifik.co"\n	},\n	"id": "ABCDE"\n}\n'})})}),(0,t.jsx)(s.A,{value:"404",label:"404",children:(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-json",children:'{\n	"code": "NotFound",\n	"message": "Record not found."\n}\n'})})}),(0,t.jsx)(s.A,{value:"409",label:"409",children:(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-json",children:'{\n	"code": "MissingParameter",\n	"message": "missing plate"\n}\n'})})})]}),"\n",(0,t.jsx)(n.h3,{id:"notes",children:"Notes"}),"\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsxs)(n.li,{children:["The AppFeature code is ",(0,t.jsx)(n.strong,{children:(0,t.jsx)(n.code,{children:"colombia_api_runt_owners"})}),"."]}),"\n",(0,t.jsxs)(n.li,{children:["Use ",(0,t.jsx)(n.strong,{children:(0,t.jsx)(n.code,{children:"CRL299"})})," in the sandbox."]}),"\n",(0,t.jsxs)(n.li,{children:["Owner properties may be ",(0,t.jsx)(n.code,{children:"null"})," when a value is unavailable; ",(0,t.jsx)(n.code,{children:"owners"})," may contain multiple historical records."]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.strong,{children:(0,t.jsx)(n.code,{children:"GET /v2/co/runt/vehiculo/owners"})})," is a legacy alias of the same endpoint; it does not change the result or the charge."]}),"\n"]})]})}function p(e={}){let{wrapper:n}={...(0,a.R)(),...e.components};return n?(0,t.jsx)(n,{...e,children:(0,t.jsx)(h,{...e})}):h(e)}},57250(e,n,r){r.d(n,{A:()=>s});var i=r(74848);r(96540);var t=r(34164),a=r(57663);function l({children:e,className:n,hidden:r}){return(0,i.jsx)("div",{role:"tabpanel",className:(0,t.A)("tabItem_Ymn6",n),hidden:r,children:e})}function s({children:e,className:n,value:r}){let{selectedValue:t,lazy:o}=(0,a.uc)(),c=r===t;return!c&&o?null:(0,i.jsx)(l,{className:n,hidden:!c,children:e})}},50773(e,n,r){r.d(n,{A:()=>h});var i=r(74848);r(96540);var t=r(34164),a=r(88287),l=r(57663),s=r(28584),o=r(19863);function c({className:e}){let{selectedValue:n,selectValue:r,tabValues:a,block:o}=(0,l.uc)(),d=[],{blockElementScrollPositionUntilNextRender:u}

1=(0,s.a_)(),h=e=>{let i=e.currentTarget,t=a[d.indexOf(i)].value;t!==n&&(u(i),r(t))},p=e=>{let n=null;switch(e.key){case"Enter":h(e);break;case"ArrowRight":{let r=d.indexOf(e.currentTarget)+1;n=d[r]??d[0];break}case"ArrowLeft":{let r=d.indexOf(e.currentTarget)-1;n=d[r]??d[d.length-1]}}n?.focus()};return(0,i.jsx)("ul",{role:"tablist","aria-orientation":"horizontal",className:(0,t.A)("tabs",{"tabs--block":o},e),children:a.map(({value:e,label:r,attributes:a})=>(0,i.jsx)("li",{role:"tab",tabIndex:n===e?0:-1,"aria-selected":n===e,ref:e=>{d.push(e)},onKeyDown:p,onClick:h,...a,className:(0,t.A)("tabs__item","tabItem_LNqP",a?.className,{"tabs__item--active":n===e}),children:r??e},e))})}function d({children:e}){return(0,i.jsx)("div",{className:"margin-top--md",children:e})}function u({className:e,children:n}){return(0,i.jsxs)("div",{className:(0,t.A)(a.G.tabs.container,"tabs-container","tabList__CuJ"),children:[(0,i.jsx)(c,{className:e}),(0,i.jsx)(d,{children:n})]})}function h(e){let n=(0,o.A)(),r=(0,l.OC)(e);return(0,i.jsx)(l.O_,{value:r,children:(0,i.jsx)(u,{className:e.className,children:(0,l.vT)(e.children)})},String(n))}},57663(e,n,r){r.d(n,{OC:()=>h,O_:()=>m,uc:()=>v,vT:()=>d});var i=r(74848),t=r(96540),a=r(56347),l=r(99989),s=r(96629),o=r(80618),c=r(41367);function d(e){return t.Children.toArray(e).filter(e=>"\n"!==e)}function u({value:e,tabValues:n}){return n.some(n=>n.value===e)}function h(e){let n,{defaultValue:r,queryString:i=!1,groupId:d}=e,h=function(e){let{values:n,children:r}=e;return(0,t.useMemo)(()=>{let e=n??t.Children.toArray(r).flatMap(e=>{if(!e)return[];if((0,t.isValidElement)(e)&&function(e){let{props:n}=e;return!!n&&"object"==typeof n&&"value"in n}(e))return[e];let n="string"==typeof e.type?e.type:e.type.name;throw Error(`Docusaurus error: Bad <Tabs> child <${n}>: all children of the <Tabs> component should be <TabItem>, and every <TabItem> should have a unique "value" prop.
2If you do not want to pass on a "value" prop to the direct children of <Tabs>, you can also pass an explicit <Tabs values={...}> prop.`)}).map(({props:{value:e,label:n,attributes:r,default:i}})=>({value:e,label:n,attributes:r,default:i})),i=(0,o.XI)(e,(e,n)=>e.value===n.value);if(i.length>0)throw Error(`Docusaurus error: Duplicate values "${i.map(e=>`'${e.value}'`).join(", ")}" found in <Tabs>. Every value needs to be unique.`);return e},[n,r])}(e),[p,v]=(0,t.useState)(()=>(function({defaultValue:e,tabValues:n}){if(0===n.length)throw Error("Docusaurus error: the <Tabs> component requires at least one <TabItem> children component");if(e){if(!u({value:e,tabValues:n}))throw Error(`Docusaurus error: The <Tabs> has a defaultValue "${e}" but none of its children has the corresponding value. Available values are: ${n.map(e=>e.value).join(", ")}. If you intend to show no default tab, use defaultValue={null} instead.`);return e}let r=n.find(e=>e.default)??n[0];if(!r)throw Error("Unexpected error: 0 tabValues");return r.value})({defaultValue:r,tabValues:h})),[m,x]=function({queryString:e=!1,groupId:n}){let r=(0,a.W6)(),i=function({queryString:e=!1,groupId:n}){if("string"==typeof e)return e;if(!1===e)return null;if(!0===e&&!n)throw Error('Docusaurus error: The <Tabs> component groupId prop is required if queryString=true, because this value is used as the search param name. You can also provide an explicit value such as queryString="my-search-param".');return n??null}({queryString:e,groupId:n});return[(0,s.aZ)(i),(0,t.useCallback)(e=>{if(!i)return;let n=new URLSearchParams(r.location.search);n.set(i,e),r.replace({...r.location,search:n.toString()})},[i,r])]}({queryString:i,groupId:d}),[b,j]=function({groupId:e}){let n=e?`docusaurus.tab.${e}`:null,[r,i]=(0,c.Dv)(n);return[r,(0,t.useCallback)(e=>{n&&i.set(e)},[n,i])]}({groupId:d}),f=u({value:n=m??b,tabValues:h})?n:null;return(0,l.A)(()=>{f&&v(f)},[f]),{selectedValue:p,selectValue:(0,t.useCallback)(e=>{if(!u({value:e,tabValues:h}))throw Error(`Can't select invalid tab value=${e}`);v(e),x(e),j(e)},[x,j,h]),tabValues:h,lazy:e.lazy??!1,block:e.block??!1}}let p=(0,t.createContext)(null);function v(){let e=t.useContext(p);if(!e)throw Error("useTabsContext() must be used within a Tabs component");return e}function m(e){return(0,i.jsx)(p.Provider,{value:e.value,children:e.children})}},28453(e,n,r){r.d(n,{R:()=>l,x:()=>s});var i=r(96540);let t={},a=i.createContext(t);function l(e){let n=i.useContext(a);return i.useMemo(function(){return"function"==typeof e?e(n):{...n,...e}},[n,e])}function s(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(t):e.components||t:l(e.components),i.createElement(a.Provider,{value:n},e.children)}}}]);