Cria uma verificação e emite a entrada da jornada. É a única chamada que o seu servidor faz para
começar uma verificação.A chamada resolve a conta e a integração pela chave, fixa a versão publicada do fluxo naquele
instante e devolve a entrada da jornada. É por isso que ela nasce no seu backend: a chave de API
nunca chega ao browser nem ao app.
application/json. Qualquer outro valor responde 415.
string
Propaga tracing distribuído. Opcional.
Corpo
string
required
A versão do contrato. Hoje, "1.0".
object
required
O documento que identifica o titular.
Show campos
string
required
Hoje só "cpf".
string
required
Normalizado e validado no servidor. Nunca volta na resposta nem no bootstrap do widget.
string
O fluxo que a verificação vai usar. Copie o id em Solução KYC → Fluxos, no menu da linha do
fluxo, em Copiar ID do fluxo.Ausente, a chamada usa o fluxo padrão da integração. Se a integração não tiver fluxo padrão
definido, a resposta é 404 E_NOT_FOUND — o mesmo código de um fluxo que não existe. Veja
quando o 404 é de fluxo.
string
A sua chave para essa verificação, número do pedido, id do cadastro. Até 120 caracteres, único
por conta.É o que volta no webhook de desfecho. Sem ele, você precisa guardar o public_id da plataforma
para saber de quem é o evento.
Resposta
string
A versão do contrato.
object
Show campos
string
O identificador da verificação, e o mesmo valor que abre a jornada: é ele que vai no
fragmento da entry.url. Guarde-o no seu banco para ligar o webhook ao seu pedido, e trate-o
como segredo de curta duração até o expires_at.
Quando a jornada deixa de poder ser aberta. ISO 8601 em UTC.
object
Como o titular entra na jornada. União discriminada por kind. Quem decide é a origem resolvida
pela sua chave: origem de domínio web, ou integração sem origem, devolve "web"; origem de
bundle de app devolve "native".As SDKs de Android e iOS consomem o embed URL de entry.url.
Show campos
string
"web" ou "native".
string
Só em kind: "web". A URL da jornada, com o public_id da verificação no fragmento. Gere o
QR code a partir dela se quiser entrega por celular.
string
Só em kind: "native". É o mesmo verification.public_id, sem a URL em volta.
A entry.url carrega a credencial da jornada. Trate-a como segredo de curta duração: ela sai do
seu backend para o titular daquela verificação e para mais ninguém. Não a registre em log, não a
mande por e-mail e não a fixe no código do cliente.
Idempotência
A idempotência é por ref_id, no escopo da conta. Você não envia header de idempotência.
Chamada
Resposta
ref_id novo
201 com a verificação criada
Mesmo ref_id, mesmo corpo
200 com a verificação existente, o status pode ter avançado
Mesmo ref_id, corpo diferente
409 E_REF_ID_CONFLICT
Isso torna a chamada segura para retentativa: um timeout de rede não cria duas verificações para o
mesmo pedido.
Códigos de resposta
HTTP
Código
Quando
201
—
Verificação criada.
200
—
Repetição idempotente recuperou a existente.
400
E_VALIDATION_FAILURE
Forma do corpo, CPF ou campo inválido.
401
E_UNAUTHORIZED_ACCESS
Chave ausente, inválida, expirada ou revogada.
403
E_FORBIDDEN
Chave válida, sem permissão de criar verificação.
404
E_NOT_FOUND
Fluxo fora do alcance da conta, sem versão publicada, ou integração sem fluxo padrão.
409
E_REF_ID_CONFLICT
Mesmo ref_id, corpo diferente.
415
E_UNSUPPORTED_MEDIA_TYPE
Content-Type não é application/json.
422
E_ORIGIN_NOT_VERIFIED
Reservado para origem de app. Não alcançável pela criação atual.
Escrita obrigatória de auditoria indisponível. Tente de novo.
Quando o 404 é de fluxo
O 404 E_NOT_FOUND da criação é o mesmo para quatro situações diferentes, de propósito: a resposta
não conta a quem pergunta o que existe na conta de outra pessoa. As quatro são de fluxo.
O que aconteceu
Como confirmar
A chamada não mandou flow_public_id e a integração não tem fluxo padrão
Em Integrações, a coluna Fluxo padrão mostra Sem fluxo
O flow_public_id não existe, ou é de outra conta
Compare com o id em Fluxos → Copiar ID do fluxo
O fluxo existe, mas nunca foi publicado
O fluxo aparece em Fluxos sem versão publicada
O fluxo está inativo
O fluxo aparece arquivado em Fluxos
Mande o flow_public_id na chamada e o primeiro caso sai da lista. O fluxo padrão da integração é
definido pela Legitimuz na implantação; se a sua integração está sem ele, fale com o
suporte.O formato do corpo de erro está em erros da API.
Próximo passo
Abrir o fluxo
O que fazer com a entry no browser ou no app.
Receber a decisão
O evento que fecha o ciclo, com o desfecho no corpo.
{"docsConfig":{"theme":"luma","$schema":"https://mintlify.com/docs.json","name":"Legitimuz","colors":{"primary":"#cc4d10","light":"#ff8a5c","dark":"#e95619"},"logo":{"light":"https://mintcdn.com/legitimuz/9pOZL4ZEzOtWno8y/logo/light.svg?fit=max\u0026auto=format\u0026n=9pOZL4ZEzOtWno8y\u0026q=85\u0026s=4a36c05f08a54410ff008e827d8924fe","dark":"https://mintcdn.com/legitimuz/9pOZL4ZEzOtWno8y/logo/dark.svg?fit=max\u0026auto=format\u0026n=9pOZL4ZEzOtWno8y\u0026q=85\u0026s=720a7db781c73c8faf97dbd9707036ac"},"favicon":"https://mintcdn.com/legitimuz/SUSGJqxwn2xgSwy6/favicon.svg?fit=max\u0026auto=format\u0026n=SUSGJqxwn2xgSwy6\u0026q=85\u0026s=e02b6f12d7d8f49f9b767cf56730cf1e","api":{"playground":{"display":"simple"},"mdx":{"server":"https://api-core.legitimuz.com"}},"appearance":{"default":"light"},"navbar":{"links":[{"href":"https://legitimuz.com/#contato","label":"Suporte"}],"primary":{"type":"button","label":"Dashboard","href":"https://painel.legitimuz.com"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/legitimuzbr","instagram":"https://www.instagram.com/legitimuz","youtube":"https://www.youtube.com/@legitimuz"}},"fonts":{"family":"Inter"},"icons":{"library":"tabler"},"contextual":{"options":["copy",{"title":"Ver como LLM txt","description":"O índice da doc em texto puro, para colar num agente","icon":"file-text","href":"/llms.txt"},"chatgpt","claude","perplexity","mcp"],"display":"header"},"thumbnails":{"fonts":{"family":"Inter"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"legitimuz","hasAudioNarration":false,"actualSubdomain":"legitimuz","customDomains":["documentacao.legitimuz.com"],"gitSource":{"type":"github","owner":"legitimuz-tech","repo":"legitimuz-core-documentation","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6af7032ae90c1f4f013ee67d","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Documentação","count":38},{"language":"default","tag":"Guias","count":16},{"language":"default","tag":"Recursos","count":15},{"language":"default","tag":"POCs","count":12},{"language":"default","tag":"Plataforma","count":12},{"language":"default","tag":"Referência","count":11},{"language":"default","tag":"Web SDK","count":10},{"language":"default","tag":"API","count":8},{"language":"default","tag":"Começar","count":7},{"language":"default","tag":"Boas práticas","count":4}],"searchSettings":{"showContentSnippets":true}},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"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":"site-roles","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":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","content":":root{--lz-brand: #fd7138;--lz-brand-border: #e95619;--lz-brand-logo: #fd7b46;--lz-text-title: #161616;--lz-text-strong: #171717;--lz-text-secondary: #606060;--lz-text-sub: #5c5c5c;--lz-icon-soft: #a3a3a3;--lz-bg: #ffffff;--lz-bg-weak: #f7f7f7;--lz-bg-sunken: #fafafa;--lz-border: #ebebeb;--lz-success: #189050;--lz-success-lighter: #def9ea;--lz-error: #fb3748;--lz-error-lighter: #ffebec;--lz-info: #335cff;--lz-info-lighter: #ebf1ff;--lz-warning: #fa7319;--lz-warning-lighter: #fff3eb;--lz-radius: 12px;--lz-radius-sm: 8px;--lz-radius-full: 999px;--lz-control-height: 36px;--lz-content-padding: 32px;--lz-header-height: 52px}#content-area h1{font-weight:500;font-size:1.5rem;line-height:1.75rem;letter-spacing:-0.015em}#content-area h2{font-weight:500;font-size:1.125rem;line-height:1.75rem;letter-spacing:-0.01em}#content-area h3{font-weight:500;font-size:1rem;line-height:1.5rem;letter-spacing:normal}#content-area p,#content-area li,#content-area td{font-size:0.875rem;line-height:1.375rem}#content-area strong{font-weight:500}#content-area [class*=\"card\"] h2,#content-area [class*=\"card\"] h3,#content-area [class*=\"card\"] strong,#sidebar a,#navbar a{font-weight:500}#content-area table td{min-width:0}#content-area table td code{white-space:nowrap}#content-area{padding-bottom:45vh}#content-area .card h2,#content-area .card h3{font-size:1rem;line-height:1.5rem;letter-spacing:normal}#content-area .card .prose,#content-area .card .prose p,#content-area .card .prose span{font-size:0.8125rem;line-height:1.25rem}#content-area header[class*=\"page-header\"]>div.prose{display:none}@media (min-width: 1024px){#background-color{background-color:var(--lz-bg-sunken)}#content-container{background-color:var(--lz-bg);border:1px solid var(--lz-border);border-radius:var(--lz-radius);margin-right:12px;margin-bottom:12px}.dark #background-color{background-color:rgb(var(--gray-900))}.dark #content-container{background-color:rgb(var(--background-dark));border-color:rgb(var(--gray-800))}}#navbar div[class*=\"border-b\"]{border-bottom-width:0}#navbar .topbar-right-container a:not([class*=\"bg-primary\"]){border-color:transparent}#navbar .topbar-right-container a:not([class*=\"bg-primary\"]){background-color:rgb(var(--gray-950) / 0.03)}.dark #navbar .topbar-right-container a:not([class*=\"bg-primary\"]){background-color:rgb(255 255 255 / 0.06)}@media (min-width: 1024px){#navigation-items>div{padding-left:8px;padding-right:8px;padding-top:4px;padding-bottom:40px}}.dark #content-area .card{background-color:rgb(var(--gray-900));border-color:transparent}#navbar div.z-0{background-color:var(--lz-bg-sunken)}.dark #navbar div.z-0{background-color:rgb(var(--gray-900))}@media (min-width: 1024px){html,body{height:100%;overflow:hidden}#content-container{flex:none;height:calc(100vh - var(--lz-header-height) - 12px);overflow-y:auto;overscroll-behavior:contain}#content-side-layout{height:calc(100vh - var(--lz-header-height) - 12px - 3rem - var(--banner-height, 0px))}}#sidebar-content a,#sidebar-content button{border-radius:var(--lz-radius-sm);transition:background-color 100ms ease}#sidebar-content a:hover,#sidebar-content button:hover{background-color:rgb(var(--gray-950) / 0.04)}#sidebar-content a[aria-current=\"page\"],#sidebar-content a[aria-current=\"page\"]:hover{background-color:color-mix(in srgb, var(--lz-brand) 10%, transparent)}.dark #sidebar-content a:hover,.dark #sidebar-content button:hover{background-color:rgb(255 255 255 / 0.05)}.dark #sidebar-content a[aria-current=\"page\"],.dark #sidebar-content a[aria-current=\"page\"]:hover{background-color:color-mix(in srgb, var(--lz-brand) 16%, transparent)}#content-area header[class*=\"page-header\"] button span.grid{display:none}#content-area header[class*=\"page-header\"] div[class*=\"min-w-\"]{min-width:0}#content-area header[class*=\"page-header\"] button:has(span.grid){display:inline-flex;align-items:center;justify-content:center;width:34px;height:34px;padding:0}#sidebar-content .sidebar-title{font-size:0.8125rem;font-weight:500;letter-spacing:0.02em;margin-top:12px;margin-bottom:2px;text-transform:none}@media (min-width: 1024px){#content-container{scrollbar-width:thin;scrollbar-color:rgb(var(--gray-950) / 0.18) transparent}#content-container::-webkit-scrollbar{width:4px}#content-container::-webkit-scrollbar-track{background:transparent}#content-container::-webkit-scrollbar-thumb{background-color:rgb(var(--gray-950) / 0.18);border-radius:var(--lz-radius-full)}.dark #content-container{scrollbar-color:rgb(255 255 255 / 0.16) transparent}.dark #content-container::-webkit-scrollbar-thumb{background-color:rgb(255 255 255 / 0.16)}}#sidebar-content [data-component-part=\"scroll-area-scrollbar\"][data-orientation=\"vertical\"]{width:4px;background-color:transparent}#sidebar-content [data-component-part=\"scroll-area-thumb\"]{background-color:rgb(var(--gray-950) / 0.18)}.dark #sidebar-content [data-component-part=\"scroll-area-thumb\"]{background-color:rgb(255 255 255 / 0.16)}#content-area details.accordion{border-radius:var(--lz-radius);background-color:rgb(var(--gray-100))}#content-area .accordion-group{border-radius:var(--lz-radius);overflow:hidden}#content-area .accordion-group>details.accordion{border-radius:0}.dark #content-area details.accordion{background-color:rgb(var(--gray-900))}#content-area [data-component-part=\"accordion-content\"],#content-area [data-component-part=\"accordion-content\"] p,#content-area [data-component-part=\"accordion-content\"] li{font-size:0.875rem;line-height:1.25rem}@media (min-width: 1024px){#navbar div.z-10.relative{padding-inline:24px}#navbar div.z-10.relative>div>div[class*=\"h-12\"]{padding-inline:0}#navbar div[class*=\"h-12\"]{height:var(--lz-header-height)}#sidebar-content{top:calc(var(--lz-header-height) + var(--banner-height, 0px))!important;height:calc(100vh - var(--lz-header-height) - var(--banner-height, 0px))!important}}body[class]{overflow:clip}:root{--lz-cl-ink: var(--lz-text-strong);--lz-cl-accent: #a8470a}.dark{--lz-cl-ink: rgb(var(--gray-50));--lz-cl-accent: #ff9a6b}@media (min-width: 1024px){body:has(.update-container) #sidebar-content{display:none}body:has(.update-container) #body-content{padding-left:0}body:has(.update-container) #content-container{margin-left:12px}}body:has(.update-container) #content-area{max-width:912px;margin-inline:auto}body:has(.update-container) #content-area #header h1{font-size:28px;line-height:36px;font-weight:600;letter-spacing:-0.02em}body:has(.update-container) #page-context-menu{display:none}body:has(.update-container) #content-area header#header{padding-bottom:32px;border-bottom:1px solid color-mix(in srgb, var(--lz-cl-ink) 12%, transparent)}body:has(.update-container) #content-area header#header>div.prose{display:block;margin-top:12px}body:has(.update-container) #content-area header#header>div.prose p{max-width:40rem;margin:0;font-size:16px;line-height:24px;font-weight:400;color:color-mix(in srgb, var(--lz-cl-ink) 60%, transparent)}#content-area .update-container{gap:32px;margin-top:48px;padding-block:0;color:var(--lz-cl-ink)}#content-area .update-container:first-child{margin-top:16px}#content-area .update-container+.update-container{margin-top:16px;padding-top:48px;border-top:1px solid color-mix(in srgb, var(--lz-cl-ink) 12%, transparent)}#content-area .update-container>div:first-child{width:208px}#content-area [data-component-part=\"update-label\"]{margin-top:0;padding:4px 10px;border-radius:6px;font-size:14px;line-height:16px;font-weight:600;white-space:nowrap;color:var(--lz-cl-accent);background-color:color-mix(in srgb, var(--lz-brand) 14%, transparent)}#content-area .update-container>div:last-child{padding-inline:0}#content-area [data-component-part=\"update-content\"]{min-width:0;flex:1;font-size:16px;line-height:28px;color:var(--lz-cl-ink)}#content-area [data-component-part=\"update-content\"]>:first-child{margin-top:0}#content-area [data-component-part=\"update-content\"] h2{margin:0;font-size:18px;line-height:24px;font-weight:600;letter-spacing:-0.01em}#content-area [data-component-part=\"update-content\"] h2+[data-as=\"p\"]{padding-top:8px;font-size:14px;line-height:24px;color:color-mix(in srgb, var(--lz-cl-ink) 60%, transparent)}#content-area [data-component-part=\"update-content\"] h3{margin:32px 0 8px;font-size:16px;line-height:24px;font-weight:600;letter-spacing:0}#content-area [data-component-part=\"update-content\"] h4{margin:24px 0 8px;font-size:14px;line-height:24px;font-weight:600}#content-area [data-component-part=\"update-content\"] h3+h4{margin-top:12px}#content-area [data-component-part=\"update-content\"] ul{margin:0 0 12px;padding-left:0}#content-area [data-component-part=\"update-content\"] li{margin:8px 0;line-height:28px}@layer components{#content-area [data-component-part=\"update-content\"] li{padding-left:24px!important}}#content-area [data-component-part=\"update-content\"] li::before{top:12px;left:4.5px;width:4px;height:4px;background-color:color-mix(in srgb, var(--lz-cl-ink) 45%, transparent)}#content-area [data-component-part=\"update-content\"] li>ul{margin:0}#content-area [data-component-part=\"update-content\"] strong{font-weight:600}#content-area [data-component-part=\"update-content\"] a.link{border-bottom:0;font-weight:500;color:color-mix(in srgb, var(--lz-cl-ink) 60%, transparent);text-decoration:underline;text-decoration-thickness:1px;text-underline-offset:4px}#content-area [data-component-part=\"update-content\"] :not(pre)>code{padding:2px 4px;border:0;border-radius:4px;font-size:14px;line-height:1.75;font-weight:600;color:color-mix(in srgb, var(--lz-cl-ink) 69%, transparent);background-color:color-mix(in srgb, var(--lz-cl-ink) 5%, transparent)}"}]}
{"page":{"pagePath":"api/create-verification","slug":"/api/create-verification","pageMetadata":{"title":"Criar verificação","description":"POST /public/verifications, o corpo, a resposta, a idempotência por ref_id e os onze códigos de resposta.","api":"POST /public/verifications","href":"/api/create-verification"},"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: \"POST /public/verifications, o corpo, a resposta, a idempotência por ref_id e os onze códigos de resposta.\"\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`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Card,CodeBlock,CodeGroup,Columns,Expandable,Heading,ParamField,ResponseField,Table,Warning}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Columns)_missingMdxReference(`Columns`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,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:[_jsx(_components.p,{children:`Cria uma verificação e emite a entrada da jornada. É a única chamada que o seu servidor faz para\ncomeçar uma verificação.`}),`\n`,_jsx(_components.p,{children:`A chamada resolve a conta e a integração pela chave, fixa a versão publicada do fluxo naquele\ninstante e devolve a entrada da jornada. É por isso que ela nasce no seu backend: a chave de API\nnunca chega ao browser nem ao app.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`8`,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:`8`,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:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api-core.legitimuz.com/public/verifications`}),_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:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-API-Key: `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$LEGITIMUZ_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_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:` -H`}),_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:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"schema_version\": \"1.0\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"ref_id\": \"pedido-4471\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"document\": { \"type\": \"cpf\", \"number\": \"\u003cCPF_DO_TITULAR>\" }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`autenticação`,children:`Autenticação`}),`\n`,_jsxs(ParamField,{header:`X-API-Key`,type:`string`,required:true,id:`param-x-api-key`,children:[_jsxs(_components.p,{children:[`A chave da integração, no formato `,_jsx(_components.code,{children:`lz_...`}),`. Criada em\n`,_jsx(_components.a,{href:`/platform/tokens`,children:`Integrações → Segurança → Chaves de API`}),`.`]}),_jsxs(_components.p,{children:[`A chave não é aceita no corpo nem na query. Veja `,_jsx(_components.a,{href:`/start/authentication`,children:`autenticação`}),`.`]})]}),`\n`,_jsx(ParamField,{header:`Content-Type`,type:`string`,required:true,id:`param-content-type`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`application/json`}),`. Qualquer outro valor responde `,_jsx(_components.code,{children:`415`}),`.`]})}),`\n`,_jsx(ParamField,{header:`traceparent`,type:`string`,id:`param-traceparent`,children:_jsx(_components.p,{children:`Propaga tracing distribuído. Opcional.`})}),`\n`,_jsx(Heading,{level:`2`,id:`corpo`,children:`Corpo`}),`\n`,_jsx(ParamField,{body:`schema_version`,type:`string`,required:true,id:`param-schema-version`,children:_jsxs(_components.p,{children:[`A versão do contrato. Hoje, `,_jsx(_components.code,{children:`\"1.0\"`}),`.`]})}),`\n`,_jsxs(ParamField,{body:`document`,type:`object`,required:true,id:`param-document`,children:[_jsx(_components.p,{children:`O documento que identifica o titular.`}),_jsxs(Expandable,{title:`campos`,children:[_jsx(ParamField,{body:`document.type`,type:`string`,required:true,id:`param-document-type`,children:_jsxs(_components.p,{children:[`Hoje só `,_jsx(_components.code,{children:`\"cpf\"`}),`.`]})}),_jsx(ParamField,{body:`document.number`,type:`string`,required:true,id:`param-document-number`,children:_jsx(_components.p,{children:`Normalizado e validado no servidor. Nunca volta na resposta nem no bootstrap do widget.`})})]})]}),`\n`,_jsxs(ParamField,{body:`flow_public_id`,type:`string`,id:`param-flow-public-id`,children:[_jsxs(_components.p,{children:[`O fluxo que a verificação vai usar. Copie o id em `,_jsx(_components.strong,{children:`Solução KYC → Fluxos`}),`, no menu da linha do\nfluxo, em `,_jsx(_components.strong,{children:`Copiar ID do fluxo`}),`.`]}),_jsxs(_components.p,{children:[`Ausente, a chamada usa o fluxo padrão da integração. Se a integração não tiver fluxo padrão\ndefinido, a resposta é `,_jsx(_components.code,{children:`404 E_NOT_FOUND`}),` — o mesmo código de um fluxo que não existe. Veja\n`,_jsx(_components.a,{href:`#quando-o-404-%C3%A9-de-fluxo`,children:`quando o 404 é de fluxo`}),`.`]})]}),`\n`,_jsxs(ParamField,{body:`ref_id`,type:`string`,id:`param-ref-id`,children:[_jsx(_components.p,{children:`A sua chave para essa verificação, número do pedido, id do cadastro. Até 120 caracteres, único\npor conta.`}),_jsxs(_components.p,{children:[`É o que volta no webhook de desfecho. Sem ele, você precisa guardar o `,_jsx(_components.code,{children:`public_id`}),` da plataforma\npara saber de quem é o evento.`]})]}),`\n`,_jsx(Heading,{level:`2`,id:`resposta`,children:`Resposta`}),`\n`,_jsx(ResponseField,{name:`schema_version`,type:`string`,id:`param-schema-version-1`,children:_jsx(_components.p,{children:`A versão do contrato.`})}),`\n`,_jsx(ResponseField,{name:`verification`,type:`object`,id:`param-verification`,children:_jsxs(Expandable,{title:`campos`,children:[_jsx(ResponseField,{name:`verification.public_id`,type:`string`,id:`param-verification-public-id`,children:_jsxs(_components.p,{children:[`O identificador da verificação, e o mesmo valor que abre a jornada: é ele que vai no\nfragmento da `,_jsx(_components.code,{children:`entry.url`}),`. Guarde-o no seu banco para ligar o webhook ao seu pedido, e trate-o\ncomo segredo de curta duração até o `,_jsx(_components.code,{children:`expires_at`}),`.`]})}),_jsx(ResponseField,{name:`verification.status`,type:`string`,id:`param-verification-status`,children:_jsxs(_components.p,{children:[`Um dos seis `,_jsx(_components.a,{href:`/api/verification-status`,children:`status`}),`. Numa criação, `,_jsx(_components.code,{children:`not_opened`}),`.`]})}),_jsx(ResponseField,{name:`verification.expires_at`,type:`string`,id:`param-verification-expires-at`,children:_jsx(_components.p,{children:`Quando a jornada deixa de poder ser aberta. ISO 8601 em UTC.`})})]})}),`\n`,_jsxs(ResponseField,{name:`entry`,type:`object`,id:`param-entry`,children:[_jsxs(_components.p,{children:[`Como o titular entra na jornada. União discriminada por `,_jsx(_components.code,{children:`kind`}),`. Quem decide é a origem resolvida\npela sua chave: origem de domínio web, ou integração sem origem, devolve `,_jsx(_components.code,{children:`\"web\"`}),`; origem de\nbundle de app devolve `,_jsx(_components.code,{children:`\"native\"`}),`.`]}),_jsxs(_components.p,{children:[`As SDKs de `,_jsx(_components.a,{href:`/sdks/android`,children:`Android`}),` e `,_jsx(_components.a,{href:`/sdks/ios`,children:`iOS`}),` consomem o `,_jsx(_components.strong,{children:`embed URL`}),` de `,_jsx(_components.code,{children:`entry.url`}),`.`]}),_jsxs(Expandable,{title:`campos`,children:[_jsx(ResponseField,{name:`entry.kind`,type:`string`,id:`param-entry-kind`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`\"web\"`}),` ou `,_jsx(_components.code,{children:`\"native\"`}),`.`]})}),_jsx(ResponseField,{name:`entry.url`,type:`string`,id:`param-entry-url`,children:_jsxs(_components.p,{children:[`Só em `,_jsx(_components.code,{children:`kind: \"web\"`}),`. A URL da jornada, com o `,_jsx(_components.code,{children:`public_id`}),` da verificação no fragmento. Gere o\nQR code a partir dela se quiser entrega por celular.`]})}),_jsx(ResponseField,{name:`entry.public_id`,type:`string`,id:`param-entry-public-id`,children:_jsxs(_components.p,{children:[`Só em `,_jsx(_components.code,{children:`kind: \"native\"`}),`. É o mesmo `,_jsx(_components.code,{children:`verification.public_id`}),`, sem a URL em volta.`]})})]})]}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`Link web`,numberOfLines:`12`,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:`12`,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:` \"schema_version\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1.0\"`}),_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:` \"verification\"`}),_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:` \"public_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"019f0000-0000-7000-8000-000000000000\"`}),_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:`\"not_opened\"`}),_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:` \"expires_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-09-15T14:30:00.000Z\"`})]}),`\n`,_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:` \"entry\"`}),_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:` \"kind\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"web\"`}),_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:` \"url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://verify.legitimuz.com/#v=019f0000-0000-7000-8000-000000000000\"`})]}),`\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`]})})}),_jsx(CodeBlock,{filename:`App nativo`,numberOfLines:`12`,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:`12`,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:` \"schema_version\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1.0\"`}),_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:` \"verification\"`}),_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:` \"public_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"019f0000-0000-7000-8000-000000000000\"`}),_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:`\"not_opened\"`}),_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:` \"expires_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-09-15T14:30:00.000Z\"`})]}),`\n`,_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:` \"entry\"`}),_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:` \"kind\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"native\"`}),_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:` \"public_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"019f0000-0000-7000-8000-000000000000\"`})]}),`\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(Warning,{children:_jsxs(_components.p,{children:[`A `,_jsx(_components.code,{children:`entry.url`}),` carrega a credencial da jornada. Trate-a como segredo de curta duração: ela sai do\nseu backend para o titular daquela verificação e para mais ninguém. Não a registre em log, não a\nmande por e-mail e não a fixe no código do cliente.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`idempotência`,children:`Idempotência`}),`\n`,_jsxs(_components.p,{children:[`A idempotência é por `,_jsx(_components.code,{children:`ref_id`}),`, no escopo da conta. Você não envia header de idempotência.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Chamada`}),_jsx(_components.th,{children:`Resposta`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`ref_id`}),` novo`]}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`201`}),` com a verificação criada`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`Mesmo `,_jsx(_components.code,{children:`ref_id`}),`, mesmo corpo`]}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`200`}),` com a verificação existente, o `,_jsx(_components.code,{children:`status`}),` pode ter avançado`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`Mesmo `,_jsx(_components.code,{children:`ref_id`}),`, corpo diferente`]}),_jsx(_components.td,{children:_jsx(_components.code,{children:`409 E_REF_ID_CONFLICT`})})]})]})]}),`\n`,_jsx(_components.p,{children:`Isso torna a chamada segura para retentativa: um timeout de rede não cria duas verificações para o\nmesmo pedido.`}),`\n`,_jsx(Heading,{level:`2`,id:`códigos-de-resposta`,children:`Códigos de resposta`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`HTTP`}),_jsx(_components.th,{children:`Código`}),_jsx(_components.th,{children:`Quando`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`201`})}),_jsx(_components.td,{children:`—`}),_jsx(_components.td,{children:`Verificação criada.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`200`})}),_jsx(_components.td,{children:`—`}),_jsx(_components.td,{children:`Repetição idempotente recuperou a existente.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`E_VALIDATION_FAILURE`})}),_jsx(_components.td,{children:`Forma do corpo, CPF ou campo inválido.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`401`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`E_UNAUTHORIZED_ACCESS`})}),_jsx(_components.td,{children:`Chave ausente, inválida, expirada ou revogada.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`403`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`E_FORBIDDEN`})}),_jsx(_components.td,{children:`Chave válida, sem permissão de criar verificação.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`404`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`E_NOT_FOUND`})}),_jsx(_components.td,{children:`Fluxo fora do alcance da conta, sem versão publicada, ou integração sem fluxo padrão.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`409`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`E_REF_ID_CONFLICT`})}),_jsxs(_components.td,{children:[`Mesmo `,_jsx(_components.code,{children:`ref_id`}),`, corpo diferente.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`415`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`E_UNSUPPORTED_MEDIA_TYPE`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`Content-Type`}),` não é `,_jsx(_components.code,{children:`application/json`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`422`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`E_ORIGIN_NOT_VERIFIED`})}),_jsx(_components.td,{children:`Reservado para origem de app. Não alcançável pela criação atual.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`429`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`E_RATE_LIMITED`})}),_jsxs(_components.td,{children:[`Teto da chave ou da integração. Veja `,_jsx(_components.a,{href:`/api/errors#limites-de-uso`,children:`limites`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`500`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`E_INTERNAL_SERVER_ERROR`})}),_jsx(_components.td,{children:`Falha inesperada.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`503`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`E_AUDIT_UNAVAILABLE`})}),_jsx(_components.td,{children:`Escrita obrigatória de auditoria indisponível. Tente de novo.`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`quando-o-404-é-de-fluxo`,children:`Quando o 404 é de fluxo`}),`\n`,_jsxs(_components.p,{children:[`O `,_jsx(_components.code,{children:`404 E_NOT_FOUND`}),` da criação é o mesmo para quatro situações diferentes, de propósito: a resposta\nnão conta a quem pergunta o que existe na conta de outra pessoa. As quatro são de fluxo.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`O que aconteceu`}),_jsx(_components.th,{children:`Como confirmar`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`A chamada não mandou `,_jsx(_components.code,{children:`flow_public_id`}),` e a integração não tem fluxo padrão`]}),_jsxs(_components.td,{children:[`Em `,_jsx(_components.strong,{children:`Integrações`}),`, a coluna `,_jsx(_components.strong,{children:`Fluxo padrão`}),` mostra `,_jsx(_components.strong,{children:`Sem fluxo`})]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`O `,_jsx(_components.code,{children:`flow_public_id`}),` não existe, ou é de outra conta`]}),_jsxs(_components.td,{children:[`Compare com o id em `,_jsx(_components.strong,{children:`Fluxos → Copiar ID do fluxo`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`O fluxo existe, mas nunca foi publicado`}),_jsxs(_components.td,{children:[`O fluxo aparece em `,_jsx(_components.strong,{children:`Fluxos`}),` sem versão publicada`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`O fluxo está inativo`}),_jsxs(_components.td,{children:[`O fluxo aparece arquivado em `,_jsx(_components.strong,{children:`Fluxos`})]})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Mande o `,_jsx(_components.code,{children:`flow_public_id`}),` na chamada e o primeiro caso sai da lista. O fluxo padrão da integração é\ndefinido pela Legitimuz na implantação; se a sua integração está sem ele, fale com o\n`,_jsx(_components.a,{href:`https://painel.legitimuz.com/support`,children:`suporte`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`O formato do corpo de erro está em `,_jsx(_components.a,{href:`/api/errors`,children:`erros da API`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`próximo-passo`,children:`Próximo passo`}),`\n`,_jsxs(Columns,{cols:2,children:[_jsx(Card,{title:`Abrir o fluxo`,icon:`window-maximize`,href:`/guides/first-verification`,children:_jsxs(_components.p,{children:[`O que fazer com a `,_jsx(_components.code,{children:`entry`}),` no browser ou no app.`]})}),_jsx(Card,{title:`Receber a decisão`,icon:`broadcast`,href:`/webhooks/events#verificationdecided`,children:_jsx(_components.p,{children:`O evento que fecha o ciclo, com o desfecho no corpo.`})})]})]})}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":"Criar verificação","description":"POST /public/verifications, o corpo, a resposta, a idempotência por ref_id e os onze códigos de resposta.","api":"POST /public/verifications","href":"/api/create-verification"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Autenticação","slug":"autenticação","depth":2,"children":[]},{"title":"Corpo","slug":"corpo","depth":2,"children":[]},{"title":"Resposta","slug":"resposta","depth":2,"children":[]},{"title":"Idempotência","slug":"idempotência","depth":2,"children":[]},{"title":"Códigos de resposta","slug":"códigos-de-resposta","depth":2,"children":[{"title":"Quando o 404 é de fluxo","slug":"quando-o-404-é-de-fluxo","depth":3,"children":[]}]},{"title":"Próximo passo","slug":"próximo-passo","depth":2,"children":[]}],"codeExamples":{},"endpoint":{"title":"Criar verificação","path":"/public/verifications","servers":[{"url":"https://api-core.legitimuz.com"}],"method":"post","request":{"security":[],"parameters":{"query":{},"header":{"X-API-Key":{"schema":[{"type":"string","description":"A chave da integração, no formato `lz_...` . Criada em Integrações → Segurança → Chaves de API . A chave não é aceita no corpo nem na query. Veja autenticação .","required":true}]},"Content-Type":{"schema":[{"type":"string","description":"`application/json` . Qualquer outro valor responde `415` .","required":true}]},"traceparent":{"schema":[{"type":"string","description":"Propaga tracing distribuído. Opcional."}]}},"cookie":{},"path":{}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"schema_version":[{"type":"string","description":"A versão do contrato. Hoje, `\"1.0\"` .","required":true}],"document":[{"type":"object","properties":{"document.type":[{"type":"string","description":"Hoje só `\"cpf\"` .","required":true}],"document.number":[{"type":"string","description":"Normalizado e validado no servidor. Nunca volta na resposta nem no bootstrap do widget.","required":true}]},"description":"O documento que identifica o titular.","required":true}],"flow_public_id":[{"type":"string","description":"O fluxo que a verificação vai usar. Copie o id em Solução KYC → Fluxos , no menu da linha do fluxo, em Copiar ID do fluxo . Ausente, a chamada usa o fluxo padrão da integração. Se a integração não tiver fluxo padrão definido, a resposta é `404 E_NOT_FOUND` — o mesmo código de um fluxo que não existe. Veja quando o 404 é de fluxo ."}],"ref_id":[{"type":"string","description":"A sua chave para essa verificação, número do pedido, id do cadastro. Até 120 caracteres, único por conta. É o que volta no webhook de desfecho. Sem ele, você precisa guardar o `public_id` da plataforma para saber de quem é o evento."}]}}],"examples":{"example":{"value":{"schema_version":"\u003cstring>","document":{"document.type":"\u003cstring>","document.number":"\u003cstring>"},"flow_public_id":"\u003cstring>","ref_id":"\u003cstring>"}}}}}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"schema_version":[{"type":"string","description":"A versão do contrato."}],"verification":[{"type":"object","properties":{"verification.public_id":[{"type":"string","description":"O identificador da verificação, e o mesmo valor que abre a jornada: é ele que vai no fragmento da `entry.url` . Guarde-o no seu banco para ligar o webhook ao seu pedido, e trate-o como segredo de curta duração até o `expires_at` ."}],"verification.status":[{"type":"string","description":"Um dos seis status . Numa criação, `not_opened` ."}],"verification.expires_at":[{"type":"string","description":"Quando a jornada deixa de poder ser aberta. ISO 8601 em UTC."}]}}],"entry":[{"type":"object","properties":{"entry.kind":[{"type":"string","description":"`\"web\"` ou `\"native\"` ."}],"entry.url":[{"type":"string","description":"Só em `kind: \"web\"` . A URL da jornada, com o `public_id` da verificação no fragmento. Gere o QR code a partir dela se quiser entrega por celular."}],"entry.public_id":[{"type":"string","description":"Só em `kind: \"native\"` . É o mesmo `verification.public_id` , sem a URL em volta."}]},"description":"Como o titular entra na jornada. União discriminada por `kind` . Quem decide é a origem resolvida pela sua chave: origem de domínio web, ou integração sem origem, devolve `\"web\"` ; origem de bundle de app devolve `\"native\"` . As SDKs de Android e iOS consomem o embed URL de `entry.url` ."}]}}],"examples":{"example":{"value":{"schema_version":"\u003cstring>","verification":{"verification.public_id":"\u003cstring>","verification.status":"\u003cstring>","verification.expires_at":"\u003cstring>"},"entry":{"entry.kind":"\u003cstring>","entry.url":"\u003cstring>","entry.public_id":"\u003cstring>"}}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"legitimuz","siteName":"Legitimuz","title":"Criar verificação - Legitimuz","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-10T21:21:12.573Z","originalFileLocation":"api/create-verification.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=\"light\"}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=\"POST /public/verifications, o corpo, a resposta, a idempotência por ref_id e os onze códigos de resposta.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Legitimuz\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/legitimuz/5TE1TzlW77Fl94qb/_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/legitimuz/5TE1TzlW77Fl94qb/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/legitimuz/5TE1TzlW77Fl94qb/_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/legitimuz/5TE1TzlW77Fl94qb/_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/legitimuz/5TE1TzlW77Fl94qb/_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/legitimuz/5TE1TzlW77Fl94qb/_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/legitimuz/5TE1TzlW77Fl94qb/_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/legitimuz/5TE1TzlW77Fl94qb/_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/legitimuz/5TE1TzlW77Fl94qb/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Criar verificação - Legitimuz\">\u003cmeta data-mint-head property=\"og:description\" content=\"POST /public/verifications, o corpo, a resposta, a idempotência por ref_id e os onze códigos de resposta.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Legitimuz\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://documentacao.legitimuz.com/api/create-verification\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://legitimuz.mintlify.site/_mintlify/api/og/v2?division=API\u0026amp;title=Criar+verifica%C3%A7%C3%A3o\u0026amp;description=POST+%2Fpublic%2Fverifications%2C+o+corpo%2C+a+resposta%2C+a+idempot%C3%AAncia+por+ref_id+e+os+onze+c%C3%B3digos+de+resposta.\u0026amp;theme=91152f83c9e2345b0bd03cc4\u0026amp;signature=e7ba91cd702513d251d2614eec0800cb875db79f3fe7175c502855577fdfcdb9\">\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=\"Criar verificação - Legitimuz\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"POST /public/verifications, o corpo, a resposta, a idempotência por ref_id e os onze códigos de resposta.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://legitimuz.mintlify.site/_mintlify/api/og/v2?division=API\u0026amp;title=Criar+verifica%C3%A7%C3%A3o\u0026amp;description=POST+%2Fpublic%2Fverifications%2C+o+corpo%2C+a+resposta%2C+a+idempot%C3%AAncia+por+ref_id+e+os+onze+c%C3%B3digos+de+resposta.\u0026amp;theme=91152f83c9e2345b0bd03cc4\u0026amp;signature=e7ba91cd702513d251d2614eec0800cb875db79f3fe7175c502855577fdfcdb9\">\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/legitimuz/5TE1TzlW77Fl94qb/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Legitimuz\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#cc4d10\">\u003clink data-mint-head rel=\"canonical\" href=\"https://documentacao.legitimuz.com/api/create-verification\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api/create-verification.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://documentacao.legitimuz.com/#organization\",\"name\":\"Legitimuz\",\"url\":\"https://documentacao.legitimuz.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/legitimuz/9pOZL4ZEzOtWno8y/logo/light.svg?fit=max\u0026auto=format\u0026n=9pOZL4ZEzOtWno8y\u0026q=85\u0026s=4a36c05f08a54410ff008e827d8924fe\"}},{\"@type\":\"WebSite\",\"@id\":\"https://documentacao.legitimuz.com#website\",\"name\":\"Legitimuz\",\"url\":\"https://documentacao.legitimuz.com\",\"publisher\":{\"@id\":\"https://documentacao.legitimuz.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://documentacao.legitimuz.com/api/create-verification#webpage\",\"url\":\"https://documentacao.legitimuz.com/api/create-verification\",\"name\":\"Criar verificação\",\"description\":\"POST /public/verifications, o corpo, a resposta, a idempotência por ref_id e os onze códigos de resposta.\",\"dateModified\":\"2026-11-10T21:21:12.573Z\",\"isPartOf\":{\"@id\":\"https://documentacao.legitimuz.com#website\"},\"breadcrumb\":{\"@id\":\"https://documentacao.legitimuz.com/api/create-verification#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://documentacao.legitimuz.com/api/create-verification#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API\",\"item\":\"https://documentacao.legitimuz.com/api/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Criar verificação\",\"item\":\"https://documentacao.legitimuz.com/api/create-verification\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://documentacao.legitimuz.com/api/create-verification#apireference\",\"headline\":\"Criar verificação\",\"name\":\"Criar verificação\",\"description\":\"POST /public/verifications, o corpo, a resposta, a idempotência por ref_id e os onze códigos de resposta.\",\"url\":\"https://documentacao.legitimuz.com/api/create-verification\",\"mainEntityOfPage\":{\"@id\":\"https://documentacao.legitimuz.com/api/create-verification#webpage\"},\"dateModified\":\"2026-11-10T21:21:12.573Z\",\"publisher\":{\"@id\":\"https://documentacao.legitimuz.com/#organization\"},\"isPartOf\":{\"@id\":\"https://documentacao.legitimuz.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Legitimuz\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Legitimuz\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api/create-verification.md","siteName":"Legitimuz","nav":{"global":null,"tabs":[{"tab":"Documentação","icon":"book","pages":[{"title":"Documentação","href":""}]},{"tab":"Guias","icon":"compass","pages":[{"title":"Guias","href":"/guides/pocs/next-checkout"}]},{"tab":"Referência","icon":"terminal-2","pages":[{"group":"API","pages":[{"title":"Visão geral","sidebarTitle":"Visão geral","description":"A API pública da Legitimuz: as quatro rotas, como autenticam e o que fica do lado do widget.","href":"/api/introduction"},{"title":"Criar verificação","api":"POST /public/verifications","href":"/api/create-verification"},{"title":"Listar verificações por titular","sidebarTitle":"Listar verificações","description":"GET /public/verifications: a verificação mais recente de cada titular, com filtros, paginação e o resultado de cada etapa.","api":"GET /public/verifications","href":"/api/list-verifications"},{"title":"Consultar uma verificação","sidebarTitle":"Consultar verificação","api":"GET /public/verifications/{public_id}","href":"/api/get-verification"},{"title":"Baixar imagens da verificação","sidebarTitle":"Baixar imagens","api":"GET /public/verifications/{public_id}/files","href":"/api/verification-files"},{"title":"Status de verificação","sidebarTitle":"Status","href":"/api/verification-status"},{"title":"Consultar identidade com o LegitID","sidebarTitle":"LegitID","api":"POST /v1/legitid/verifications","href":"/api/legitid-verifications"},{"title":"Erros e limites","sidebarTitle":"Erros","href":"/api/errors"}]},{"group":"Webhooks","pages":[{"title":"Visão geral","sidebarTitle":"Visão geral","href":"/webhooks/introduction"},{"title":"Eventos","sidebarTitle":"Eventos","href":"/webhooks/events"},{"title":"Segurança","sidebarTitle":"Segurança","href":"/webhooks/security"}]}]},{"tab":"Changelog","icon":"history","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"Criar verificação - Legitimuz","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","b0f84f53ff","2b790eda92"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","Page-CVJ-f_k1.js","CodeSnippet-D_HwgQO_.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","getApiPlaygroundDisplay-CmCoerhe.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js"]}