https://docs.verifik.co/assets/js/f09f2465.64c2a25c.js

1"use strict";(self.webpackChunkverifik_documentation=self.webpackChunkverifik_documentation||[]).push([["13694"],{48181(e,n,t){t.r(n),t.d(n,{metadata:()=>i,default:()=>m,frontMatter:()=>c,contentTitle:()=>d,toc:()=>h,assets:()=>o,structuredData:()=>u});var i=JSON.parse('{"id":"identity-validation/identity-validation-guatemala","title":"Guatemalan Citizen","description":"Validate the identity of individuals in Guatemala with Verifik\'s KYC API. Connect with official sources and verify personal data in seconds.","source":"@site/docs/identity-validation/guatemala.mdx","sourceDirName":"identity-validation","slug":"/identity-validation/guatemala","permalink":"/identity-validation/guatemala","draft":false,"unlisted":false,"editUrl":"https://github.com/Open-Verifik/verifik-documentation/tree/main/docs/identity-validation/guatemala.mdx","tags":[],"version":"current","frontMatter":{"id":"identity-validation-guatemala","title":"Guatemalan Citizen","description":"Validate the identity of individuals in Guatemala with Verifik\'s KYC API. Connect with official sources and verify personal data in seconds.","slug":"/identity-validation/guatemala","keywords":["v2/gt/cedula","/v2/gt/cedula","v2 gt cedula","api/gt/cedula","/api/gt/cedula","api gt cedula","api.verifik.co/v2/gt/cedula","https://api.verifik.co/v2/gt/cedula","GET v2/gt/cedula","GET /v2/gt/cedula","gt/cedula","/gt/cedula"]}}'),r=t(74848),a=t(28453),s=t(50773),l=t(57250);let c={id:"identity-validation-guatemala",title:"Guatemalan Citizen",description:"Validate the identity of individuals in Guatemala with Verifik's KYC API. Connect with official sources and verify personal data in seconds.",slug:"/identity-validation/guatemala",keywords:["v2/gt/cedula","/v2/gt/cedula","v2 gt cedula","api/gt/cedula","/api/gt/cedula","api gt cedula","api.verifik.co/v2/gt/cedula","https://api.verifik.co/v2/gt/cedula","GET v2/gt/cedula","GET /v2/gt/cedula","gt/cedula","/gt/cedula"]},d="Identity Verification in Guatemala",o={},u={"@context":"https://schema.org","@type":"TechArticle",headline:"Identity Verification in Guatemala | Verifik KYC API",description:"Validate the identity of individuals in Guatemala with Verifik's KYC API. Connect with official sources and verify personal data in seconds.",articleSection:"API Documentation",keywords:"identity verification, KYC API, Guatemala CUI validation, official data source, fraud prevention",about:{"@type":"Thing",name:"Identity Verification API"}},h=[{value:"What does this API validate?",id:"what-does-this-api-validate",level:2},{value:"API Reference",id:"api-reference",level:2},{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},{value:"Common Use Cases",id:"common-use-cases",level:2},{value:"Official Sources &amp; Reliability",id:"official-sources--reliability",level:2},{value:"Key Benefits",id:"key-benefits",level:2},{value:"Compliance &amp; Security",id:"compliance--security",level:2},{value:"About Verifik",id:"about-verifik",level:2}];function p(e){let n={code:"code",em:"em",h1:"h1",h2:"h2",h3:"h3",header:"header",hr:"hr",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,r.jsxs)(r.Fragment,{children:[(0,r.jsx)("script",{type:"application/ld+json",dangerouslySetInnerHTML:{__html:JSON.stringify(u)}}),"\n","\n",(0,r.jsx)(n.header,{children:(0,r.jsx)(n.h1,{id:"identity-verification-in-guatemala",children:"Identity Verification in Guatemala"})}),"\n",(0,r.jsx)(n.p,{children:"Verifik's Identity Verification API helps you authenticate Guatemalan citizens using official government data. It's designed to streamline your KYC (Know Your Customer) processes, prevent fraud, and ensure you meet all regulatory requirements effortlessly."}),"\n",(0,r.jsx)(n.p,{children:"We built this integration for businesses that need a fast, secure, and automated way to confirm the true identity of users, employees, or customers."}),"\n",(0,r.jsx)(n.h2,{id:"what-does-this-api-validate",children:"What does this API validate?"}),"\n",(0,r.jsx)(n.p,{children:"Our API connects directly with official records to validate:"}),"\n",(0,r.jsxs)(n.ul,{children:["\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.strong,{children:"Full Name & CUI Number"}),": Supports ",(0,r.jsx)(n.em,{children:"C\xe9dula de Vecindad"})," or ",(0,r.jsx)(n.em,{children:"Documento Personal de Identificaci\xf3n"})," (CUI)."]}),"\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.strong,{children:"Identity Match"}),": Confirms that the name provided matches the CUI number."]}),"\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.strong,{children:"Date of Birth Verification"}),": Validates that the date of birth matches official SAT records."]}),"\n"]}),"\n",(0,r.jsx)(n.p,{children:"By verifying these details, you can be confident that the person you're dealing with is real and holds a valid document, significantly lowering the risk of impersonation and fraud."}),"\n",(0,r.jsxs)(n.p,{children:["Verify a Guatemalan citizen using ",(0,r.jsx)(n.strong,{children:(0,r.jsx)(n.code,{children:"documentType"})})," ",(0,r.jsx)(n.code,{children:"CUI"}),", ",(0,r.jsx)(n.strong,{children:(0,r.jsx)(n.code,{children:"documentNumber"})}),", and ",(0,r.jsx)(n.strong,{children:(0,r.jsx)(n.code,{children:"dateOfBirth"})})," (",(0,r.jsx)(n.code,{children:"DD/MM/YYYY"}),"). Returns identity fields to support ",(0,r.jsx)(n.strong,{children:"KYC"})," and ",(0,r.jsx)(n.strong,{children:"compliance"}),"."]}),"\n",(0,r.jsx)(n.h2,{id:"api-reference",children:"API Reference"}),"\n",(0,r.jsx)(n.h3,{id:"endpoint",children:"Endpoint"}),"\n",(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{children:"https://api.verifik.co/v2/gt/cedula\n"})}),"\n",(0,r.jsx)(n.h3,{id:"headers",children:"Headers"}),"\n",(0,r.jsxs)(n.table,{children:[(0,r.jsx)(n.thead,{children:(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.th,{children:"Name"}),(0,r.jsx)(n.th,{children:"Value"})]})}),(0,r.jsxs)(n.tbody,{children:[(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:"Content-Type"}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"application/json"})})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:"Authorization"}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"Bearer <token>"})})]})]})]}),"\n",(0,r.jsx)(n.h3,{id:"parameters",children:"Parameters"}),"\n",(0,r.jsxs)(n.table,{children:[(0,r.jsx)(n.thead,{children:(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.th,{children:"Name"}),(0,r.jsx)(n.th,{children:"Type"}),(0,r.jsx)(n.th,{children:"Required"}),(0,r.jsx)(n.th,{children:"Description"})]})}),(0,r.jsxs)(n.tbody,{children:[(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"documentType"})}),(0,r.jsx)(n.td,{children:"string"}),(0,r.jsx)(n.td,{children:"Yes"}),(0,r.jsxs)(n.td,{children:["Document type. Allowed value: ",(0,r.jsx)(n.code,{children:"CUI"}),"."]})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"documentNumber"})}),(0,r.jsx)(n.td,{children:"string"}),(0,r.jsx)(n.td,{children:"Yes"}),(0,r.jsx)(n.td,{children:"Document number."})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"dateOfBirth"})}),(0,r.jsx)(n.td,{children:"string"}),(0,r.jsx)(n.td,{children:"Yes"}),(0,r.jsxs)(n.td,{children:["Date of birth (",(0,r.jsx)(n.code,{children:"DD/MM/YYYY"}),")."]})]})]})]}),"\n",(0,r.jsx)(n.h3,{id:"request",children:"Request"}),"\n",(0,r.jsxs)(s.A,{children:[(0,r.jsx)(l.A,{value:"node",label:"Node.js",children:(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-javascript",children:'import axios from "axios";\n\nconst { data } = await axios.get("https://api.verifik.co/v2/gt/cedula", {\n  params: { documentType: "CUI", documentNumber: "2222624190903", dateOfBirth: "12/03/1984" },\n  headers: { Accept: "application/json", Authorization: `Bearer ${process.env.VERIFIK_TOKEN}` },\n});\nconsole.log(data);\n'})})}),(0,r.jsx)(l.A,{value:"php",label:"PHP",children:(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-php",children:'<?php\n$ch = curl_init("https://api.verifik.co/v2/gt/cedula");

1\ncurl_setopt($ch, CURLOPT_HTTPHEADER, [\n    "Accept: application/json",\n    "Authorization: Bearer " . getenv("VERIFIK_TOKEN")\n]);\n$query = http_build_query([\n    "documentType" => "CUI",\n    "documentNumber" => "2222624190903",\n    "dateOfBirth" => "12/03/1984"\n]);\ncurl_setopt($ch, CURLOPT_URL, "https://api.verifik.co/v2/gt/cedula?".$query);\ncurl_setopt($ch, CURLOPT_RETURNTRANSFER, true);\n$response = curl_exec($ch);\ncurl_close($ch);\necho $response;\n'})})}),(0,r.jsx)(l.A,{value:"python",label:"Python",children:(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-python",children:'import os, requests\n\nurl = "https://api.verifik.co/v2/gt/cedula"\nheaders = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv(\'VERIFIK_TOKEN\')}"}\nparams = {"documentType": "CUI", "documentNumber": "2222624190903", "dateOfBirth": "12/03/1984"}\nr = requests.get(url, headers=headers, params=params)\nprint(r.json())\n'})})}),(0,r.jsx)(l.A,{value:"go",label:"Go",children:(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-go",children:'package main\n\nimport (\n    "fmt"\n    "net/http"\n)\n\nfunc main() {\n    url := "https://api.verifik.co/v2/gt/cedula?documentType=CUI&documentNumber=2222624190903&dateOfBirth=12/03/1984"\n    req, _ := http.NewRequest("GET", url, nil)\n    req.Header.Set("Accept", "application/json")\n    req.Header.Set("Authorization", "Bearer "+getenv("VERIFIK_TOKEN"))\n    resp, _ := http.DefaultClient.Do(req)\n    defer resp.Body.Close()\n    fmt.Println(resp.Status)\n}\n'})})})]}),"\n",(0,r.jsx)(n.h3,{id:"response",children:"Response"}),"\n",(0,r.jsxs)(s.A,{children:[(0,r.jsx)(l.A,{value:"200",label:"200",children:(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-json",children:'{\n  "data": {\n    "arrayName": [\n      "ERICK",\n      "ROBERTO",\n      "RAMIREZ",\n      "MORALES"\n    ],\n    "documentNumber": "2222624190903",\n    "documentType": "CUI",\n    "firstName": "ERICK ROBERTO",\n    "fullName": "ERICK ROBERTO RAMIREZ MORALES",\n    "lastName": "RAMIREZ MORALES"\n  },\n  "signature": {\n    "dateTime": "January 16, 2024 3:44 PM",\n    "message": "Certified by Verifik.co"\n  },\n  "id": "GT001"\n}\n'})})}),(0,r.jsx)(l.A,{value:"409",label:"409",children:(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-json",children:'{\n  "code": "MissingParameter",\n  "message": "missing documentType\\n. missing documentNumber\\n. missing dateOfBirth\\n"\n}\n'})})}),(0,r.jsx)(l.A,{value:"401",label:"401",children:(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-json",children:'{\n  "message": "Authentication required",\n  "code": "UNAUTHORIZED"\n}\n'})})}),(0,r.jsx)(l.A,{value:"500",label:"500",children:(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-json",children:'{\n    "code": "InternalServerError",\n    "message": "Server error."\n}\n'})})})]}),"\n",(0,r.jsx)(n.h3,{id:"notes",children:"Notes"}),"\n",(0,r.jsxs)(n.ul,{children:["\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.code,{children:"documentType"})," must be ",(0,r.jsx)(n.code,{children:"CUI"}),"."]}),"\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.code,{children:"dateOfBirth"})," is required and must use ",(0,r.jsx)(n.strong,{children:(0,r.jsx)(n.code,{children:"DD/MM/YYYY"})})," format (for example, ",(0,r.jsx)(n.code,{children:"12/03/1984"}),")."]}),"\n"]}),"\n",(0,r.jsx)(n.hr,{}),"\n",(0,r.jsx)(n.h2,{id:"common-use-cases",children:"Common Use Cases"}),"\n",(0,r.jsxs)(n.ul,{children:["\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.strong,{children:"Fintech & Banking"}),": Verify identities instantly during account opening or loan applications."]}),"\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.strong,{children:"E-commerce & Delivery"}),": Authenticate users and couriers before they become active on your platform."]}),"\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.strong,{children:"HR & Recruitment"}),": Validate candidate documents as part of your hiring workflow."]}),"\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.strong,{children:"Insurance & Healthcare"}),": Confirm identities before issuing policies or providing medical benefits."]}),"\n"]}),"\n",(0,r.jsx)(n.h2,{id:"official-sources--reliability",children:"Official Sources & Reliability"}),"\n",(0,r.jsx)(n.p,{children:"We connect directly with official Guatemalan government sources to ensure you receive verified, up-to-the-minute information.\nEvery query is handled with strict adherence to security and regulatory standards."}),"\n",(0,r.jsx)(n.h2,{id:"key-benefits",children:"Key Benefits"}),"\n",(0,r.jsxs)(n.ul,{children:["\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.strong,{children:"Automated Compliance"}),": Streamline your KYC checks to prevent fraud without adding friction for your users."]}),"\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.strong,{children:"Instant Results"}),": Process verifications in seconds, perfect for real-time digital onboarding."]}),"\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.strong,{children:"Trusted Data"}),": Rely on data sourced directly from official records."]}),"\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.strong,{children:"Easy Integration"}),": Connect easily via our REST API or use our compatible SDKs."]}),"\n"]}),"\n",(0,r.jsx)(n.h2,{id:"compliance--security",children:"Compliance & Security"}),"\n",(0,r.jsx)(n.p,{children:"We prioritize the safety of your data. Verifik uses advanced encryption (HTTPS/TLS 1.3) and strict privacy management standards to ensure confidentiality.\nOur service is monitored 24/7 for availability and offers role-based access controls to keep your team's access secure."}),"\n",(0,r.jsx)(n.h2,{id:"about-verifik",children:"About Verifik"}),"\n",(0,r.jsx)(n.p,{children:"Verifik is a leading platform for identity verification, compliance, and fraud prevention across Latin America.\nOur APIs automate KYC, KYB, AML, and biometric validation processes, connecting businesses with official data sources in Colombia, Mexico, Peru, Chile, Uruguay, Argentina, Brazil, Guatemala, and beyond."})]})}function m(e={}){let{wrapper:n}={...(0,a.R)(),...e.components};return n?(0,r.jsx)(n,{...e,children:(0,r.jsx)(p,{...e})}):p(e)}},57250(e,n,t){t.d(n,{A:()=>l});var i=t(74848);t(96540);var r=t(34164),a=t(57663);function s({children:e,className:n,hidden:t}){return(0,i.jsx)("div",{role:"tabpanel",className:(0,r.A)("tabItem_Ymn6",n),hidden:t,children:e})}function l({children:e,className:n,value:t}){let{selectedValue:r,lazy:c}=(0,a.uc)(),d=t===r;return!d&&c?null:(0,i.jsx)(s,{className:n,hidden:!d,children:e})}},50773(e,n,t){t.d(n,{A:()=>h});var i=t(74848);t(96540);var r=t(34164),a=t(88287),s=t(57663),l=t(28584),c=t(19863);function d({className:e}){let{selectedValue:n,selectValue:t,tabValues:a,block:c}=(0,s.uc)(),o=[],{blockElementScrollPositionUntilNextRender:u}

1=(0,l.a_)(),h=e=>{let i=e.currentTarget,r=a[o.indexOf(i)].value;r!==n&&(u(i),t(r))},p=e=>{let n=null;switch(e.key){case"Enter":h(e);break;case"ArrowRight":{let t=o.indexOf(e.currentTarget)+1;n=o[t]??o[0];break}case"ArrowLeft":{let t=o.indexOf(e.currentTarget)-1;n=o[t]??o[o.length-1]}}n?.focus()};return(0,i.jsx)("ul",{role:"tablist","aria-orientation":"horizontal",className:(0,r.A)("tabs",{"tabs--block":c},e),children:a.map(({value:e,label:t,attributes:a})=>(0,i.jsx)("li",{role:"tab",tabIndex:n===e?0:-1,"aria-selected":n===e,ref:e=>{o.push(e)},onKeyDown:p,onClick:h,...a,className:(0,r.A)("tabs__item","tabItem_LNqP",a?.className,{"tabs__item--active":n===e}),children:t??e},e))})}function o({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,r.A)(a.G.tabs.container,"tabs-container","tabList__CuJ"),children:[(0,i.jsx)(d,{className:e}),(0,i.jsx)(o,{children:n})]})}function h(e){let n=(0,c.A)(),t=(0,s.OC)(e);return(0,i.jsx)(s.O_,{value:t,children:(0,i.jsx)(u,{className:e.className,children:(0,s.vT)(e.children)})},String(n))}},57663(e,n,t){t.d(n,{OC:()=>h,O_:()=>f,uc:()=>m,vT:()=>o});var i=t(74848),r=t(96540),a=t(56347),s=t(99989),l=t(96629),c=t(80618),d=t(41367);function o(e){return r.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:t,queryString:i=!1,groupId:o}=e,h=function(e){let{values:n,children:t}=e;return(0,r.useMemo)(()=>{let e=n??r.Children.toArray(t).flatMap(e=>{if(!e)return[];if((0,r.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:t,default:i}})=>({value:e,label:n,attributes:t,default:i})),i=(0,c.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,t])}(e),[p,m]=(0,r.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 t=n.find(e=>e.default)??n[0];if(!t)throw Error("Unexpected error: 0 tabValues");return t.value})({defaultValue:t,tabValues:h})),[f,x]=function({queryString:e=!1,groupId:n}){let t=(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,l.aZ)(i),(0,r.useCallback)(e=>{if(!i)return;let n=new URLSearchParams(t.location.search);n.set(i,e),t.replace({...t.location,search:n.toString()})},[i,t])]}({queryString:i,groupId:o}),[v,j]=function({groupId:e}){let n=e?`docusaurus.tab.${e}`:null,[t,i]=(0,d.Dv)(n);return[t,(0,r.useCallback)(e=>{n&&i.set(e)},[n,i])]}({groupId:o}),g=u({value:n=f??v,tabValues:h})?n:null;return(0,s.A)(()=>{g&&m(g)},[g]),{selectedValue:p,selectValue:(0,r.useCallback)(e=>{if(!u({value:e,tabValues:h}))throw Error(`Can't select invalid tab value=${e}`);m(e),x(e),j(e)},[x,j,h]),tabValues:h,lazy:e.lazy??!1,block:e.block??!1}}let p=(0,r.createContext)(null);function m(){let e=r.useContext(p);if(!e)throw Error("useTabsContext() must be used within a Tabs component");return e}function f(e){return(0,i.jsx)(p.Provider,{value:e.value,children:e.children})}},28453(e,n,t){t.d(n,{R:()=>s,x:()=>l});var i=t(96540);let r={},a=i.createContext(r);function s(e){let n=i.useContext(a);return i.useMemo(function(){return"function"==typeof e?e(n):{...n,...e}},[n,e])}function l(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(r):e.components||r:s(e.components),i.createElement(a.Provider,{value:n},e.children)}}}]);