Initiate a KYC verification session for a person entity — in the gu1 KYC API for identity verification flows, with examples for create validation use cases.
This endpoint creates a new KYC validation session for a person entity using a configured integration provider. After creating the validation, you’ll receive a verification URL that you can share with your customer to complete identity verification.
Full sequence from entity creation to KYC validation (production flow; in sandbox with test document numbers the provider step is skipped and the API returns the mock result and webhooks immediately—see Sandbox mock data):
Key Points in the Flow
1. Entity and duplicate taxId
Create the person entity first via POST /api/entities (with countryCode). If the taxId already exists in the organization, the API returns 409 and does not create a duplicate; use the existing entity’s ID.
You need an existing entityId to create a KYC validation.
2. Integration code
global_gueno_validation_kyc is the standard code for full KYC verification and works in sandbox with no extra setup.
3. Verification URL
In production, the response includes providerSessionUrl. Send that URL to your user; they complete the flow on the provider’s hosted page (document + selfie). The URL is valid until expiresAt.
In sandbox, if the entity’s document number is in the test list, no provider session is used: the API returns 201 with pending status and moments later updates the validation and sends webhooks (e.g. kyc.validation_approved or kyc.validation_rejected) with no user step. Important: You must have a webhook endpoint configured to receive the responses - see Sandbox mock data.
4. Webhook events
When the validation finishes, the API sends a webhook to your URL. The event is one of: kyc.validation_approved, kyc.validation_rejected, kyc.validation_abandoned, kyc.validation_expired, kyc.validation_cancelled (not a single “completed” event). The payload is the full validation object.
You can also poll GET /api/kyc/validations/:id for status updates.
Person entity must exist: Create a person entity using the Entities API
KYC integration configured: Your organization must have a KYC integration provider activated (e.g., global_gueno_validation_kyc)
Valid API key: Authenticate with your API key
Sandbox vs Production: Sandbox environments do NOT require profile setup or pre-configuration. You can test KYC validations immediately in sandbox with test data. Production environments require:
Completed organization onboarding
KYC integration provider activated by gu1 team
Sufficient credit balance for KYC operations
To get started in sandbox, simply use your sandbox API key - no additional setup needed.
In sandbox, when the person entity’s document number (taxId) matches one of our test values, the API returns an immediate mock result (e.g. approved, rejected, cancelled) and sends the corresponding webhooks—no real verification is run. Document format does not matter (e.g. 99.990.001 and 99990001 both work).For the full list of test document numbers by format (Argentina DNI/CUIT, Brazil CPF/CNPJ), expected outcomes, and example responses, see Sandbox mock data.
When you call POST /api/entities with a taxId that already exists in the same organization for the same entity type (person/company), the API does not create a second entity. It returns 409 Conflict with error code DUPLICATE_TAX_ID and includes the existing entity’s id, name, and type in the response details.What you should do:
Option A – Check first: Use GET /api/entities?taxId=12345678 (or the by-tax-id endpoint) before creating. If an entity exists, use its entityId for KYC.
Option B – Handle 409: If you get 409, read error.details.existingEntityId from the response and use that entityId for your KYC validation.
Reuse the same entity: Use one entity per person/company and create multiple KYC validations on that same entityId if you need re-verification or new attempts.
You can create multiple KYC validations for the same entity:
Each validation gets a unique ID and session
The newest validation is marked as isCurrent: true when created and keeps that reference while pending, in_progress, in_review, approved, rejected, expired, or abandoned
cancelled is the only exception: cancelling the current validation restores the most recent prior validation whose status is not cancelled, when one exists
Use cases: Re-verification, expired validations, failed attempts
If the entity already has an open validation (pending, in_progress, or in_review), create returns 409 VALIDATION_IN_PROGRESS with activeValidationId — cancel that validation first, then create again
Additive contract: Existing clients that only read error and message are unchanged. activeValidationId is optional metadata on the 409 response to skip an extra lookup before cancel.
When true, enables RENAPER double-check for Argentina entities. On terminal statuses the API queries the official registry (data and, when applicable, biometrics) and stores results in metadata. Only when OCR KYC verification returns status approved can a cross-check failure automatically set the validation to rejected; on in_review or rejected the check is informational (enforcementApplied: false).Type: boolean (e.g. ?doubleCheckRenaper=true)Requirements: Entity must be from Argentina (countryCode === 'AR'), and the organization must have RENAPER credentials configured in System Settings → Organizations → Config. If credentials are missing, the creation may fail or the double-check will be skipped depending on configuration.
Tax or document number. Gu1 resolves it with normalized match on entities.tax_id. The entity must exist (404 if not found).
In sandbox, GET /api/entities/by-tax-id/{taxId} can return a synthetic preview for catalog test numbers (sandboxMock: true) without a DB row. POST /validations still requires a real persisted entity.
The integration provider code for KYC validationStandard Value: global_gueno_validation_kyc (recommended for most use cases)Type: string (min length: 1)
What is integrationCode?The integrationCode identifies which KYC provider integration to use for verification. Think of it as selecting the verification service.Available Integration Codes:
global_gueno_validation_kyc - Recommended - Full KYC with document + selfie + face match + liveness
Custom codes may be configured for your organization (contact support)
Optional hosted verification UI language, for example es, en, or pt.
The request value takes precedence over the organization’s default KYC language.
If neither is configured, the hosted UI detects the language from the end-user device.
Same as query param doubleCheckRenaper. When true, enables RENAPER double-check for Argentina. Can be sent in the body or as ?doubleCheckRenaper=true. If both are present, the query param takes precedence.
Optional list of KYC warning risk codes (exact strings). Stored on the validation as metadata.omitWarnings. After the session completes, if the validation would be in_review, warnings is non-empty, and every code in warnings appears in this list, the API sets status to approved and keeps all warnings for display and audit. If any warning is not in omitWarnings, status stays in_review. If warnings is empty while status is in_review, this rule does not auto-approve. Invalid or unknown codes in the request body return 400. When the rule applies, metadata.kycOmitWarningsApplied records the decision timestamp and matched warnings.Non-omittable codes (e.g. GUENO_CROSS_ENTITY_DUPLICATED) are rejected in this field with 400 and always block omit auto-approve even if present in warnings.Type: string[] (each element must be an allowlisted code; duplicates are ignored)
When RENAPER double-check is enabled, metadata.doubleChecks.renaper is set to true at creation. After OCR KYC verification completes and the double-check runs, metadata.responseDoubleChecks.renaper is populated (see RENAPER double-check below).
Custom metadata. When RENAPER double-check is requested, includes doubleChecks: { renaper: true }. After approval and double-check execution, may include responseDoubleChecks.renaper (see RENAPER double-check section).
After approval, media keys appear inside decision. To download files (images, video), use GET /api/kyc/validations/:id/media?key=... with Authorization: Bearer. Full details: Get KYC validation media.
When the entity already has an open validation (pending, in_progress, or in_review), Gu1 syncs with the hosted capture session when possible, then rejects a second create:
{ "error": "VALIDATION_IN_PROGRESS", "message": "Cannot create new KYC validation. There is already a pending validation for this entity. Please cancel or complete the existing validation first.", "activeValidationId": "7618e10c-b1b1-408b-b361-1901077ced73"}
Recovery:409 → DELETE /api/kyc/validations/{activeValidationId}/cancel → one new POST /api/kyc/validations.Terminal validations (approved, rejected, cancelled, expired, abandoned) do not block creating a new one.
When doubleCheckRenaper is true and the entity is from Argentina, on each terminal status (approved, rejected, in_review) the API runs a cross-check against the official Argentine registry (RENAPER) when sufficient OCR data exists. Automatic rejection by RENAPER only applies when OCR KYC verification returned status approved.
All RENAPER double-check results are stored in metadata.responseDoubleChecks.renaper. Mismatch codes are added to metadata.warnings alongside OCR KYC verification warnings. errorCode on the renaper object keeps the first failure for compatibility; UIs can list every code from comparisonResults and warnings.Shape of metadata.responseDoubleChecks.renaper:
This is the unmodified body returned by the registry via ms-providers (POST …/provider-records/renaper/data). Gu1 forwards it as-is in metadata.responseDoubleChecks.renaper.renaperData. Field names use snake_case; all fields are optional depending on what RENAPER returns for each lookup.Example (successful double-check, matchResult: "match"):
Per-field map (dni, tramite, name, ejemplar, dateOfBirth, expirationDate). Each entry may include:
Field
Type
Description
compared
boolean
true if comparison was attempted; false if skipped due to missing data.
passed
boolean
Outcome when compared is true.
skipReason
string
ocr_missing, renaper_missing, or both_missing when not compared.
ocrValue
string
OCR-extracted value (when applicable).
renaperValue
string
Registry value from RENAPER (when applicable).
similarityPercent
number
For name only: Levenshtein similarity (0–100).
threshold
number
For name only: applied threshold (e.g. 80).
errorCode
string
Field failure code (e.g. RENAPER_DNI_NOT_MATCH).
For ejemplar, the OCR value is extractedData.ejemplar (see extractedData fields). Comparison runs when both OCR and RENAPER values exist.Example — extractedData on an approved KYC validation (Argentina):
Nested under metadata.responseDoubleChecks.renaper.renaperBiometric when the org has biometric credentials and the KYC session provides a selfie. Gu1 sends one selfie to validate-dni; RENAPER compares it to the ID photo on file.
Field
Type
Description
verified
boolean
true when the ABIS biometric check returns resultado.match.
matchResult
string
"match" | "mismatch" | "error".
score
number
Score from the biometric check (when present).
verifiedAt
string
ISO timestamp of the biometric check.
renaperData
object
Raw validate-dni response (includes resultado.match, resultado.score, etc.).
submittedSelfieRef
string
Reference of the selfie sent: storage path (kyc/...) or URL (https://...).
submittedSelfieRefKind
string
Format of submittedSelfieRef: s3_key (internal path) | url (public URL).
submittedSelfiePickedFrom
string
Source in decision: liveness_reference_image or face_match_target_image.
When the double-check fails, metadata.warnings contains one of the following codes (and metadata.responseDoubleChecks.renaper.errorCode is set to the same value). Your UI should translate these codes into user-facing messages.
Code
Meaning
RENAPER_DNI_MISSING
No document number (DNI) was obtained from the KYC verification.
RENAPER_GENDER_MISSING
Gender (M/F) is required to call RENAPER and was not available.
RENAPER_VERIFICATION_UNAVAILABLE
Could not complete the cross-check with the registry (e.g. network/API error). Retry later.
RENAPER_DNI_NOT_MATCH
The document number from the verification does not match the official registry.
RENAPER_TRAMITE_DATA_MISSING
Transaction number could not be compared (missing from KYC or RENAPER response).
RENAPER_TRAMITE_ID_NOT_MATCH
The document transaction number does not match the registry. Common when the person used an older copy of the ID, the document is expired, or it was reissued; they should verify again with their current, valid ID.
RENAPER_NAME_NOT_MATCH
OCR name is below the 80% similarity threshold vs the RENAPER registry.
RENAPER_EJEMPLAR_NOT_MATCH
ID copy letter (ejemplar) does not match the RENAPER registry.
RENAPER_DOB_NOT_MATCH
OCR date of birth does not match the RENAPER registry.
RENAPER_EXPIRY_NOT_MATCH
OCR expiration date does not match the RENAPER registry.
RENAPER_BIOMETRIC_NOT_MATCH
Selfie does not match the ID photo in the biometric registry.
RENAPER_BIOMETRIC_UNAVAILABLE
Biometric check could not be completed (network, credentials, or service).
RENAPER can change status to rejected only on the direct approved path. On in_review / rejected / manual approve, failures appear as codes in metadata.warnings and in metadata.responseDoubleChecks.renaper without auto-rejection. Use the table above and translation keys (e.g. kyc.rejectionReasonCodes.*).
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"gu1","colors":{"primary":"#6366f1","light":"#818cf8","dark":"#4f46e5"},"logo":{"light":"https://mintcdn.com/geno-f35946c5/u95feZdjOS0TUwM0/logo/light.svg?fit=max\u0026auto=format\u0026n=u95feZdjOS0TUwM0\u0026q=85\u0026s=2538da257ffd4de46bd5e7c5a7a70349","dark":"https://mintcdn.com/geno-f35946c5/u95feZdjOS0TUwM0/logo/dark.svg?fit=max\u0026auto=format\u0026n=u95feZdjOS0TUwM0\u0026q=85\u0026s=c47938269a3a978691d27b98a3ef7631","href":"https://gu1.ai"},"favicon":"https://mintcdn.com/geno-f35946c5/1v-_8K99Mep7uuN6/logo/favicon.png?fit=max\u0026auto=format\u0026n=1v-_8K99Mep7uuN6\u0026q=85\u0026s=af8122bd505fa307f92768669dd1b0f6","api":{"mdx":{"auth":{"method":"bearer"},"server":"http://api.gu1.ai"}},"navbar":{"links":[{"href":"https://app.gu1.ai","label":"Dashboard"},{"href":"/en/changelog","label":"Changelog"}],"primary":{"type":"button","label":"Get Started","href":"https://app.gu1.ai/signup"}},"footer":{"socials":{"twitter":"https://twitter.com/gueno","linkedin":"https://linkedin.com/company/gueno","github":"https://github.com/tkgueno"}},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"geno-f35946c5","hasAudioNarration":false,"actualSubdomain":"geno-f35946c5","customDomains":["docs.gu1.ai"],"gitSource":{"type":"github","owner":"gueno-repositories","repo":"gueno-v3-ai","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae24c55d8d824087a00d8f6","collectionId":"22970b3f-c4ec-4a1a-939b-793b70d84fc8","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae24c55d8d824087a00d8f6"},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae24c55d8d824087a00d8f6","clientVersion":"0.0.4043","searchFilterCounts":[{"language":"default","tag":"API Reference","count":205},{"language":"default","tag":"Referencia API","count":160},{"language":"default","tag":"Referência API","count":159},{"language":"default","tag":"Workflows","count":66},{"language":"default","tag":"Empresa","count":44},{"language":"default","tag":"Casos de Uso","count":34},{"language":"default","tag":"Webhooks","count":30},{"language":"default","tag":"Know Your Customer (KYC)","count":29},{"language":"default","tag":"AML Crypto","count":27},{"language":"default","tag":"Conozca Su Cliente (KYC)","count":27}]},"assistantConfig":{"enableStarterQuestions":false,"deflection":{"enabled":true,"email":"support@gu1.ai"}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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}],"googleFontsInlined":false},"customCss":[{"filePath":"design-system/overview-v2-shell/overview.css","content":".app{display:grid;grid-template-columns:232px 1fr;grid-template-rows:48px 1fr;grid-template-areas:\"top top\" \"side main\";min-height:100vh}.topbar{grid-area:top;gap:12px;padding:0 16px;background:var(--bg-panel);border-bottom:1px solid var(--br-subtle);position:sticky;top:0;z-index:50}.brand,.topbar,.topbar-left{display:flex;align-items:center}.topbar-left{gap:12px;min-width:232px}.brand{gap:8px;padding-right:10px;margin-right:4px;border-right:1px solid var(--br-subtle);height:28px}.brand-mark{font-weight:700;font-size:14px;letter-spacing:-.01em}.ws-switch{display:flex;align-items:center;gap:6px;font-size:var(--t-meta);padding:4px 8px;border-radius:var(--r-2);cursor:pointer}.env-pill:hover,.ws-switch:hover{background:var(--bg-hover)}.ws-label{color:var(--fg-secondary)}.ws-sep{color:var(--fg-quaternary)}.ws-name{color:var(--fg-primary);font-weight:500}.env-pill{display:inline-flex;align-items:center;gap:6px;font-size:var(--t-micro);padding:3px 8px;border:1px solid var(--br-default);border-radius:var(--r-full);color:var(--fg-secondary)}.env-dot{width:6px;height:6px;border-radius:50%;background:var(--success);box-shadow:0 0 0 3px var(--success-soft)}.env-dot.warn{background:var(--high);box-shadow:0 0 0 3px var(--high-soft)}.cmdk,.topbar-right{display:flex;align-items:center}.cmdk,.cmdk kbd,kbd{border:1px solid var(--br-default)}.cmdk{flex:1;max-width:480px;gap:8px;height:30px;padding:0 10px;margin:0 auto;background:var(--bg-canvas);border-radius:var(--r-3);font-size:var(--t-meta);color:var(--fg-tertiary);transition:border-color .15s}.cmdk:hover{border-color:var(--br-strong)}.cmdk span{flex:1;text-align:left}.cmdk kbd,kbd{font-family:var(--font-mono);font-size:10px;padding:2px 6px;border-radius:4px;background:var(--bg-elevated);color:var(--fg-secondary)}.topbar-right{gap:4px;margin-left:auto}.icon-btn,.quota{display:inline-flex;align-items:center;gap:6px}.quota{font-size:var(--t-micro);padding:4px 10px;border:1px solid var(--br-default);border-radius:var(--r-full)}.quota .ai-fg{color:var(--ai-fg)}.icon-btn{width:30px;height:30px;justify-content:center;border-radius:var(--r-2);color:var(--fg-secondary);position:relative}.icon-btn:hover{background:var(--bg-hover);color:var(--fg-primary)}.icon-btn.lang{width:auto;padding:0 8px}.icon-btn .agent-label,.icon-btn.lang{font-size:var(--t-micro)}.icon-btn:has(.agent-label){width:auto;padding:0 10px}.badge-dot{position:absolute;top:6px;right:6px;width:6px;height:6px;border-radius:50%;background:var(--critical)}.avatar{width:28px;height:28px;border-radius:50%;background:linear-gradient(135deg,oklch(.6 .1 250),oklch(.55 .12 290));color:#fff;font-size:10.5px;font-weight:600;display:inline-flex;align-items:center;justify-content:center;letter-spacing:.02em;margin-left:4px}.sidebar{grid-area:side;background:var(--bg-panel);border-right:1px solid var(--br-subtle);padding:12px 8px 8px;position:sticky;top:48px;height:calc(100vh - 48px);overflow-y:auto}.nav,.nav-group,.sidebar{display:flex;flex-direction:column}.nav{flex:1;gap:14px}.nav-group{gap:1px}.nav-label{font-size:10px;font-weight:600;letter-spacing:.06em;text-transform:uppercase;color:var(--fg-quaternary);padding:6px 10px 4px}.nav-item{display:flex;align-items:center;gap:9px;height:28px;padding:0 10px;border-radius:var(--r-2);font-size:var(--t-body);color:var(--fg-secondary);cursor:pointer;transition:background .12s,color .12s}.nav-item:hover{background:var(--bg-hover);color:var(--fg-primary)}.nav-item.active{background:var(--bg-active);color:var(--fg-primary)}.nav-item.active .nav-icon{color:var(--accent-fg)}.nav-icon{color:var(--fg-tertiary)}.nav-item:hover .nav-icon{color:var(--fg-secondary)}.nav-text{flex:1}.nav-badge{font-size:10px;padding:1px 6px;border-radius:var(--r-full);background:var(--bg-elevated);color:var(--fg-tertiary);font-variant-numeric:tabular-nums}.nav-badge.danger{background:var(--critical-soft);color:var(--critical-fg)}.nav-tag{font-size:9px;padding:1px 5px;border-radius:3px;background:var(--ai-soft);color:var(--ai-fg);letter-spacing:.04em;text-transform:uppercase;font-weight:600}.sidebar-foot{display:flex;align-items:center;gap:6px;padding:8px 4px 4px;border-top:1px solid var(--br-subtle);margin-top:8px}.ws-card{flex:1;padding:6px 8px;border-radius:var(--r-2)}.ws-card:hover{background:var(--bg-hover);cursor:pointer}.ws-card-row{display:flex;align-items:center;gap:6px;font-size:var(--t-meta)}.ws-card-row.sub{font-size:var(--t-micro);margin-top:2px}.ws-card-name{font-weight:600}.role-tag{font-size:9.5px;padding:1px 5px;border:1px solid var(--br-default);border-radius:3px;color:var(--fg-tertiary);letter-spacing:.04em}.settings-btn{width:28px;height:28px;display:inline-flex;align-items:center;justify-content:center;color:var(--fg-tertiary);border-radius:var(--r-2)}.settings-btn:hover{background:var(--bg-hover);color:var(--fg-primary)}.main{grid-area:main;background:var(--bg-canvas);min-width:0}.overview{display:grid;grid-template-columns:minmax(0,1fr) 332px;gap:28px;max-width:1400px;padding:24px 32px 80px;margin:0 auto}.overview.no-side{grid-template-columns:1fr}.overview.no-side .overview-side{display:none}.overview-main{display:flex;flex-direction:column;gap:24px;min-width:0}.overview-side{min-width:0}.block{display:flex;flex-direction:column}.block-head{display:flex;align-items:center;justify-content:space-between;padding:0 2px 10px;border-bottom:1px solid var(--br-subtle);margin-bottom:14px;gap:12px}.block-head.collapsable{width:100%;text-align:left}.block-head.collapsable:hover .block-title,.ghost-btn:hover{color:var(--fg-primary)}.block-title-wrap{display:flex;flex-direction:column;gap:2px;min-width:0}.block-title{margin:0;font-size:var(--t-h2);font-weight:600;letter-spacing:-.005em;display:inline-flex;align-items:center;gap:8px}.block-meta{font-size:var(--t-micro)}.block-actions{display:flex;gap:4px;align-items:center}.inline-ico{color:currentColor}.beta-pill{font-size:9px;padding:1px 5px;border-radius:3px;background:var(--ai-soft);color:var(--ai-fg);text-transform:uppercase;letter-spacing:.06em;font-weight:700}.btn-ghost,.btn-primary,.ghost-btn{font-size:var(--t-meta);border-radius:var(--r-2);display:inline-flex;align-items:center;gap:6px}.ghost-btn{color:var(--fg-secondary);height:26px;padding:0 8px}.ghost-btn:hover{background:var(--bg-hover)}.ghost-btn.align-right{margin-left:auto}.btn-ghost,.btn-primary{height:28px;padding:0 10px}.btn-primary{background:var(--accent-soft);color:var(--accent-fg);font-weight:500;border:1px solid transparent}.btn-primary:hover{background:var(--accent);color:#fff}.btn-ghost{color:var(--fg-secondary)}.btn-ghost:hover{background:var(--bg-hover);color:var(--fg-primary)}.sev-dot{width:6px;height:6px;border-radius:50%;display:inline-block;flex:0 0 6px}.sev-pill{display:inline-flex;align-items:center;gap:0;font-size:var(--t-micro);padding:1px 6px;border-radius:3px;font-weight:500;letter-spacing:.01em}.sev-crit{background:var(--critical)}.sev-pill.sev-crit{background:var(--critical-soft);color:var(--critical-fg)}.sev-high{background:var(--high)}.sev-pill.sev-high{background:var(--high-soft);color:var(--high-fg)}.sev-med{background:var(--medium)}.sev-pill.sev-med{background:var(--medium-soft);color:var(--medium-fg)}.sev-low{background:var(--low)}.sev-pill.sev-low{background:var(--low-soft);color:var(--low-fg)}.brk.crit b,.crit-text{color:var(--critical-fg)}.brk.warn b,.warn-text{color:var(--high-fg)}.success-text{color:var(--success)}.ai-fg{color:var(--ai-fg)}.kv dt,.muted{color:var(--fg-tertiary)}.meta-sep{color:var(--fg-quaternary);margin:0 6px}.briefing{display:grid;grid-template-columns:minmax(0,1fr) 280px;gap:28px;padding-bottom:4px}.briefing-text{min-width:0}.briefing-meta{font-size:var(--t-micro);color:var(--fg-tertiary);display:flex;align-items:center;flex-wrap:wrap;margin-bottom:8px}.briefing-meta .env-inline{display:inline-flex;align-items:center;gap:5px}.briefing-meta .env-dot{width:5px;height:5px;box-shadow:none}.briefing-title{font-size:var(--t-display);font-weight:600;letter-spacing:-.022em;margin:0 0 8px;line-height:1.1}.briefing-lede{font-size:15px;line-height:1.55;max-width:64ch;color:var(--fg-secondary);margin:0 0 18px}.activity-line strong,.briefing-lede strong{color:var(--fg-primary);font-weight:600}.next-up{display:flex;flex-direction:column;gap:8px}.next-up-label{font-size:10.5px;text-transform:uppercase;letter-spacing:.08em;color:var(--fg-tertiary);display:inline-flex;align-items:center;gap:6px;font-weight:600}.next-up-card{width:100%;display:flex;align-items:stretch;justify-content:space-between;padding:14px 16px;border:1px solid var(--br-default);border-left:3px solid var(--critical);border-radius:var(--r-3);background:var(--bg-panel);text-align:left;transition:border-color .15s,background .15s}.next-up-card:hover{background:var(--bg-elevated);border-color:var(--br-strong);border-left-color:var(--critical)}.next-up-main{display:flex;flex-direction:column;gap:6px;flex:1;min-width:0}.next-up-headline{display:flex;align-items:center;gap:10px;flex-wrap:wrap}.case-id{font-size:var(--t-meta);color:var(--fg-tertiary);letter-spacing:.02em}.case-title{font-size:15px;font-weight:600;color:var(--fg-primary)}.next-up-sub{font-size:var(--t-meta);color:var(--fg-secondary);display:flex;align-items:center;flex-wrap:wrap}.due-now,.next-up-action{display:inline-flex;align-items:center;font-weight:500}.due-now{gap:5px;color:var(--critical-fg)}.next-up-action{gap:8px;align-self:center;padding:8px 14px;border-radius:var(--r-3);font-size:var(--t-body);flex-shrink:0}.next-up-action,[data-theme=light] .next-up-action{background:var(--accent);color:#fff}.next-up-card:hover .next-up-action{background:oklch(from var(--accent) calc(l + .05) c h)}.next-up-strip{display:flex;align-items:center;gap:10px;font-size:var(--t-meta);padding:0 2px;flex-wrap:wrap}.next-chip{display:inline-flex;align-items:center;gap:6px;color:var(--fg-secondary)}.next-link{color:var(--accent-fg);font-size:var(--t-meta);margin-left:auto}.next-link:hover{text-decoration:underline}.my-stats{display:flex;flex-direction:column;gap:0;background:var(--bg-panel);border:1px solid var(--br-subtle);border-radius:var(--r-3);overflow:hidden}.my-stat-row{padding:14px 16px;display:grid;grid-template-columns:1fr auto;grid-template-rows:auto auto;column-gap:12px;row-gap:4px;align-items:baseline}.my-stat-row+.my-stat-row{border-top:1px solid var(--br-subtle)}.my-stat-lab{font-size:var(--t-micro);color:var(--fg-tertiary);text-transform:uppercase;letter-spacing:.06em;font-weight:600}.my-stat-num{font-size:28px;font-weight:600;letter-spacing:-.02em;line-height:1;text-align:right;grid-row:1/3;align-self:center}.my-stat-break{font-size:var(--t-micro);color:var(--fg-tertiary);display:flex;gap:10px}.brk b{font-weight:600}.brk b,.brk.low b{color:var(--fg-secondary)}.venc-list{gap:6px}.venc-group,.venc-list{display:flex;flex-direction:column}.venc-group-head{display:flex;align-items:baseline;gap:8px;padding:8px 4px 4px;font-size:var(--t-micro);text-transform:uppercase;letter-spacing:.08em;font-weight:600;color:var(--fg-tertiary);border-bottom:1px dashed var(--br-subtle);margin-bottom:2px}.venc-group-name,.venc-row{color:var(--fg-secondary)}.venc-row{display:grid;grid-template-columns:8px 64px minmax(180px,1fr) auto auto auto auto 16px;align-items:center;gap:14px;width:100%;height:36px;padding:0 8px 0 6px;border-radius:var(--r-2);text-align:left;font-size:var(--t-body);transition:background .12s}.venc-row:hover{background:var(--bg-hover)}.venc-row:hover .venc-title{color:var(--fg-primary)}.venc-id{color:var(--fg-tertiary);font-size:var(--t-meta)}.venc-title{color:var(--fg-primary);font-weight:500;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.venc-tags{display:inline-flex;gap:5px;flex-shrink:0}.tag{font-size:10.5px;padding:1px 7px;border-radius:3px;background:var(--bg-elevated);color:var(--fg-tertiary);border:1px solid var(--br-subtle)}.venc-score{display:inline-flex;gap:5px;align-items:baseline;font-size:var(--t-meta)}.venc-assignee,.venc-due{font-size:var(--t-meta);white-space:nowrap}.venc-due{display:inline-flex;align-items:center;gap:4px;min-width:84px;justify-content:flex-end;color:var(--fg-secondary)}.venc-due.crit-text{color:var(--critical-fg);font-weight:500}.venc-go{color:var(--fg-quaternary)}.venc-row:hover .venc-go{color:var(--fg-secondary)}.insight,.insights-list{display:flex;flex-direction:column;gap:0}.insight{position:relative;padding:16px 16px 14px 22px;border-bottom:1px solid var(--br-subtle);gap:8px}.fraud-top li:last-child,.insight:last-child{border-bottom:none}.insight-rail{position:absolute;left:0;top:18px;bottom:18px;width:2px;border-radius:2px;background:var(--ai);opacity:.5}.insight:hover .insight-rail{opacity:1}.insight-head{display:flex;align-items:center;justify-content:space-between;gap:12px;flex-wrap:wrap}.insight-lead{display:inline-flex;align-items:center;gap:10px;font-size:var(--t-micro);color:var(--fg-tertiary)}.insight-agent,.insight-conf{display:inline-flex;align-items:center;gap:5px}.insight-agent .mono{font-size:var(--t-micro);color:var(--ai-fg);font-weight:500}.insight-conf{gap:8px;font-size:var(--t-micro);color:var(--fg-tertiary)}.insight-conf .num{color:var(--fg-secondary);font-weight:600}.conf-bar{width:56px;height:3px;background:var(--bg-elevated);border-radius:2px;overflow:hidden}.conf-fill{height:100%;background:var(--ai);border-radius:2px}.insight-title{margin:2px 0 0;font-size:15.5px;font-weight:600;letter-spacing:-.005em;line-height:1.3}.insight-body{margin:0;font-size:var(--t-body);color:var(--fg-secondary);line-height:1.55;max-width:80ch}.insight-foot{display:flex;align-items:center;justify-content:space-between;gap:12px;margin-top:4px;flex-wrap:wrap}.insight-related{display:inline-flex;align-items:center;gap:6px;font-size:var(--t-micro)}.insight-actions{display:inline-flex;gap:4px}.fraud-block .block-head{cursor:pointer}.fraud-grid{display:grid;grid-template-columns:1.4fr 1fr 1fr 1.2fr;gap:1px;background:var(--br-subtle);border:1px solid var(--br-subtle);border-radius:var(--r-3);overflow:hidden}.fraud-cell{background:var(--bg-panel);padding:14px 16px;min-height:92px;display:flex;flex-direction:column;gap:4px}.fraud-cell.big{grid-row:span 1}.fraud-cell.wide{grid-column:1/-1}.fraud-lab{font-size:var(--t-micro);color:var(--fg-tertiary);text-transform:uppercase;letter-spacing:.06em;font-weight:600}.fraud-num,.fraud-num-s{font-size:28px;font-weight:600;letter-spacing:-.02em;line-height:1.1;margin-top:2px}.fraud-num-s{font-size:22px;letter-spacing:-.01em;line-height:1.2}.fraud-cur{font-size:13px;color:var(--fg-tertiary);font-weight:500;margin-left:2px}.fraud-delta{font-size:var(--t-micro);display:inline-flex;align-items:center;gap:5px;margin-top:auto}.fraud-rule{font-size:15px;font-weight:500;margin-top:4px}.fraud-top{list-style:none;padding:0;margin:8px 0 0;display:flex;flex-direction:column;gap:0}.fraud-top li{display:grid;grid-template-columns:8px 64px minmax(180px,1fr) auto 60px;gap:14px;align-items:center;font-size:var(--t-meta);height:30px;border-bottom:1px dashed var(--br-subtle)}.fraud-top .num{font-weight:600;color:var(--fg-primary)}.fraud-top .muted{text-align:right}.shortcuts-grid{display:grid;grid-template-columns:repeat(3,1fr);gap:8px}.shortcut,.shortcut-ico{align-items:center;color:var(--fg-secondary)}.shortcut{display:flex;gap:10px;padding:10px 12px;border:1px solid var(--br-default);border-radius:var(--r-3);background:var(--bg-panel);font-size:var(--t-body);transition:background .12s,border-color .12s,color .12s}.shortcut:hover{background:var(--bg-elevated);border-color:var(--br-strong);color:var(--fg-primary)}.shortcut.primary{border-color:var(--accent-soft);color:var(--fg-primary)}.doc-top .crumbs a,.shortcut.primary .shortcut-ico{color:var(--accent-fg)}.shortcut-ico{width:28px;height:28px;border-radius:var(--r-2);background:var(--bg-elevated);display:inline-flex;justify-content:center}.shortcut-label{flex:1;font-weight:500}.kbd-inline,.kbd-mini{font-family:var(--font-mono);font-size:10px;padding:1px 5px;border-radius:3px;border:1px solid var(--br-default)}.kbd-mini{background:var(--bg-canvas);color:var(--fg-tertiary)}.kbd-inline{background:var(--bg-elevated);color:var(--fg-secondary)}.activity-col{position:sticky;top:72px;display:flex;flex-direction:column;gap:12px;max-height:calc(100vh - 96px)}.activity-head{padding-bottom:6px;border-bottom:1px solid var(--br-subtle)}.activity-filters{display:flex;gap:2px;padding:0 2px}.activity-filter{font-size:var(--t-micro);padding:4px 8px;border-radius:var(--r-2);color:var(--fg-tertiary)}.activity-filter:hover{background:var(--bg-hover);color:var(--fg-primary)}.activity-filter.on{background:var(--bg-active);color:var(--fg-primary)}.activity-list{list-style:none;margin:0;display:flex;flex-direction:column;gap:0;overflow-y:auto;flex:1;padding:0 4px 0 0}.activity-item{display:grid;grid-template-columns:22px 1fr;gap:10px;padding:10px 0;border-bottom:1px dashed var(--br-subtle)}.activity-item:last-child{border-bottom:none}.activity-ico{width:22px;height:22px;border-radius:var(--r-2);display:inline-flex;align-items:center;justify-content:center}.activity-ico.c-ai{background:var(--ai-soft);color:var(--ai-fg)}.activity-ico.c-success{background:var(--success-soft);color:var(--success)}.activity-ico.c-high{background:var(--high-soft);color:var(--high-fg)}.activity-ico.c-crit{background:var(--critical-soft);color:var(--critical-fg)}.activity-ico.c-muted{background:var(--bg-elevated);color:var(--fg-secondary)}.activity-body{min-width:0}.activity-line{font-size:var(--t-meta);color:var(--fg-secondary);line-height:1.4}.activity-target{color:var(--fg-primary)}.activity-meta,.activity-more{display:inline-flex;align-items:center}.activity-meta{font-size:var(--t-micro);margin-top:2px;flex-wrap:wrap}.activity-more{margin-top:4px;font-size:var(--t-meta);color:var(--accent-fg);gap:6px;padding:8px 0;align-self:flex-start}.activity-more:hover,.doc-top .crumbs a:hover{text-decoration:underline}@media (max-width:1240px){.overview{grid-template-columns:1fr}.overview-side{display:none}.briefing{grid-template-columns:1fr}}@media (max-width:980px){.app{grid-template-columns:64px 1fr}.sidebar{padding:8px 4px}.nav-badge,.nav-label,.nav-tag,.nav-text,.sidebar-foot .ws-card,.topbar-left .env-pill,.topbar-left .ws-switch{display:none}}.doc{max-width:1100px;margin:0 auto;padding:32px 32px 80px;display:flex;flex-direction:column;gap:36px;color:var(--fg-secondary)}.doc h1,.doc h2,.doc h3{font-weight:600;color:var(--fg-primary);margin:0 0 4px}.doc h1{font-size:24px;letter-spacing:-.015em}.doc h2,.doc h3{font-size:17px}.doc h3{font-size:13px;margin:16px 0 6px;text-transform:uppercase;letter-spacing:.06em}.doc li,.doc p{font-size:13px;line-height:1.6}.doc-section{border-top:1px solid var(--br-subtle);padding-top:28px}.doc-section:first-child{border-top:none;padding-top:0}.doc-lede{font-size:14px;color:var(--fg-secondary);max-width:70ch}.doc-grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(180px,1fr));gap:12px}.swatch{border:1px solid var(--br-subtle);border-radius:var(--r-3);overflow:hidden}.swatch-color{height:60px}.swatch-meta{padding:8px 10px;font-size:var(--t-micro);display:flex;flex-direction:column;gap:2px;background:var(--bg-panel)}.kv dd,.swatch-meta b{color:var(--fg-primary)}.swatch-meta b{font-size:var(--t-meta)}.swatch-meta code{font-family:var(--font-mono);color:var(--fg-tertiary);font-size:10px}.type-row{display:flex;align-items:baseline;gap:16px;padding:10px 0;border-bottom:1px dashed var(--br-subtle)}.type-row .label,.type-row .spec{font-size:var(--t-micro);color:var(--fg-tertiary)}.type-row .label{width:100px;text-transform:uppercase;letter-spacing:.06em}.type-row .spec{width:120px;font-family:var(--font-mono)}.type-row .sample{color:var(--fg-primary);flex:1}.kv{display:grid;grid-template-columns:200px 1fr;gap:6px 16px;font-size:var(--t-body)}.kv dd{margin:0}.doc-foot-link,.note{font-size:var(--t-meta)}.note{padding:12px 14px;border-left:2px solid var(--accent);background:var(--accent-soft);border-radius:0 var(--r-2) var(--r-2) 0;color:var(--fg-secondary)}.doc-foot-link{color:var(--accent-fg);display:inline-flex;align-items:center;gap:6px}.doc-top{position:sticky;top:0;z-index:10;display:flex;align-items:center;justify-content:space-between;padding:12px 32px;background:var(--bg-panel);border-bottom:1px solid var(--br-subtle)}.doc-top .brand{border-right:none;padding-right:0}.doc-top .crumbs{font-size:var(--t-meta);color:var(--fg-tertiary);display:inline-flex;align-items:center;gap:8px}.activity-list::-webkit-scrollbar,.sidebar::-webkit-scrollbar{width:8px}.activity-list::-webkit-scrollbar-thumb,.sidebar::-webkit-scrollbar-thumb{background:var(--bg-active);border-radius:4px}.activity-list::-webkit-scrollbar-track,.sidebar::-webkit-scrollbar-track{background:0 0}"},{"filePath":"design-system/overview-v2-shell/tokens.css","content":":root{--font-sans:\"Inter\", ui-sans-serif, system-ui, -apple-system, \"Segoe UI\", Roboto, sans-serif;--font-mono:\"JetBrains Mono\", ui-monospace, \"SF Mono\", Menlo, Consolas, monospace;--t-display:28px;--t-h1:22px;--t-h2:16px;--t-h3:14px;--t-body:13px;--t-meta:12px;--t-micro:11px;--t-num-xl:36px;--t-num-lg:26px;--lh-tight:1.15;--lh-snug:1.3;--lh-body:1.5;--s-1:4px;--s-2:8px;--s-3:12px;--s-4:16px;--s-5:20px;--s-6:24px;--s-7:32px;--s-8:40px;--s-9:56px;--r-1:4px;--r-2:6px;--r-3:8px;--r-4:10px;--r-full:999px;--h-blue:250;--h-violet:285;--h-red:18;--h-amber:55;--h-green:155;--h-teal:200}:root,[data-theme=dark]{--bg-canvas:#141518;--bg-panel:#1c1e22;--bg-elevated:#252830;--bg-hover:#2e3239;--bg-active:#383d45;--br-subtle:rgba(255,255,255,0.07);--br-default:rgba(255,255,255,0.11);--br-strong:rgba(255,255,255,0.16);--br-focus:oklch(0.72 0.12 var(--h-blue));--fg-primary:#ececed;--fg-secondary:#9ea1a6;--fg-tertiary:#6a6d72;--fg-quaternary:#4a4d52;--fg-disabled:#3a3d42;--accent:oklch(0.72 0.11 var(--h-blue));--accent-soft:oklch(0.72 0.11 var(--h-blue) / 0.14);--accent-fg:oklch(0.78 0.12 var(--h-blue));--critical:oklch(0.66 0.16 var(--h-red));--critical-soft:oklch(0.66 0.16 var(--h-red) / 0.14);--critical-fg:oklch(0.76 0.13 var(--h-red));--high:oklch(0.75 0.13 var(--h-amber));--high-soft:oklch(0.75 0.13 var(--h-amber) / 0.14);--high-fg:oklch(0.82 0.12 var(--h-amber));--medium:oklch(0.70 0.07 var(--h-teal));--medium-soft:oklch(0.70 0.07 var(--h-teal) / 0.14);--medium-fg:oklch(0.78 0.07 var(--h-teal));--low:oklch(0.62 0.02 250);--low-soft:oklch(0.62 0.02 250 / 0.14);--low-fg:oklch(0.72 0.02 250);--success:oklch(0.72 0.11 var(--h-green));--success-soft:oklch(0.72 0.11 var(--h-green) / 0.14);--ai:oklch(0.74 0.12 var(--h-violet));--ai-soft:oklch(0.74 0.12 var(--h-violet) / 0.14);--ai-fg:oklch(0.80 0.11 var(--h-violet));--shadow-1:0 0 0 1px var(--br-subtle);--shadow-2:0 1px 0 0 rgba(0,0,0,0.4), 0 0 0 1px var(--br-subtle);color-scheme:dark}[data-theme=light]{--bg-canvas:#fafaf8;--bg-panel:#ffffff;--bg-elevated:#ffffff;--bg-hover:#f3f3f1;--bg-active:#eaeae7;--br-subtle:rgba(15,15,17,0.07);--br-default:rgba(15,15,17,0.11);--br-strong:rgba(15,15,17,0.18);--br-focus:oklch(0.50 0.14 var(--h-blue));--fg-primary:#0a0a0b;--fg-secondary:#4d4f52;--fg-tertiary:#7c7e82;--fg-quaternary:#a8aaad;--fg-disabled:#c8cacc;--accent:oklch(0.50 0.14 var(--h-blue));--accent-soft:oklch(0.50 0.14 var(--h-blue) / 0.08);--accent-fg:oklch(0.43 0.16 var(--h-blue));--critical:oklch(0.55 0.13 var(--h-red));--critical-soft:oklch(0.55 0.13 var(--h-red) / 0.10);--critical-fg:oklch(0.46 0.14 var(--h-red));--high:oklch(0.66 0.10 var(--h-amber));--high-soft:oklch(0.66 0.10 var(--h-amber) / 0.14);--high-fg:oklch(0.46 0.10 var(--h-amber));--medium:oklch(0.60 0.05 var(--h-teal));--medium-soft:oklch(0.60 0.05 var(--h-teal) / 0.12);--medium-fg:oklch(0.42 0.06 var(--h-teal));--low:oklch(0.62 0.02 250);--low-soft:oklch(0.62 0.02 250 / 0.10);--low-fg:oklch(0.45 0.02 250);--success:oklch(0.50 0.11 var(--h-green));--success-soft:oklch(0.50 0.11 var(--h-green) / 0.10);--ai:oklch(0.52 0.05 295);--ai-soft:oklch(0.92 0.018 295);--ai-fg:oklch(0.42 0.08 295);--shadow-1:0 0 0 1px var(--br-subtle);--shadow-2:0 1px 2px rgba(15,15,17,0.04), 0 0 0 1px var(--br-subtle);color-scheme:light}*{box-sizing:border-box}body,html{margin:0;padding:0}html.theme-switching,html.theme-switching *,html.theme-switching ::after,html.theme-switching ::before{transition:none!important;animation-duration:.001s!important}body{font-family:var(--font-sans);font-size:var(--t-body);line-height:var(--lh-body);color:var(--fg-primary);background:var(--bg-canvas);-webkit-font-smoothing:antialiased;text-rendering:optimizeLegibility;font-feature-settings:\"ss01\" on,\"cv11\" on,\"tnum\" off}a,button{color:inherit}button{font:inherit;background:0 0;border:0;padding:0;cursor:pointer}input,textarea{font:inherit;color:inherit}a{text-decoration:none}:focus-visible{outline:2px solid var(--br-focus);outline-offset:2px;border-radius:var(--r-2)}.mono,.num{font-variant-numeric:tabular-nums}.num{font-feature-settings:\"tnum\" on,\"cv11\" on}.mono{font-family:var(--font-mono)}"}],"page":{"pagePath":"en/use-cases/kyc/create-validation","slug":"/en/use-cases/kyc/create-validation","pageMetadata":{"title":"Create KYC Validation","description":"Initiate a KYC verification session for a person entity — in the gu1 KYC API for identity verification flows, with examples for create validation use cases.","api":"POST /api/kyc/validations","href":"/en/use-cases/kyc/create-validation"},"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: \"Initiate a KYC verification session for a person entity — in the gu1 KYC API for identity verification flows, with examples for create validation use cases.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,Card,CardGroup,CodeBlock,CodeGroup,Heading,Info,Mermaid,Note,ParamField,ResponseField,Table,Warning}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Mermaid)_missingMdxReference(`Mermaid`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`overview`,children:`Overview`}),`\n`,_jsx(_components.p,{children:`This endpoint creates a new KYC validation session for a person entity using a configured integration provider. After creating the validation, you’ll receive a verification URL that you can share with your customer to complete identity verification.`}),`\n`,_jsx(Heading,{level:`2`,id:`complete-flow-diagram`,children:`Complete Flow Diagram`}),`\n`,_jsxs(_components.p,{children:[`Full sequence from entity creation to KYC validation (production flow; in sandbox with test document numbers the provider step is skipped and the API returns the mock result and webhooks immediately—see `,_jsx(_components.a,{href:`/en/use-cases/kyc/sandbox-mock-data`,children:`Sandbox mock data`}),`):`]}),`\n`,_jsx(Mermaid,{chart:`sequenceDiagram\n participant Client as Your Application\n participant API as gu1 API\n participant User as End User\n participant KYC as KYC Provider\n\n Note over Client,KYC: Step 1: Create Person Entity\n Client->>API: POST /api/entities\n Note right of Client: type, taxId, name, countryCode\n API-->>Client: 201 Created { entityId }\u003cbr/>or 409 if taxId already exists\n\n Note over Client,KYC: Step 2: Create KYC Validation\n Client->>API: POST /api/kyc/validations\n Note right of Client: entityId, integrationCode\n API->>KYC: Initialize verification session\n KYC-->>API: Session created\n API-->>Client: 201 Created\u003cbr/>{ id, providerSessionUrl, status: \"pending\" }\n\n Note over Client,KYC: Step 3: User Completes Verification\n Client->>User: Send providerSessionUrl\n User->>KYC: Opens URL, uploads document, selfie\n KYC->>KYC: Document + liveness + face match\n KYC->>API: Result (provider webhook or sync)\n API->>API: Update validation status\n\n Note over Client,KYC: Step 4: Webhook to Client\n API->>Client: POST your webhook URL\n Note right of API: event: kyc.validation_approved\u003cbr/>or kyc.validation_rejected\u003cbr/>payload: full validation\n\n Note over Client,KYC: Step 5: Optional – Query Status\n Client->>API: GET /api/kyc/validations/:id\n API-->>Client: 200 OK { status, ... }`}),`\n`,_jsxs(Accordion,{title:`Key Points in the Flow`,id:`key-points-in-the-flow`,children:[_jsx(_components.p,{children:_jsx(_components.strong,{children:`1. Entity and duplicate taxId`})}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Create the person entity first via `,_jsx(_components.code,{children:`POST /api/entities`}),` (with `,_jsx(_components.code,{children:`countryCode`}),`). If the `,_jsx(_components.code,{children:`taxId`}),` already exists in the organization, the API returns `,_jsx(_components.strong,{children:`409`}),` and does not create a duplicate; use the existing entity’s ID.`]}),`\n`,_jsxs(_components.li,{children:[`You need an existing `,_jsx(_components.code,{children:`entityId`}),` to create a KYC validation.`]}),`\n`]}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`2. Integration code`})}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`global_gueno_validation_kyc`}),` is the standard code for full KYC verification and works in sandbox with no extra setup.`]}),`\n`]}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`3. Verification URL`})}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`In production, the response includes `,_jsx(_components.code,{children:`providerSessionUrl`}),`. Send that URL to your user; they complete the flow on the provider’s hosted page (document + selfie). The URL is valid until `,_jsx(_components.code,{children:`expiresAt`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`In `,_jsx(_components.strong,{children:`sandbox`}),`, if the entity’s document number is in the `,_jsx(_components.a,{href:`/en/use-cases/kyc/sandbox-mock-data`,children:`test list`}),`, no provider session is used: the API returns 201 with `,_jsx(_components.code,{children:`pending`}),` status and `,_jsx(_components.strong,{children:`moments later`}),` updates the validation and sends webhooks (e.g. `,_jsx(_components.code,{children:`kyc.validation_approved`}),` or `,_jsx(_components.code,{children:`kyc.validation_rejected`}),`) with no user step. `,_jsx(_components.strong,{children:`Important:`}),` You must have a webhook endpoint configured to receive the responses - see `,_jsx(_components.a,{href:`/en/use-cases/kyc/sandbox-mock-data`,children:`Sandbox mock data`}),`.`]}),`\n`]}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`4. Webhook events`})}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`When the validation finishes, the API sends a webhook to your URL. The `,_jsx(_components.strong,{children:`event`}),` is one of: `,_jsx(_components.code,{children:`kyc.validation_approved`}),`, `,_jsx(_components.code,{children:`kyc.validation_rejected`}),`, `,_jsx(_components.code,{children:`kyc.validation_abandoned`}),`, `,_jsx(_components.code,{children:`kyc.validation_expired`}),`, `,_jsx(_components.code,{children:`kyc.validation_cancelled`}),` (not a single “completed” event). The payload is the full validation object.`]}),`\n`,_jsxs(_components.li,{children:[`You can also poll `,_jsx(_components.code,{children:`GET /api/kyc/validations/:id`}),` for status updates.`]}),`\n`]})]}),`\n`,_jsx(Heading,{level:`2`,id:`prerequisites`,children:`Prerequisites`}),`\n`,_jsx(_components.p,{children:`Before creating a KYC validation:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Person entity must exist`}),`: Create a person entity using the `,_jsx(_components.a,{href:`/api-reference/entities/create`,children:`Entities API`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`KYC integration configured`}),`: Your organization must have a KYC integration provider activated (e.g., `,_jsx(_components.code,{children:`global_gueno_validation_kyc`}),`)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Valid API key`}),`: Authenticate with your API key`]}),`\n`]}),`\n`,_jsxs(Info,{children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Sandbox vs Production`}),`: Sandbox environments do NOT require profile setup or pre-configuration. You can test KYC validations immediately in sandbox with test data. Production environments require:`]}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Completed organization onboarding`}),`\n`,_jsx(_components.li,{children:`KYC integration provider activated by gu1 team`}),`\n`,_jsx(_components.li,{children:`Sufficient credit balance for KYC operations`}),`\n`]}),_jsx(_components.p,{children:`To get started in sandbox, simply use your sandbox API key - no additional setup needed.`})]}),`\n`,_jsx(Heading,{level:`3`,id:`mock-data-sandbox`,children:`Mock Data (Sandbox)`}),`\n`,_jsxs(_components.p,{children:[`In sandbox, when the person entity’s document number (`,_jsx(_components.code,{children:`taxId`}),`) matches one of our `,_jsx(_components.strong,{children:`test values`}),`, the API returns an `,_jsx(_components.strong,{children:`immediate mock result`}),` (e.g. approved, rejected, cancelled) and sends the corresponding webhooks—no real verification is run. Document format does not matter (e.g. `,_jsx(_components.code,{children:`99.990.001`}),` and `,_jsx(_components.code,{children:`99990001`}),` both work).`]}),`\n`,_jsxs(_components.p,{children:[`For the full list of test document numbers by format (Argentina DNI/CUIT, Brazil CPF/CNPJ), expected outcomes, and example responses, see `,_jsx(_components.strong,{children:_jsx(_components.a,{href:`/en/use-cases/kyc/sandbox-mock-data`,children:`Sandbox mock data`})}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`important-behaviors`,children:`Important Behaviors`}),`\n`,_jsx(Heading,{level:`3`,id:`duplicate-taxid-post-/entities`,children:`Duplicate taxId (POST /entities)`}),`\n`,_jsxs(Warning,{children:[_jsxs(_components.p,{children:[`When you call `,_jsx(_components.strong,{children:`POST /api/entities`}),` with a `,_jsx(_components.code,{children:`taxId`}),` that `,_jsx(_components.strong,{children:`already exists`}),` in the same organization for the same entity type (person/company), the API `,_jsx(_components.strong,{children:`does not`}),` create a second entity. It returns `,_jsx(_components.strong,{children:`409 Conflict`}),` with error code `,_jsx(_components.code,{children:`DUPLICATE_TAX_ID`}),` and includes the existing entity’s `,_jsx(_components.code,{children:`id`}),`, `,_jsx(_components.code,{children:`name`}),`, and `,_jsx(_components.code,{children:`type`}),` in the response details.`]}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`What you should do:`})}),_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Option A – Check first`}),`: Use `,_jsx(_components.code,{children:`GET /api/entities?taxId=12345678`}),` (or the by-tax-id endpoint) before creating. If an entity exists, use its `,_jsx(_components.code,{children:`entityId`}),` for KYC.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Option B – Handle 409`}),`: If you get 409, read `,_jsx(_components.code,{children:`error.details.existingEntityId`}),` from the response and use that `,_jsx(_components.code,{children:`entityId`}),` for your KYC validation.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Reuse the same entity`}),`: Use one entity per person/company and create multiple KYC validations on that same `,_jsx(_components.code,{children:`entityId`}),` if you need re-verification or new attempts.`]}),`\n`]}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`Example – Check before create:`})}),_jsx(CodeBlock,{filename:``,numberOfLines:`20`,language:`javascript`,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:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`20`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// Check if entity exists`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` existing`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` fetch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'https://api.gu1.ai/api/entities?taxId=12345678'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` headers:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'Authorization'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Bearer YOUR_API_KEY'`}),_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`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` data`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` existing`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`json`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`();`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`let`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` entityId`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`if`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` (`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`data`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`data`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u0026\u0026`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` data`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`data`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:`length`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` >`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` entityId`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` data`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`data`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`[`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`].`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`id`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`; `}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// Use existing entity`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`} `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`else`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` createRes`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` fetch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'https://api.gu1.ai/api/entities'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` method:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'POST'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` headers:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'Authorization'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Bearer YOUR_API_KEY'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'Content-Type'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'application/json'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` body:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` JSON`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`stringify`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({ `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`type:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'person'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`taxId:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '12345678'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`name:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'John Doe'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`countryCode:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'AR'`}),_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`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` created`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` createRes`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`json`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`();`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` entityId`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` created`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`entity`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`?.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`id`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` ??`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` created`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`data`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`?.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`id`}),_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(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// Create KYC validation with the entityId`})}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`3`,id:`multiple-kyc-validations-per-entity`,children:`Multiple KYC Validations per Entity`}),`\n`,_jsxs(_components.p,{children:[`You `,_jsx(_components.strong,{children:`can`}),` create multiple KYC validations for the same entity:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Each validation gets a unique ID and session`}),`\n`,_jsxs(_components.li,{children:[`The newest validation is marked as `,_jsx(_components.code,{children:`isCurrent: true`}),` when created and keeps that reference while `,_jsx(_components.code,{children:`pending`}),`, `,_jsx(_components.code,{children:`in_progress`}),`, `,_jsx(_components.code,{children:`in_review`}),`, `,_jsx(_components.code,{children:`approved`}),`, `,_jsx(_components.code,{children:`rejected`}),`, `,_jsx(_components.code,{children:`expired`}),`, or `,_jsx(_components.code,{children:`abandoned`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`cancelled`}),` is the only exception: cancelling the current validation restores the most recent prior validation whose status is not `,_jsx(_components.code,{children:`cancelled`}),`, when one exists`]}),`\n`,_jsx(_components.li,{children:`Use cases: Re-verification, expired validations, failed attempts`}),`\n`,_jsxs(_components.li,{children:[`If the entity already has an `,_jsx(_components.strong,{children:`open`}),` validation (`,_jsx(_components.code,{children:`pending`}),`, `,_jsx(_components.code,{children:`in_progress`}),`, or `,_jsx(_components.code,{children:`in_review`}),`), create returns `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`409 VALIDATION_IN_PROGRESS`})}),` with `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`activeValidationId`})}),` — cancel that validation first, then create again`]}),`\n`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Additive contract:`}),` Existing clients that only read `,_jsx(_components.code,{children:`error`}),` and `,_jsx(_components.code,{children:`message`}),` are unchanged. `,_jsx(_components.code,{children:`activeValidationId`}),` is optional metadata on the 409 response to skip an extra lookup before cancel.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`request`,children:`Request`}),`\n`,_jsx(Heading,{level:`3`,id:`endpoint`,children:`Endpoint`}),`\n`,_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`POST https://api.gu1.ai/api/kyc/validations`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Heading,{level:`3`,id:`headers`,children:`Headers`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,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:`4`,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:` \"Authorization\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Bearer YOUR_API_KEY\"`}),_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:` \"Content-Type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"application/json\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`query-parameters-optional`,children:`Query Parameters (Optional)`}),`\n`,_jsxs(ParamField,{query:`doubleCheckRenaper`,type:`boolean`,id:`param-double-check-renaper`,children:[_jsxs(_components.p,{children:[`When `,_jsx(_components.code,{children:`true`}),`, enables RENAPER double-check for `,_jsx(_components.strong,{children:`Argentina`}),` entities. On `,_jsx(_components.strong,{children:`terminal`}),` statuses the API queries the official registry (data and, when applicable, biometrics) and stores results in metadata. `,_jsx(_components.strong,{children:`Only`}),` when `,_jsx(_components.strong,{children:`OCR KYC verification`}),` returns status `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`approved`})}),` can a cross-check failure automatically set the validation to `,_jsx(_components.code,{children:`rejected`}),`; on `,_jsx(_components.code,{children:`in_review`}),` or `,_jsx(_components.code,{children:`rejected`}),` the check is informational (`,_jsx(_components.code,{children:`enforcementApplied: false`}),`).`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Type`}),`: `,_jsx(_components.code,{children:`boolean`}),` (e.g. `,_jsx(_components.code,{children:`?doubleCheckRenaper=true`}),`)`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Requirements`}),`: Entity must be from Argentina (`,_jsx(_components.code,{children:`countryCode === 'AR'`}),`), and the organization must have RENAPER credentials configured in System Settings → Organizations → Config. If credentials are missing, the creation may fail or the double-check will be skipped depending on configuration.`]})]}),`\n`,_jsx(Heading,{level:`3`,id:`body-parameters`,children:`Body Parameters`}),`\n`,_jsxs(_components.p,{children:[`Provide `,_jsx(_components.strong,{children:`exactly one`}),` entity identifier:`]}),`\n`,_jsxs(ParamField,{body:`entityId`,type:`string`,id:`param-entity-id`,children:[_jsx(_components.p,{children:`The UUID of the person entity to verify`}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Type`}),`: `,_jsx(_components.code,{children:`string`}),` (uuid)`]})]}),`\n`,_jsx(ParamField,{body:`entityExternalId`,type:`string`,id:`param-entity-external-id`,children:_jsxs(_components.p,{children:[`Your external ID for the entity (`,_jsx(_components.code,{children:`entities.externalId`}),` in Gu1).`]})}),`\n`,_jsx(ParamField,{body:`entityTaxId`,type:`string`,id:`param-entity-tax-id`,children:_jsxs(_components.p,{children:[`Tax or document number. Gu1 resolves it with normalized match on `,_jsx(_components.code,{children:`entities.tax_id`}),`. The entity `,_jsx(_components.strong,{children:`must exist`}),` (404 if not found).`]})}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`In `,_jsx(_components.strong,{children:`sandbox`}),`, `,_jsx(_components.code,{children:`GET /api/entities/by-tax-id/{taxId}`}),` can return a synthetic preview for catalog test numbers (`,_jsx(_components.code,{children:`sandboxMock: true`}),`) without a DB row. `,_jsx(_components.strong,{children:`POST /validations`}),` still requires a real persisted entity.`]})}),`\n`,_jsxs(ParamField,{body:`integrationCode`,type:`string`,required:true,id:`param-integration-code`,children:[_jsx(_components.p,{children:`The integration provider code for KYC validation`}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Standard Value`}),`: `,_jsx(_components.code,{children:`global_gueno_validation_kyc`}),` (recommended for most use cases)`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Type`}),`: `,_jsx(_components.code,{children:`string`}),` (min length: 1)`]}),_jsxs(Note,{children:[_jsx(_components.p,{children:_jsx(_components.strong,{children:`What is integrationCode?`})}),_jsxs(_components.p,{children:[`The `,_jsx(_components.code,{children:`integrationCode`}),` identifies which KYC provider integration to use for verification. Think of it as selecting the verification service.`]}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`Available Integration Codes:`})}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`global_gueno_validation_kyc`}),` - `,_jsx(_components.strong,{children:`Recommended`}),` - Full KYC with document + selfie + face match + liveness`]}),`\n`,_jsx(_components.li,{children:`Custom codes may be configured for your organization (contact support)`}),`\n`]}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`How to find your integration code:`})}),_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Log in to `,_jsx(_components.a,{href:`https://app.gu1.ai`,children:`gu1 Dashboard`})]}),`\n`,_jsx(_components.li,{children:`Navigate to Settings → Integrations → KYC Providers`}),`\n`,_jsx(_components.li,{children:`Your active integration code will be listed there`}),`\n`]}),_jsxs(_components.p,{children:[`In `,_jsx(_components.strong,{children:`sandbox environments`}),`, `,_jsx(_components.code,{children:`global_gueno_validation_kyc`}),` works immediately with no configuration.`]})]})]}),`\n`,_jsx(ParamField,{body:`language`,type:`string`,id:`param-language`,children:_jsxs(_components.p,{children:[`Optional hosted verification UI language, for example `,_jsx(_components.code,{children:`es`}),`, `,_jsx(_components.code,{children:`en`}),`, or `,_jsx(_components.code,{children:`pt`}),`.\nThe request value takes precedence over the organization’s default KYC language.\nIf neither is configured, the hosted UI detects the language from the end-user device.`]})}),`\n`,_jsx(ParamField,{body:`doubleCheckRenaper`,type:`boolean`,id:`param-double-check-renaper-1`,children:_jsxs(_components.p,{children:[`Same as query param `,_jsx(_components.code,{children:`doubleCheckRenaper`}),`. When `,_jsx(_components.code,{children:`true`}),`, enables RENAPER double-check for Argentina. Can be sent in the body or as `,_jsx(_components.code,{children:`?doubleCheckRenaper=true`}),`. If both are present, the query param takes precedence.`]})}),`\n`,_jsxs(ParamField,{body:`omitWarnings`,type:`string[]`,id:`param-omit-warnings`,children:[_jsxs(_components.p,{children:[`Optional list of `,_jsx(_components.a,{href:`/en/use-cases/kyc/warning-risk-codes`,children:`KYC warning risk codes`}),` (exact strings). Stored on the validation as `,_jsx(_components.code,{children:`metadata.omitWarnings`}),`. After the session completes, if the validation would be `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`in_review`})}),`, `,_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`warnings`}),` is non-empty`]}),`, and `,_jsx(_components.strong,{children:`every`}),` code in `,_jsx(_components.code,{children:`warnings`}),` appears in this list, the API sets status to `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`approved`})}),` and keeps all warnings for display and audit. If `,_jsx(_components.strong,{children:`any`}),` warning is `,_jsx(_components.strong,{children:`not`}),` in `,_jsx(_components.code,{children:`omitWarnings`}),`, status stays `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`in_review`})}),`. If `,_jsx(_components.code,{children:`warnings`}),` is empty while status is `,_jsx(_components.code,{children:`in_review`}),`, this rule does `,_jsx(_components.strong,{children:`not`}),` auto-approve. Invalid or unknown codes in the request body return `,_jsx(_components.strong,{children:`400`}),`. When the rule applies, `,_jsx(_components.code,{children:`metadata.kycOmitWarningsApplied`}),` records the decision timestamp and matched warnings.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Non-omittable codes`}),` (e.g. `,_jsx(_components.code,{children:`GUENO_CROSS_ENTITY_DUPLICATED`}),`) are rejected in this field with `,_jsx(_components.strong,{children:`400`}),` and always block omit auto-approve even if present in `,_jsx(_components.code,{children:`warnings`}),`.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Type`}),`: `,_jsx(_components.code,{children:`string[]`}),` (each element must be an allowlisted code; duplicates are ignored)`]})]}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(Heading,{level:`3`,id:`success-response-201-created`,children:`Success Response (201 Created)`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`16`,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:`16`,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:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"550e8400-e29b-41d4-a716-446655440000\"`}),_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:` \"entityId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"123e4567-e89b-12d3-a456-426614174000\"`}),_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:` \"organizationId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"org_abc123\"`}),_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:` \"sessionId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"session_xyz789\"`}),_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:`\"pending\"`}),_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:` \"provider\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"kyc_provider\"`}),_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:` \"providerSessionUrl\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://verify.example.com/session_xyz789\"`}),_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:` \"isCurrent\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_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:` \"metadata\"`}),_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:` \"customField\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"customValue\"`}),_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:` \"doubleChecks\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"renaper\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_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`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"createdAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2025-01-15T10:30:00Z\"`}),_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:` \"updatedAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2025-01-15T10:30:00Z\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`When RENAPER double-check is enabled, `,_jsx(_components.code,{children:`metadata.doubleChecks.renaper`}),` is set to `,_jsx(_components.code,{children:`true`}),` at creation. After OCR KYC verification completes and the double-check runs, `,_jsx(_components.code,{children:`metadata.responseDoubleChecks.renaper`}),` is populated (see `,_jsx(_components.a,{href:`#renaper-double-check-argentina`,children:`RENAPER double-check`}),` below).`]}),`\n`,_jsx(Heading,{level:`3`,id:`response-fields`,children:`Response Fields`}),`\n`,_jsx(ResponseField,{name:`id`,type:`string`,id:`param-id`,children:_jsx(_components.p,{children:`Unique identifier for this KYC validation`})}),`\n`,_jsx(ResponseField,{name:`entityId`,type:`string`,id:`param-entity-id-1`,children:_jsx(_components.p,{children:`The person entity being verified`})}),`\n`,_jsx(ResponseField,{name:`organizationId`,type:`string`,id:`param-organization-id`,children:_jsx(_components.p,{children:`Your organization ID`})}),`\n`,_jsx(ResponseField,{name:`sessionId`,type:`string`,id:`param-session-id`,children:_jsx(_components.p,{children:`Identity verification session identifier`})}),`\n`,_jsxs(ResponseField,{name:`status`,type:`string`,id:`param-status`,children:[_jsx(_components.p,{children:`Current validation status. Possible values:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`pending`}),` - Validation created, waiting for customer to start`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`in_progress`}),` - Customer is completing verification (filling out form)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`in_review`}),` - Verification completed, requires manual review from compliance team`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`approved`}),` - Verification successful`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`rejected`}),` - Verification failed`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`expired`}),` - Verification session expired (e.g. after 7 days)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`abandoned`}),` - Customer started but didn’t complete`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`cancelled`}),` - Validation manually cancelled`]}),`\n`]})]}),`\n`,_jsx(ResponseField,{name:`provider`,type:`string`,id:`param-provider`,children:_jsx(_components.p,{children:`KYC provider name`})}),`\n`,_jsx(ResponseField,{name:`providerSessionUrl`,type:`string`,id:`param-provider-session-url`,children:_jsx(_components.p,{children:_jsx(_components.strong,{children:`The verification URL to share with your customer`})})}),`\n`,_jsx(ResponseField,{name:`isCurrent`,type:`boolean`,id:`param-is-current`,children:_jsx(_components.p,{children:`Whether this is the current active validation for the entity`})}),`\n`,_jsx(ResponseField,{name:`metadata`,type:`object`,id:`param-metadata`,children:_jsxs(_components.p,{children:[`Custom metadata. When RENAPER double-check is requested, includes `,_jsx(_components.code,{children:`doubleChecks: { renaper: true }`}),`. After approval and double-check execution, may include `,_jsx(_components.code,{children:`responseDoubleChecks.renaper`}),` (see RENAPER double-check section).`]})}),`\n`,_jsx(ResponseField,{name:`createdAt`,type:`string`,id:`param-created-at`,children:_jsx(_components.p,{children:`Timestamp when validation was created`})}),`\n`,_jsx(ResponseField,{name:`updatedAt`,type:`string`,id:`param-updated-at`,children:_jsx(_components.p,{children:`Timestamp of last update`})}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`After approval, media keys appear inside `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`decision`})}),`. To download files (images, video), use `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`GET /api/kyc/validations/:id/media?key=...`})}),` with `,_jsx(_components.code,{children:`Authorization: Bearer`}),`. Full details: `,_jsx(_components.a,{href:`/en/use-cases/kyc/validation-media`,children:`Get KYC validation media`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`example-request`,children:`Example Request`}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`Node.js`,numberOfLines:`14`,language:`javascript`,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:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`14`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` response`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` fetch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'https://api.gu1.ai/api/kyc/validations'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` method:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'POST'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` headers:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Authorization'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Bearer YOUR_API_KEY'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Content-Type'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'application/json'`}),_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`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` body:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` JSON`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`stringify`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` entityId:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '123e4567-e89b-12d3-a456-426614174000'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` integrationCode:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'global_gueno_validation_kyc'`})]}),`\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(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` validation`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` response`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`json`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`();`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'Verification URL:'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`validation`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`providerSessionUrl`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Python`,numberOfLines:`16`,language:`python`,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:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`16`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`response `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests.post(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'https://api.gu1.ai/api/kyc/validations'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` headers`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Authorization'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'Bearer YOUR_API_KEY'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Content-Type'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'application/json'`}),_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`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` json`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'entityId'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'123e4567-e89b-12d3-a456-426614174000'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'integrationCode'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'global_gueno_validation_kyc'`})]}),`\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(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`validation `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` response.json()`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`print`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'Verification URL:'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, validation[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'providerSessionUrl'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`])`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`8`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`curl -X POST https://api.gu1.ai/api/kyc/validations \\\\`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` -H \"Authorization: Bearer YOUR_API_KEY\" \\\\`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` -H \"Content-Type: application/json\" \\\\`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` -d '{`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` \"entityId\": \"123e4567-e89b-12d3-a456-426614174000\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` \"integrationCode\": \"global_gueno_validation_kyc\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` }'`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]}),`\n`,_jsx(Heading,{level:`2`,id:`error-responses`,children:`Error Responses`}),`\n`,_jsx(Heading,{level:`3`,id:`entity-not-found-404`,children:`Entity Not Found (404)`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,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:`4`,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:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ENTITY_NOT_FOUND\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Entity not found\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`invalid-entity-type-400`,children:`Invalid Entity Type (400)`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,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:`4`,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:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"INVALID_ENTITY_TYPE\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"KYC validation is only available for person entities\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`kyc-not-configured-400`,children:`KYC Not Configured (400)`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,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:`4`,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:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"KYC_NOT_CONFIGURED\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"KYC integration is not configured for this organization. Please contact your administrator.\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`validation-in-progress-409`,children:`Validation In Progress (409)`}),`\n`,_jsxs(_components.p,{children:[`When the entity already has an open validation (`,_jsx(_components.code,{children:`pending`}),`, `,_jsx(_components.code,{children:`in_progress`}),`, or `,_jsx(_components.code,{children:`in_review`}),`), Gu1 syncs with the hosted capture session when possible, then rejects a second create:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,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:`5`,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:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"VALIDATION_IN_PROGRESS\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Cannot create new KYC validation. There is already a pending validation for this entity. Please cancel or complete the existing validation first.\"`}),_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:` \"activeValidationId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"7618e10c-b1b1-408b-b361-1901077ced73\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Recovery:`}),` `,_jsx(_components.code,{children:`409`}),` → `,_jsx(_components.code,{children:`DELETE /api/kyc/validations/{activeValidationId}/cancel`}),` → one new `,_jsx(_components.code,{children:`POST /api/kyc/validations`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Terminal validations (`,_jsx(_components.code,{children:`approved`}),`, `,_jsx(_components.code,{children:`rejected`}),`, `,_jsx(_components.code,{children:`cancelled`}),`, `,_jsx(_components.code,{children:`expired`}),`, `,_jsx(_components.code,{children:`abandoned`}),`) do `,_jsx(_components.strong,{children:`not`}),` block creating a new one.`]}),`\n`,_jsx(Heading,{level:`2`,id:`renaper-double-check-argentina`,children:`RENAPER Double-Check (Argentina)`}),`\n`,_jsxs(_components.p,{children:[`When `,_jsx(_components.code,{children:`doubleCheckRenaper`}),` is `,_jsx(_components.code,{children:`true`}),` and the entity is from Argentina, on each `,_jsx(_components.strong,{children:`terminal`}),` status (`,_jsx(_components.code,{children:`approved`}),`, `,_jsx(_components.code,{children:`rejected`}),`, `,_jsx(_components.code,{children:`in_review`}),`) the API runs a cross-check against the official Argentine registry (RENAPER) when sufficient OCR data exists. Automatic rejection by RENAPER `,_jsx(_components.strong,{children:`only`}),` applies when `,_jsx(_components.strong,{children:`OCR KYC verification`}),` returned status `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`approved`})}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`how-to-send-it`,children:`How to Send It`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Body`}),`: `,_jsx(_components.code,{children:`{ \"entityId\": \"...\", \"integrationCode\": \"...\", \"doubleCheckRenaper\": true }`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Query`}),`: `,_jsx(_components.code,{children:`POST /api/kyc/validations?doubleCheckRenaper=true`}),` with the same body (without the field). Query param overrides body if both are present.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`when-it-runs`,children:`When It Runs`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Validation is created with `,_jsx(_components.code,{children:`metadata.doubleChecks.renaper: true`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`User completes verification; OCR KYC verification returns a `,_jsx(_components.strong,{children:`terminal`}),` status.`]}),`\n`,_jsxs(_components.li,{children:[`API calls RENAPER (data + biometrics when applicable) and stores `,_jsx(_components.code,{children:`comparisonResults`}),` in metadata.`]}),`\n`,_jsxs(_components.li,{children:[`If status is `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`approved`})}),` and the cross-check fails → validation becomes `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`rejected`})}),`.`]}),`\n`,_jsxs(_components.li,{children:[`If status is `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`in_review`})}),` or `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`rejected`})}),` → results are informational; mismatch codes are `,_jsx(_components.strong,{children:`added`}),` to `,_jsx(_components.code,{children:`warnings`}),` without replacing OCR verification warnings.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Manual approve`}),` from `,_jsx(_components.code,{children:`in_review`}),` does `,_jsx(_components.strong,{children:`not`}),` re-run RENAPER; the human decision stands on the data already shown in review.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`where-the-result-is-stored`,children:`Where the Result Is Stored`}),`\n`,_jsxs(_components.p,{children:[`All RENAPER double-check results are stored in `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`metadata.responseDoubleChecks.renaper`})}),`. Mismatch `,_jsx(_components.strong,{children:`codes`}),` are `,_jsx(_components.strong,{children:`added`}),` to `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`metadata.warnings`})}),` alongside OCR KYC verification warnings. `,_jsx(_components.code,{children:`errorCode`}),` on the `,_jsx(_components.code,{children:`renaper`}),` object keeps the first failure for compatibility; UIs can list every code from `,_jsx(_components.code,{children:`comparisonResults`}),` and `,_jsx(_components.code,{children:`warnings`}),`.`]}),`\n`,_jsx(_components.p,{children:_jsxs(_components.strong,{children:[`Shape of `,_jsx(_components.code,{children:`metadata.responseDoubleChecks.renaper`}),`:`]})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`verified`})}),_jsx(_components.td,{children:`boolean`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`true`}),` if the double-check passed.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`matchResult`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`\"match\"`}),` | `,_jsx(_components.code,{children:`\"mismatch\"`}),` | `,_jsx(_components.code,{children:`\"error\"`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`verifiedAt`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`ISO timestamp when the check was run.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`personalNumber`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Transaction number from KYC (normalized).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`idTramitePrincipal`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Transaction number from RENAPER.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`renaperData`})}),_jsx(_components.td,{children:`object`}),_jsxs(_components.td,{children:[`Raw RENAPER API response (see `,_jsxs(_components.a,{href:`#renaperdata-shape`,children:[_jsx(_components.code,{children:`renaperData`}),` shape`]}),`).`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`comparisonResults`})}),_jsx(_components.td,{children:`object`}),_jsx(_components.td,{children:`Per-field OCR vs registry comparison (when applicable).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`renaperBiometric`})}),_jsx(_components.td,{children:`object`}),_jsxs(_components.td,{children:[`ABIS biometric result (`,_jsx(_components.code,{children:`validate-dni`}),`): `,_jsx(_components.code,{children:`matchResult`}),`, `,_jsx(_components.code,{children:`score`}),`, `,_jsx(_components.code,{children:`renaperData`}),` (raw response).`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`errorCode`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Present when failed; see error codes below.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`error`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`Optional legacy message; prefer using `,_jsx(_components.code,{children:`errorCode`}),` and translating in your UI.`]})]})]})]}),`\n`,_jsxs(Heading,{level:`3`,id:`renaperdata-shape`,children:[_jsx(_components.code,{children:`renaperData`}),` shape`]}),`\n`,_jsxs(_components.p,{children:[`This is the `,_jsx(_components.strong,{children:`unmodified body`}),` returned by the registry via ms-providers (`,_jsx(_components.code,{children:`POST …/provider-records/renaper/data`}),`). Gu1 forwards it as-is in `,_jsx(_components.code,{children:`metadata.responseDoubleChecks.renaper.renaperData`}),`. Field names use `,_jsx(_components.strong,{children:`snake_case`}),`; all fields are optional depending on what RENAPER returns for each lookup.`]}),`\n`,_jsx(_components.p,{children:_jsxs(_components.strong,{children:[`Example (successful double-check, `,_jsx(_components.code,{children:`matchResult: \"match\"`}),`):`]})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`29`,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:`29`,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:` \"id_tramite_principal\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"987654321\"`}),_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:` \"id_tramite_tarjeta_reimpresa\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"112233445\"`}),_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:` \"ejemplar\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"A\"`}),_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:` \"vencimiento\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2030-05-20\"`}),_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:` \"emision\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2015-05-20\"`}),_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:` \"apellido\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"García\"`}),_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:` \"nombres\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Juan\"`}),_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:` \"fecha_nacimiento\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1990-01-15\"`}),_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:` \"cuil\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"20-30123456-9\"`}),_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:` \"calle\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Av. Corrientes\"`}),_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:` \"numero\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1234\"`}),_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:` \"piso\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"5\"`}),_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:` \"departamento\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"B\"`}),_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:` \"codigo_postal\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1043\"`}),_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:` \"barrio\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"San Nicolás\"`}),_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:` \"monoblock\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},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:` \"ciudad\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Ciudad Autónoma de Buenos Aires\"`}),_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:` \"municipio\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Comuna 1\"`}),_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:` \"provincia\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Buenos Aires\"`}),_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:` \"pais\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Argentina\"`}),_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:` \"nacionalidad\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Argentina\"`}),_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:` \"codigo_fallecido\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},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:` \"mensaje_fallecido\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},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:` \"fecha_fallecimiento\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},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:` \"id_ciudadano\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"30123456\"`}),_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:` \"codigo\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},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:` \"mensaje\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Other common cases:`})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Situation`}),_jsxs(_components.th,{children:[`Typical `,_jsx(_components.code,{children:`renaperData`})]})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`Error before registry data (e.g. `,_jsx(_components.code,{children:`RENAPER_DNI_MISSING`}),`)`]}),_jsx(_components.td,{children:_jsx(_components.code,{children:`{}`})})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`Service unavailable (`,_jsx(_components.code,{children:`RENAPER_VERIFICATION_UNAVAILABLE`}),`)`]}),_jsx(_components.td,{children:_jsx(_components.code,{children:`{ \"error\": \"…\", \"code\": \"SERVICE_UNAVAILABLE\" }`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Failed cross-check with partial registry payload`}),_jsxs(_components.td,{children:[`Subset of fields (e.g. `,_jsx(_components.code,{children:`id_tramite_principal`}),`, `,_jsx(_components.code,{children:`apellido`}),`, `,_jsx(_components.code,{children:`nombres`}),`, `,_jsx(_components.code,{children:`fecha_nacimiento`}),`)`]})]})]})]}),`\n`,_jsxs(_components.p,{children:[`In sandbox, the same mock values appear in `,_jsx(_components.a,{href:`/en/use-cases/kyc/sandbox-mock-data#example-response-mock-approved`,children:`KYC sandbox mock data`}),`.`]}),`\n`,_jsxs(Heading,{level:`3`,id:`comparisonresults-shape`,children:[_jsx(_components.code,{children:`comparisonResults`}),` shape`]}),`\n`,_jsxs(_components.p,{children:[`Per-field map (`,_jsx(_components.code,{children:`dni`}),`, `,_jsx(_components.code,{children:`tramite`}),`, `,_jsx(_components.code,{children:`name`}),`, `,_jsx(_components.code,{children:`ejemplar`}),`, `,_jsx(_components.code,{children:`dateOfBirth`}),`, `,_jsx(_components.code,{children:`expirationDate`}),`). Each entry may include:`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`compared`})}),_jsx(_components.td,{children:`boolean`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`true`}),` if comparison was attempted; `,_jsx(_components.code,{children:`false`}),` if skipped due to missing data.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`passed`})}),_jsx(_components.td,{children:`boolean`}),_jsxs(_components.td,{children:[`Outcome when `,_jsx(_components.code,{children:`compared`}),` is `,_jsx(_components.code,{children:`true`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`skipReason`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`ocr_missing`}),`, `,_jsx(_components.code,{children:`renaper_missing`}),`, or `,_jsx(_components.code,{children:`both_missing`}),` when not compared.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ocrValue`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`OCR-extracted value (when applicable).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`renaperValue`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Registry value from RENAPER (when applicable).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`similarityPercent`})}),_jsx(_components.td,{children:`number`}),_jsxs(_components.td,{children:[`For `,_jsx(_components.code,{children:`name`}),` only: Levenshtein similarity (0–100).`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`threshold`})}),_jsx(_components.td,{children:`number`}),_jsxs(_components.td,{children:[`For `,_jsx(_components.code,{children:`name`}),` only: applied threshold (e.g. 80).`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`errorCode`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`Field failure code (e.g. `,_jsx(_components.code,{children:`RENAPER_DNI_NOT_MATCH`}),`).`]})]})]})]}),`\n`,_jsxs(_components.p,{children:[`For `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`ejemplar`})}),`, the OCR value is `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`extractedData.ejemplar`})}),` (see `,_jsx(_components.a,{href:`/en/use-cases/kyc/id-verification#extracteddata-fields`,children:`extractedData fields`}),`). Comparison runs when both OCR and RENAPER values exist.`]}),`\n`,_jsx(_components.p,{children:_jsxs(_components.strong,{children:[`Example — `,_jsx(_components.code,{children:`extractedData`}),` on an approved KYC validation (Argentina):`]})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`9`,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:`9`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"extractedData\"`}),_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:` \"documentNumber\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"38966181\"`}),_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:` \"personalNumber\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"00460759387\"`}),_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:` \"taxNumber\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"20389661814\"`}),_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:` \"ejemplar\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"C\"`}),_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:` \"dateOfBirth\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1995-05-22\"`}),_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:` \"expirationDate\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2031-10-17\"`}),_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:` \"nationality\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ARG\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(Heading,{level:`3`,id:`renaperbiometric-shape`,children:[_jsx(_components.code,{children:`renaperBiometric`}),` shape`]}),`\n`,_jsxs(_components.p,{children:[`Nested under `,_jsx(_components.code,{children:`metadata.responseDoubleChecks.renaper.renaperBiometric`}),` when the org has biometric credentials and the KYC session provides a selfie. Gu1 sends `,_jsx(_components.strong,{children:`one selfie`}),` to `,_jsx(_components.code,{children:`validate-dni`}),`; RENAPER compares it to the ID photo on file.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`verified`})}),_jsx(_components.td,{children:`boolean`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`true`}),` when the ABIS biometric check returns `,_jsx(_components.code,{children:`resultado.match`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`matchResult`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`\"match\"`}),` | `,_jsx(_components.code,{children:`\"mismatch\"`}),` | `,_jsx(_components.code,{children:`\"error\"`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`score`})}),_jsx(_components.td,{children:`number`}),_jsx(_components.td,{children:`Score from the biometric check (when present).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`verifiedAt`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`ISO timestamp of the biometric check.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`renaperData`})}),_jsx(_components.td,{children:`object`}),_jsxs(_components.td,{children:[`Raw `,_jsx(_components.code,{children:`validate-dni`}),` response (includes `,_jsx(_components.code,{children:`resultado.match`}),`, `,_jsx(_components.code,{children:`resultado.score`}),`, etc.).`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`submittedSelfieRef`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`Reference of the selfie sent: storage path (`,_jsx(_components.code,{children:`kyc/...`}),`) or URL (`,_jsx(_components.code,{children:`https://...`}),`).`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`submittedSelfieRefKind`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`Format of `,_jsx(_components.code,{children:`submittedSelfieRef`}),`: `,_jsx(_components.code,{children:`s3_key`}),` (internal path) | `,_jsx(_components.code,{children:`url`}),` (public URL).`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`submittedSelfiePickedFrom`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`Source in `,_jsx(_components.code,{children:`decision`}),`: `,_jsx(_components.code,{children:`liveness_reference_image`}),` or `,_jsx(_components.code,{children:`face_match_target_image`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`errorCode`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`On failure (e.g. `,_jsx(_components.code,{children:`RENAPER_BIOMETRIC_NOT_MATCH`}),`).`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`skipReason`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`When not run (e.g. selfie unavailable).`})]})]})]}),`\n`,_jsxs(Heading,{level:`3`,id:`full-responsedoublechecks-renaper-example`,children:[`Full `,_jsx(_components.code,{children:`responseDoubleChecks.renaper`}),` example`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`70`,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:`70`,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:` \"verified\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_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:` \"matchResult\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"match\"`}),_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:` \"personalNumber\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"00123456789\"`}),_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:` \"idTramitePrincipal\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"987654321\"`}),_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:` \"verifiedAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-06-05T14:30:00.000Z\"`}),_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:` \"enforcementApplied\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_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:` \"renaperData\"`}),_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:` \"id_tramite_principal\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"987654321\"`}),_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:` \"apellido\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"García\"`}),_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:` \"nombres\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Juan\"`}),_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:` \"fecha_nacimiento\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1990-01-15\"`}),_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:` \"ejemplar\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"A\"`}),_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:` \"vencimiento\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2030-05-20\"`})]}),`\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:` \"comparisonResults\"`}),_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:` \"dni\"`}),_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:` \"field\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"dni\"`}),_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:` \"compared\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_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:` \"passed\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_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:` \"ocrValue\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"30123456\"`}),_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:` \"renaperValue\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"30123456\"`})]}),`\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:` \"tramite\"`}),_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:` \"field\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"tramite\"`}),_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:` \"compared\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_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:` \"passed\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_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:` \"ocrValue\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"00123456789\"`}),_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:` \"renaperValue\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"987654321\"`})]}),`\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:` \"name\"`}),_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:` \"field\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"name\"`}),_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:` \"compared\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_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:` \"passed\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_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:` \"ocrValue\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Juan García\"`}),_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:` \"renaperValue\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"García Juan\"`}),_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:` \"similarityPercent\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`92`}),_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:` \"threshold\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`80`})]}),`\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:` \"ejemplar\"`}),_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:` \"field\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ejemplar\"`}),_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:` \"compared\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_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:` \"passed\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_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:` \"ocrValue\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"A\"`}),_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:` \"renaperValue\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"A\"`})]}),`\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:` \"dateOfBirth\"`}),_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:` \"field\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"dateOfBirth\"`}),_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:` \"compared\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_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:` \"passed\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_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:` \"ocrValue\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1990-01-15\"`}),_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:` \"renaperValue\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1990-01-15\"`})]}),`\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`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"renaperBiometric\"`}),_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:` \"verified\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_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:` \"matchResult\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"match\"`}),_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:` \"score\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0.91`}),_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:` \"verifiedAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-06-05T14:30:02.000Z\"`}),_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:` \"submittedSelfieRef\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"kyc/org-id/entity-id/session-id/selfie.jpg\"`}),_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:` \"submittedSelfieRefKind\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"s3_key\"`}),_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:` \"submittedSelfiePickedFrom\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"liveness_reference_image\"`}),_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:` \"renaperData\"`}),_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:` \"resultado\"`}),_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:` \"match\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_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:` \"score\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0.91`})]}),`\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(_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`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`renaperBiometric`}),` and `,_jsx(_components.code,{children:`comparisonResults`}),` entries may be omitted depending on credentials, OCR data, or selfie availability.`]}),`\n`,_jsx(Heading,{level:`3`,id:`error-codes-when-renaper-fails`,children:`Error Codes (When RENAPER Fails)`}),`\n`,_jsxs(_components.p,{children:[`When the double-check fails, `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`metadata.warnings`})}),` contains one of the following `,_jsx(_components.strong,{children:`codes`}),` (and `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`metadata.responseDoubleChecks.renaper.errorCode`})}),` is set to the same value). Your UI should translate these codes into user-facing messages.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Code`}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`RENAPER_DNI_MISSING`})}),_jsx(_components.td,{children:`No document number (DNI) was obtained from the KYC verification.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`RENAPER_GENDER_MISSING`})}),_jsx(_components.td,{children:`Gender (M/F) is required to call RENAPER and was not available.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`RENAPER_VERIFICATION_UNAVAILABLE`})}),_jsx(_components.td,{children:`Could not complete the cross-check with the registry (e.g. network/API error). Retry later.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`RENAPER_DNI_NOT_MATCH`})}),_jsx(_components.td,{children:`The document number from the verification does not match the official registry.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`RENAPER_TRAMITE_DATA_MISSING`})}),_jsx(_components.td,{children:`Transaction number could not be compared (missing from KYC or RENAPER response).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`RENAPER_TRAMITE_ID_NOT_MATCH`})}),_jsxs(_components.td,{children:[`The document `,_jsx(_components.strong,{children:`transaction number`}),` does not match the registry. Common when the person used an older copy of the ID, the document is expired, or it was reissued; they should verify again with their current, valid ID.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`RENAPER_NAME_NOT_MATCH`})}),_jsx(_components.td,{children:`OCR name is below the 80% similarity threshold vs the RENAPER registry.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`RENAPER_EJEMPLAR_NOT_MATCH`})}),_jsx(_components.td,{children:`ID copy letter (ejemplar) does not match the RENAPER registry.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`RENAPER_DOB_NOT_MATCH`})}),_jsx(_components.td,{children:`OCR date of birth does not match the RENAPER registry.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`RENAPER_EXPIRY_NOT_MATCH`})}),_jsx(_components.td,{children:`OCR expiration date does not match the RENAPER registry.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`RENAPER_BIOMETRIC_NOT_MATCH`})}),_jsx(_components.td,{children:`Selfie does not match the ID photo in the biometric registry.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`RENAPER_BIOMETRIC_UNAVAILABLE`})}),_jsx(_components.td,{children:`Biometric check could not be completed (network, credentials, or service).`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`when-renaper-enforcement-applies-automatic-rejection`,children:`When RENAPER enforcement applies (automatic rejection)`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`OCR KYC verification status`}),_jsx(_components.th,{children:`RENAPER runs?`}),_jsx(_components.th,{children:`Can RENAPER reject?`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:_jsx(_components.code,{children:`approved`})}),` (direct approval)`]}),_jsx(_components.td,{children:`Yes`}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Yes`}),` — cross-check failure → `,_jsx(_components.code,{children:`rejected`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:_jsx(_components.code,{children:`in_review`})})}),_jsx(_components.td,{children:`Yes`}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`No`}),` — informational; compliance decides via manual review`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:_jsx(_components.code,{children:`rejected`})}),` (OCR verification or Gu1 rules)`]}),_jsx(_components.td,{children:`Yes (if OCR available)`}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`No`}),` — informational; registry data kept in metadata`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Manual approve`}),` from `,_jsx(_components.code,{children:`in_review`}),` (`,_jsx(_components.a,{href:`/en/use-cases/kyc/approve-validation`,children:_jsx(_components.code,{children:`POST …/approve`})}),`)`]}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`No`}),` (reuses stored check)`]}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`No`}),` — human decision`]})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`why-the-validation-may-be-rejected`,children:`Why the validation may be rejected`}),`\n`,_jsxs(_components.p,{children:[`RENAPER can change `,_jsx(_components.strong,{children:`status`}),` to `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`rejected`})}),` only on the `,_jsxs(_components.strong,{children:[`direct `,_jsx(_components.code,{children:`approved`})]}),` path. On `,_jsx(_components.code,{children:`in_review`}),` / `,_jsx(_components.code,{children:`rejected`}),` / manual approve, failures appear as `,_jsx(_components.strong,{children:`codes`}),` in `,_jsx(_components.code,{children:`metadata.warnings`}),` and in `,_jsx(_components.code,{children:`metadata.responseDoubleChecks.renaper`}),` without auto-rejection. Use the table above and translation keys (e.g. `,_jsx(_components.code,{children:`kyc.rejectionReasonCodes.*`}),`).`]}),`\n`,_jsx(Heading,{level:`2`,id:`next-steps`,children:`Next Steps`}),`\n`,_jsx(_components.p,{children:`After creating a validation:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Extract the verification URL`}),` from `,_jsx(_components.code,{children:`providerSessionUrl`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Share the URL with your customer`}),` via email, SMS, or in-app`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Set up webhook endpoint`}),` to receive completion notifications`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Monitor validation status`}),` using the validation ID`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`After approval`}),`, read media keys from `,_jsx(_components.code,{children:`decision`}),` and download files — see `,_jsx(_components.a,{href:`/en/use-cases/kyc/validation-media`,children:`Get KYC validation media`})]}),`\n`]}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Get KYC URL`,icon:`link`,href:`/en/use-cases/kyc/get-kyc-url`,children:_jsx(_components.p,{children:`Learn how to retrieve the URL`})}),_jsx(Card,{title:`Webhook Integration`,icon:`webhook`,href:`/en/use-cases/kyc/webhook-integration`,children:_jsx(_components.p,{children:`Configure webhook notifications`})})]})]})}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":"Create KYC Validation","description":"Initiate a KYC verification session for a person entity — in the gu1 KYC API for identity verification flows, with examples for create validation use cases.","api":"POST /api/kyc/validations","href":"/en/use-cases/kyc/create-validation"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Overview","slug":"overview","depth":2,"children":[]},{"title":"Complete Flow Diagram","slug":"complete-flow-diagram","depth":2,"children":[]},{"title":"Prerequisites","slug":"prerequisites","depth":2,"children":[{"title":"Mock Data (Sandbox)","slug":"mock-data-sandbox","depth":3,"children":[]}]},{"title":"Important Behaviors","slug":"important-behaviors","depth":2,"children":[{"title":"Duplicate taxId (POST /entities)","slug":"duplicate-taxid-post-/entities","depth":3,"children":[]},{"title":"Multiple KYC Validations per Entity","slug":"multiple-kyc-validations-per-entity","depth":3,"children":[]}]},{"title":"Request","slug":"request","depth":2,"children":[{"title":"Endpoint","slug":"endpoint","depth":3,"children":[]},{"title":"Headers","slug":"headers","depth":3,"children":[]},{"title":"Query Parameters (Optional)","slug":"query-parameters-optional","depth":3,"children":[]},{"title":"Body Parameters","slug":"body-parameters","depth":3,"children":[]}]},{"title":"Response","slug":"response","depth":2,"children":[{"title":"Success Response (201 Created)","slug":"success-response-201-created","depth":3,"children":[]},{"title":"Response Fields","slug":"response-fields","depth":3,"children":[]}]},{"title":"Example Request","slug":"example-request","depth":2,"children":[]},{"title":"Error Responses","slug":"error-responses","depth":2,"children":[{"title":"Entity Not Found (404)","slug":"entity-not-found-404","depth":3,"children":[]},{"title":"Invalid Entity Type (400)","slug":"invalid-entity-type-400","depth":3,"children":[]},{"title":"KYC Not Configured (400)","slug":"kyc-not-configured-400","depth":3,"children":[]},{"title":"Validation In Progress (409)","slug":"validation-in-progress-409","depth":3,"children":[]}]},{"title":"RENAPER Double-Check (Argentina)","slug":"renaper-double-check-argentina","depth":2,"children":[{"title":"How to Send It","slug":"how-to-send-it","depth":3,"children":[]},{"title":"When It Runs","slug":"when-it-runs","depth":3,"children":[]},{"title":"Where the Result Is Stored","slug":"where-the-result-is-stored","depth":3,"children":[]},{"title":"renaperData shape","slug":"renaperdata-shape","depth":3,"children":[]},{"title":"comparisonResults shape","slug":"comparisonresults-shape","depth":3,"children":[]},{"title":"renaperBiometric shape","slug":"renaperbiometric-shape","depth":3,"children":[]},{"title":"Full responseDoubleChecks.renaper example","slug":"full-responsedoublechecks-renaper-example","depth":3,"children":[]},{"title":"Error Codes (When RENAPER Fails)","slug":"error-codes-when-renaper-fails","depth":3,"children":[]},{"title":"When RENAPER enforcement applies (automatic rejection)","slug":"when-renaper-enforcement-applies-automatic-rejection","depth":3,"children":[]},{"title":"Why the validation may be rejected","slug":"why-the-validation-may-be-rejected","depth":3,"children":[]}]},{"title":"Next Steps","slug":"next-steps","depth":2,"children":[]}],"codeExamples":{},"endpoint":{"title":"Create KYC Validation","path":"/api/kyc/validations","servers":[{"url":"http://api.gu1.ai"}],"method":"post","request":{"security":[{"title":"Bearer Auth","parameters":{"header":{"Authorization":{"type":"http","scheme":"bearer","description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token."}},"query":{},"cookie":{}}}],"parameters":{"query":{"doubleCheckRenaper":{"schema":[{"type":"boolean","description":"When `true` , enables RENAPER double-check for Argentina entities. On terminal statuses the API queries the official registry (data and, when applicable, biometrics) and stores results in metadata. Only when OCR KYC verification returns status `approved` can a cross-check failure automatically set the validation to `rejected` ; on `in_review` or `rejected` the check is informational ( `enforcementApplied: false` ). Type : `boolean` (e.g. `?doubleCheckRenaper=true` ) Requirements : Entity must be from Argentina ( `countryCode === 'AR'` ), and the organization must have RENAPER credentials configured in System Settings → Organizations → Config. If credentials are missing, the creation may fail or the double-check will be skipped depending on configuration."}]}},"header":{},"cookie":{},"path":{}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"entityId":[{"type":"string","description":"The UUID of the person entity to verify Type : `string` (uuid)"}],"entityExternalId":[{"type":"string","description":"Your external ID for the entity ( `entities.externalId` in Gu1)."}],"entityTaxId":[{"type":"string","description":"Tax or document number. Gu1 resolves it with normalized match on `entities.tax_id` . The entity must exist (404 if not found)."}],"integrationCode":[{"type":"string","description":"The integration provider code for KYC validation Standard Value : `global_gueno_validation_kyc` (recommended for most use cases) Type : `string` (min length: 1)","required":true}],"language":[{"type":"string","description":"Optional hosted verification UI language, for example `es` , `en` , or `pt` . The request value takes precedence over the organization’s default KYC language. If neither is configured, the hosted UI detects the language from the end-user device."}],"doubleCheckRenaper":[{"type":"boolean","description":"Same as query param `doubleCheckRenaper` . When `true` , enables RENAPER double-check for Argentina. Can be sent in the body or as `?doubleCheckRenaper=true` . If both are present, the query param takes precedence."}],"omitWarnings":[{"type":"array","items":[{"type":"string"}],"description":"Optional list of KYC warning risk codes (exact strings). Stored on the validation as `metadata.omitWarnings` . After the session completes, if the validation would be `in_review` , `warnings` is non-empty , and every code in `warnings` appears in this list, the API sets status to `approved` and keeps all warnings for display and audit. If any warning is not in `omitWarnings` , status stays `in_review` . If `warnings` is empty while status is `in_review` , this rule does not auto-approve. Invalid or unknown codes in the request body return 400 . When the rule applies, `metadata.kycOmitWarningsApplied` records the decision timestamp and matched warnings. Non-omittable codes (e.g. `GUENO_CROSS_ENTITY_DUPLICATED` ) are rejected in this field with 400 and always block omit auto-approve even if present in `warnings` . Type : `string[]` (each element must be an allowlisted code; duplicates are ignored)"}]}}],"examples":{"example":{"value":{"entityId":"\u003cstring>","entityExternalId":"\u003cstring>","entityTaxId":"\u003cstring>","integrationCode":"\u003cstring>","language":"\u003cstring>","doubleCheckRenaper":true,"omitWarnings":["\u003cstring>"]}}}}}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"id":[{"type":"string","description":"Unique identifier for this KYC validation"}],"entityId":[{"type":"string","description":"The person entity being verified"}],"organizationId":[{"type":"string","description":"Your organization ID"}],"sessionId":[{"type":"string","description":"Identity verification session identifier"}],"status":[{"type":"string","description":"Current validation status. Possible values: `pending` - Validation created, waiting for customer to start `in_progress` - Customer is completing verification (filling out form) `in_review` - Verification completed, requires manual review from compliance team `approved` - Verification successful `rejected` - Verification failed `expired` - Verification session expired (e.g. after 7 days) `abandoned` - Customer started but didn’t complete `cancelled` - Validation manually cancelled"}],"provider":[{"type":"string","description":"KYC provider name"}],"providerSessionUrl":[{"type":"string","description":"The verification URL to share with your customer"}],"isCurrent":[{"type":"boolean","description":"Whether this is the current active validation for the entity"}],"metadata":[{"type":"object","properties":{},"description":"Custom metadata. When RENAPER double-check is requested, includes `doubleChecks: { renaper: true }` . After approval and double-check execution, may include `responseDoubleChecks.renaper` (see RENAPER double-check section)."}],"createdAt":[{"type":"string","description":"Timestamp when validation was created"}],"updatedAt":[{"type":"string","description":"Timestamp of last update"}]}}],"examples":{"example":{"value":{"id":"\u003cstring>","entityId":"\u003cstring>","organizationId":"\u003cstring>","sessionId":"\u003cstring>","status":"\u003cstring>","provider":"\u003cstring>","providerSessionUrl":"\u003cstring>","isCurrent":true,"metadata":{},"createdAt":"\u003cstring>","updatedAt":"\u003cstring>"}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"geno-f35946c5","siteName":"gu1","title":"Create KYC Validation - gu1","navMaps":{"firstHrefInVersion":{"🇺🇸 EN":{"href":"/en/use-cases/kyc/create-validation","matchLevel":0},"🇪🇸 ES":{"href":"/es/use-cases/kyc/create-validation","matchLevel":1},"🇧🇷 PT":{"href":"/pt/use-cases/kyc/create-validation","matchLevel":1}},"firstHrefInLanguage":{}},"lastModified":"2026-09-18T16:16:50.900Z","originalFileLocation":"en/use-cases/kyc/create-validation.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Initiate a KYC verification session for a person entity — in the gu1 KYC API for identity verification flows, with examples for create validation use cases.\">\u003cmeta data-mint-head name=\"application-name\" content=\"gu1\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/geno-f35946c5/72Ha_ftD-G4ZiDGf/_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/geno-f35946c5/72Ha_ftD-G4ZiDGf/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/geno-f35946c5/72Ha_ftD-G4ZiDGf/_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/geno-f35946c5/72Ha_ftD-G4ZiDGf/_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/geno-f35946c5/72Ha_ftD-G4ZiDGf/_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/geno-f35946c5/72Ha_ftD-G4ZiDGf/_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/geno-f35946c5/72Ha_ftD-G4ZiDGf/_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/geno-f35946c5/72Ha_ftD-G4ZiDGf/_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/geno-f35946c5/72Ha_ftD-G4ZiDGf/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create KYC Validation - gu1\">\u003cmeta data-mint-head property=\"og:description\" content=\"Initiate a KYC verification session for a person entity — in the gu1 KYC API for identity verification flows, with examples for create validation use cases.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"gu1\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.gu1.ai/en/use-cases/kyc/create-validation\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://geno-f35946c5.mintlify.app/_mintlify/api/og/v2?division=Session-based+validation\u0026amp;title=Create+KYC+Validation\u0026amp;description=Initiate+a+KYC+verification+session+for+a+person+entity+%E2%80%94+in+the+gu1+KYC+API+for+identity+verification+flows%2C+with+examples+for+create+validation+use+cases.\u0026amp;theme=019d528ab7f0e9ad1ddd5fb8\u0026amp;signature=509a67b7f7f4554175ac60436a107e669e62e507bdafff569ada07971f91604a\">\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=\"Create KYC Validation - gu1\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Initiate a KYC verification session for a person entity — in the gu1 KYC API for identity verification flows, with examples for create validation use cases.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://geno-f35946c5.mintlify.app/_mintlify/api/og/v2?division=Session-based+validation\u0026amp;title=Create+KYC+Validation\u0026amp;description=Initiate+a+KYC+verification+session+for+a+person+entity+%E2%80%94+in+the+gu1+KYC+API+for+identity+verification+flows%2C+with+examples+for+create+validation+use+cases.\u0026amp;theme=019d528ab7f0e9ad1ddd5fb8\u0026amp;signature=509a67b7f7f4554175ac60436a107e669e62e507bdafff569ada07971f91604a\">\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/geno-f35946c5/72Ha_ftD-G4ZiDGf/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"gu1\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6366f1\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.gu1.ai/en/use-cases/kyc/create-validation\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/en/use-cases/kyc/create-validation.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.gu1.ai/#organization\",\"name\":\"gu1\",\"url\":\"https://docs.gu1.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/geno-f35946c5/u95feZdjOS0TUwM0/logo/light.svg?fit=max\u0026auto=format\u0026n=u95feZdjOS0TUwM0\u0026q=85\u0026s=2538da257ffd4de46bd5e7c5a7a70349\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.gu1.ai#website\",\"name\":\"gu1\",\"url\":\"https://docs.gu1.ai\",\"publisher\":{\"@id\":\"https://docs.gu1.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.gu1.ai/en/use-cases/kyc/create-validation#webpage\",\"url\":\"https://docs.gu1.ai/en/use-cases/kyc/create-validation\",\"name\":\"Create KYC Validation\",\"description\":\"Initiate a KYC verification session for a person entity — in the gu1 KYC API for identity verification flows, with examples for create validation use cases.\",\"dateModified\":\"2026-09-18T16:16:50.900Z\",\"isPartOf\":{\"@id\":\"https://docs.gu1.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.gu1.ai/en/use-cases/kyc/create-validation#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.gu1.ai/en/use-cases/kyc/create-validation#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Use Cases\",\"item\":\"https://docs.gu1.ai/en/use-cases/kyc/complete-flow\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Know Your Customer (KYC)\",\"item\":\"https://docs.gu1.ai/en/use-cases/kyc/complete-flow\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Create KYC Validation\",\"item\":\"https://docs.gu1.ai/en/use-cases/kyc/create-validation\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.gu1.ai/en/use-cases/kyc/create-validation#apireference\",\"headline\":\"Create KYC Validation\",\"name\":\"Create KYC Validation\",\"description\":\"Initiate a KYC verification session for a person entity — in the gu1 KYC API for identity verification flows, with examples for create validation use cases.\",\"url\":\"https://docs.gu1.ai/en/use-cases/kyc/create-validation\",\"mainEntityOfPage\":{\"@id\":\"https://docs.gu1.ai/en/use-cases/kyc/create-validation#webpage\"},\"dateModified\":\"2026-09-18T16:16:50.900Z\",\"publisher\":{\"@id\":\"https://docs.gu1.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.gu1.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"gu1\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"gu1","nav":{"global":null,"versions":[{"version":"🇺🇸 EN","groups":[{"group":"Getting Started","pages":[{"title":"Welcome to gu1","href":"/en/introduction"},{"title":"Quickstart: KYB Risk Analysis in 5 Minutes","href":"/en/quickstart"},{"title":"Changelog","icon":"clock-rotate-left","href":"/en/changelog"},{"title":"API Authentication with Bearer Keys","href":"/en/api-reference/authentication"},{"title":"Production \u0026 Sandbox Environments","href":"/en/api-reference/environments"},{"title":"Reactivate an onboarding request","href":"/en/api-reference/onboarding/document-reactivation"},{"title":"Dashboard sessions (one device at a time)","href":"/en/dashboard-session-policy"}]},{"group":"SDK","pages":[{"title":"Quickstart — React Native SDK","href":"/en/sdk/quickstart"},{"title":"Quickstart — Web SDK","href":"/en/sdk/quickstart-web"}]},{"group":"Use Cases","pages":[{"group":"Know Your Customer (KYC)","pages":[{"title":"Complete Person (KYC) Flow","href":"/en/use-cases/kyc/complete-flow"},{"title":"KYC API Overview","href":"/en/use-cases/kyc/overview"},{"title":"Hosted Onboarding Page","href":"/en/use-cases/kyc/hosted-page"},{"title":"Client-Side Integration Guide","href":"/en/use-cases/kyc/client-integration"},{"title":"Webhook Integration","href":"/en/use-cases/kyc/webhook-integration"},{"group":"Onboarding playbooks","pages":[{"title":"Automatic Person Onboarding with Risk Assessment","href":"/en/use-cases/onboarding/person-automatic-with-risk-matrix"},{"title":"Automatic Company Onboarding with Risk Assessment","description":"Onboard companies automatically with shareholder hierarchy, enrichment, compliance screening, and risk matrix execution in the gu1 automated flow.","href":"/en/use-cases/onboarding/company-automatic-with-risk-matrix"}]},{"group":"API Reference","pages":[{"group":"Session-based validation","pages":[{"title":"Create KYC Validation","api":"POST /api/kyc/validations","href":"/en/use-cases/kyc/create-validation"},{"title":"Get KYC validation media","description":"Download document images, portrait, liveness video, and other assets stored for a session-based KYC validation — in the gu1 KYC API for identity verification.","api":"GET /api/kyc/validations/{id}/media","href":"/en/use-cases/kyc/validation-media"},{"title":"Sandbox mock data","href":"/en/use-cases/kyc/sandbox-mock-data"},{"title":"Get KYC Verification URL","api":"GET /api/kyc/validations/{id}","href":"/en/use-cases/kyc/get-kyc-url"},{"title":"Get Current KYC Validation","api":"GET /api/kyc/entities/{entityId}/current","href":"/en/use-cases/kyc/current-validation"},{"title":"List KYC Validations for Entity","api":"GET /api/kyc/entities/{entityId}/validations","href":"/en/use-cases/kyc/list-validations"},{"title":"Check Verification Status","api":"GET /api/kyc/validations/{id}","href":"/en/use-cases/kyc/check-status"},{"title":"Sync KYC Validation","api":"POST /api/kyc/validations/{id}/sync","href":"/en/use-cases/kyc/sync-validation"},{"title":"Approve KYC Validation","api":"POST /api/kyc/validations/{id}/approve","href":"/en/use-cases/kyc/approve-validation"},{"title":"Reject KYC Validation","api":"POST /api/kyc/validations/{id}/reject","href":"/en/use-cases/kyc/reject-validation"},{"title":"Cancel KYC Validation","api":"DELETE /api/kyc/validations/{id}/cancel","href":"/en/use-cases/kyc/cancel-validation"}]},{"group":"Face Match","pages":[{"title":"Face Match (Document + Selfie)","api":"POST /api/kyc/face-match","href":"/en/use-cases/kyc/face-match"},{"title":"Get Face Match Verification","api":"GET /api/kyc/face-match/verifications/{id}","href":"/en/use-cases/kyc/get-face-match-verification"},{"title":"Get Face Match images","api":"GET /api/kyc/face-match/verifications/{id}/document-image","href":"/en/use-cases/kyc/face-match-images"}]},{"group":"Biometric","pages":[{"title":"Embedded Biometric Session","api":"POST /api/kyc/biometric/sessions","href":"/en/use-cases/kyc/embedded-biometric"},{"title":"Get Current Biometric Session","api":"GET /api/kyc/biometric/entities/{entityId}/current","href":"/en/use-cases/kyc/current-biometric-session"},{"title":"Biometric Check","api":"POST /api/kyc/biometric","href":"/en/use-cases/kyc/biometric"}]},{"group":"ID Verification","pages":[{"title":"ID Verification (Document Front/Back)","api":"POST /api/kyc/id-verification","href":"/en/use-cases/kyc/id-verification"},{"title":"Get ID Verification (List \u0026 Single)","api":"GET /api/kyc/id-verification/verifications","href":"/en/use-cases/kyc/get-id-verification-verification"},{"title":"Get ID Verification images","api":"GET /api/kyc/id-verification/verifications/{id}/document-front-image","href":"/en/use-cases/kyc/id-verification-images"}]}]},{"group":"Custom configuration","pages":[{"title":"Custom Configuration","href":"/en/use-cases/kyc/custom-configuration"},{"title":"KYC Warning Risk Codes","href":"/en/use-cases/kyc/warning-risk-codes"}]}]},{"group":"Know Your Business (KYB)","pages":[{"title":"Complete Company (KYB) Flow","href":"/en/use-cases/kyb/complete-flow"},{"title":"KYB Overview","href":"/en/use-cases/kyb/overview"},{"title":"KYB Workflow","href":"/en/use-cases/kyb/workflow"},{"title":"KYB Data Requirements","href":"/en/use-cases/kyb/data-requirements"},{"title":"KYB Complete Example","href":"/en/use-cases/kyb/example"}]},{"group":"Transaction Monitoring","pages":[{"title":"Complete Transaction Monitoring Flow","href":"/en/use-cases/transaction-monitoring/complete-flow"},{"title":"Transaction Monitoring","href":"/en/use-cases/transaction-monitoring/overview"},{"title":"Rules Configuration","href":"/en/use-cases/transaction-monitoring/rules-configuration"},{"title":"Fraud Detection","href":"/en/use-cases/transaction-monitoring/fraud-detection"},{"title":"AML Monitoring","href":"/en/use-cases/transaction-monitoring/aml-monitoring"},{"title":"Merchant Monitoring","href":"/en/use-cases/transaction-monitoring/merchant-monitoring"},{"group":"API Reference","pages":[{"title":"Create Transaction Endpoint for Monitoring","api":"POST /transactions","href":"/en/use-cases/transaction-monitoring/api-reference"},{"title":"Change Transaction Status","api":"PATCH /transactions/:id/changeStatus","href":"/en/use-cases/transaction-monitoring/change-status-api"}]}]}]},{"group":"Webhooks","pages":[{"title":"Webhooks Overview","href":"/en/webhooks/overview"},{"title":"Webhook Configuration","href":"/en/webhooks/configuration"},{"title":"Webhook Security","href":"/en/webhooks/security"},{"group":"Event Types","pages":[{"title":"Entity Webhook Events","href":"/en/webhooks/events/entity-events"},{"title":"KYC Webhook Events","href":"/en/webhooks/events/kyc-events"},{"title":"Biometric Session Webhook Events","href":"/en/webhooks/events/biometric-events"},{"title":"Transaction Webhook Events","href":"/en/webhooks/events/transaction-events"},{"title":"Rule Webhook Events","href":"/en/webhooks/events/rule-events"},{"title":"Risk Analysis Webhook Events","href":"/en/webhooks/events/risk-analysis-events"},{"title":"Security \u0026 IAM Webhook Events","href":"/en/webhooks/events/security-events"}]}]},{"group":"Workflows","pages":[{"title":"Workflows \u0026 automations","href":"/en/workflows/overview"},{"group":"Guide","pages":[{"title":"Triggers","href":"/en/workflows/triggers"},{"title":"Actions","href":"/en/workflows/actions"},{"title":"Synergy","href":"/en/workflows/synergy"},{"title":"Context and standby","href":"/en/workflows/context-and-standby"},{"title":"Building flows","href":"/en/workflows/building-flows"},{"title":"Rules and workflows","href":"/en/workflows/rules-and-workflows"}]},{"group":"API Reference","pages":[{"title":"List automations","api":"GET /automations","href":"/en/api-reference/automations/list-automations"},{"title":"Get automation","api":"GET /automations/{id}","href":"/en/api-reference/automations/get-automation"},{"title":"Create automation","api":"POST /automations","href":"/en/api-reference/automations/create-automation"},{"title":"Update automation","api":"PUT /automations/{id}","href":"/en/api-reference/automations/update-automation"},{"title":"Archive automation","api":"DELETE /automations/{id}","href":"/en/api-reference/automations/archive-automation"},{"title":"Restore automation","api":"POST /automations/{id}/restore","href":"/en/api-reference/automations/restore-automation"},{"title":"Toggle automation","api":"POST /automations/{id}/toggle","href":"/en/api-reference/automations/toggle-automation"},{"title":"List templates","api":"GET /automations/templates","href":"/en/api-reference/automations/templates"},{"title":"Execute automation (test)","api":"POST /automations/{id}/execute","href":"/en/api-reference/automations/execute-automation"},{"title":"Run automation (manual API)","api":"POST /automations/{id}/run","href":"/en/api-reference/automations/run-automation"},{"title":"List waiting executions","api":"GET /automations/waiting-executions","href":"/en/api-reference/automations/waiting-executions"},{"title":"Continue execution (standby)","api":"POST /automations/executions/{executionId}/continue","href":"/en/api-reference/automations/continue-execution"},{"title":"Cancel execution (standby)","api":"POST /automations/executions/{executionId}/cancel","href":"/en/api-reference/automations/cancel-execution"},{"title":"Get execution context (waiting)","api":"GET /automations/executions/{executionId}/context","href":"/en/api-reference/automations/execution-context"},{"title":"List executions","api":"GET /automations/{id}/executions","href":"/en/api-reference/automations/list-executions"}]}]},{"group":"Monitoring (entities)","pages":[{"title":"Entity monitoring","href":"/en/monitoring/overview"},{"group":"API Reference","pages":[{"title":"Get entity monitoring status","api":"GET /entities/{id}/monitoring","href":"/en/monitoring/api-reference/get-entity-monitoring"},{"title":"Get entity monitoring history","api":"GET /entities/{id}/monitoring/history","href":"/en/monitoring/api-reference/get-entity-monitoring-history"},{"title":"Enable or disable monitoring by entity and integration","api":"PATCH /entities/toggle-status-monitoring","href":"/en/monitoring/api-reference/patch-toggle-status-monitoring"}]}]},{"group":"Person","pages":[{"title":"Entities Overview","href":"/en/api-reference/entities/overview"},{"title":"Entity Types","href":"/en/api-reference/entities/entity-types"},{"title":"Country Requirements","href":"/en/api-reference/entities/country-requirements"},{"title":"Tax ID Formats by Country","href":"/en/api-reference/entities/tax-id-formats"},{"group":"API Reference","pages":[{"title":"Create a person entity","api":"POST /entities","href":"/en/api-reference/person/create"},{"title":"Create a person automatically with enrichment","api":"POST /entities/automatic","href":"/en/api-reference/person/create-automatic"},{"title":"Create an entity automatically with enrichment","api":"POST /entities/automatic","href":"/en/api-reference/entities/create-automatic"},{"title":"Get a person by ID","api":"GET /entities/{id}","href":"/en/api-reference/person/get"},{"title":"List persons","api":"GET /entities","href":"/en/api-reference/person/list"},{"title":"Update a person entity","api":"PATCH /entities/{id}","href":"/en/api-reference/person/update"},{"title":"Update a person by external ID","api":"PATCH /entities/by-external-id/:externalId","href":"/en/api-reference/person/update-by-external-id"},{"title":"Change person external ID","api":"POST /entities/change-external-id","href":"/en/api-reference/person/change-external-id"},{"title":"Upsert a person entity","api":"PUT /entities/upsert","href":"/en/api-reference/person/upsert"},{"title":"Materialize relationships","api":"POST /entities/{entityId}/relationships/materialize","href":"/en/api-reference/entities/materialize-relationships"},{"title":"Get materialized shareholders","api":"GET /entities/{id}/shareholders","href":"/en/api-reference/entities/shareholders"},{"title":"Entity accounts","api":"GET /entities/{id}/accounts","href":"/en/api-reference/entities/accounts"},{"title":"List entity country activations","api":"GET /entities/{id}/country-activations","href":"/en/api-reference/entities/country-activations-list"},{"title":"Update entity country activation","api":"PATCH /entities/{id}/country-activations/{countryCode}","href":"/en/api-reference/entities/country-activations-update"},{"title":"Update entity attributes","api":"PATCH /entities/{id}/attributes","href":"/en/api-reference/entities/attributes-update"},{"title":"Refresh Entity","api":"POST /entities/{entityId}/refresh","href":"/en/api-reference/entities/refresh"},{"title":"Analyze Entity","api":"POST /entities/{entityId}/analyze","href":"/en/api-reference/entities/analyze"},{"title":"Email entity PDF report","api":"POST /entities/{id}/report-export/email","href":"/en/api-reference/entities/report-export-email"}]},{"group":"Provider Codes","pages":[{"title":"Person Provider Codes","href":"/en/api-reference/integrations/person-provider-codes"}]}]},{"group":"Messaging","pages":[{"title":"Messaging overview","href":"/en/api-reference/messaging/overview"},{"group":"API Reference","pages":[{"title":"Send email","api":"POST /marketplace/messaging/send-email","href":"/en/api-reference/messaging/send-email"},{"title":"Send SMS","api":"POST /marketplace/messaging/send-sms","href":"/en/api-reference/messaging/send-sms"}]}]},{"group":"Company","pages":[{"title":"Entities Overview","href":"/en/api-reference/entities/overview"},{"title":"Country Requirements","href":"/en/api-reference/entities/country-requirements"},{"title":"Tax ID Formats by Country","href":"/en/api-reference/entities/tax-id-formats"},{"group":"API Reference","pages":[{"title":"Create a company entity","api":"POST /entities","href":"/en/api-reference/company/create"},{"title":"Create a company automatically with enrichment","api":"POST /entities/automatic","href":"/en/api-reference/company/create-automatic"},{"title":"Create an entity automatically with enrichment","api":"POST /entities/automatic","href":"/en/api-reference/entities/create-automatic"},{"title":"Get a company by ID","api":"GET /entities/{id}","href":"/en/api-reference/company/get"},{"title":"List companies","api":"GET /entities","href":"/en/api-reference/company/list"},{"title":"Update a company entity","api":"PATCH /entities/{id}","href":"/en/api-reference/company/update"},{"title":"Update a company by external ID","api":"PATCH /entities/by-external-id/:externalId","href":"/en/api-reference/company/update-by-external-id"},{"title":"Change company external ID","api":"POST /entities/change-external-id","href":"/en/api-reference/company/change-external-id"},{"title":"Upsert a company entity","api":"PUT /entities/upsert","href":"/en/api-reference/company/upsert"},{"title":"Materialize relationships","api":"POST /entities/{entityId}/relationships/materialize","href":"/en/api-reference/entities/materialize-relationships"},{"title":"Get materialized shareholders","api":"GET /entities/{id}/shareholders","href":"/en/api-reference/entities/shareholders"},{"title":"Entity accounts","api":"GET /entities/{id}/accounts","href":"/en/api-reference/entities/accounts"},{"title":"List entity country activations","api":"GET /entities/{id}/country-activations","href":"/en/api-reference/entities/country-activations-list"},{"title":"Update entity country activation","api":"PATCH /entities/{id}/country-activations/{countryCode}","href":"/en/api-reference/entities/country-activations-update"},{"title":"Update entity attributes","api":"PATCH /entities/{id}/attributes","href":"/en/api-reference/entities/attributes-update"},{"title":"Refresh Entity","api":"POST /entities/{entityId}/refresh","href":"/en/api-reference/entities/refresh"},{"title":"Analyze Entity","api":"POST /entities/{entityId}/analyze","href":"/en/api-reference/entities/analyze"},{"title":"Email entity PDF report","api":"POST /entities/{id}/report-export/email","href":"/en/api-reference/entities/report-export-email"}]},{"group":"Provider Codes","pages":[{"title":"Company Provider Codes","href":"/en/api-reference/integrations/company-provider-codes"}]}]},{"group":"Transactions","pages":[{"group":"API Reference","pages":[{"title":"Create Transaction","api":"POST /transactions","href":"/en/api-reference/transactions/create"},{"title":"List transactions","api":"GET /transactions","href":"/en/api-reference/transactions/list"},{"title":"Get Transaction","api":"GET /transactions/{id}","href":"/en/api-reference/transactions/get"},{"title":"Update Transaction","api":"PATCH /transactions/{id}","href":"/en/api-reference/transactions/update"},{"title":"Report Transaction Risk","api":"POST /transactions/{id}/confirm-risk","href":"/en/api-reference/transactions/report-risk"},{"title":"Create Batch Transactions","api":"POST /transactions/batch","href":"/en/api-reference/transactions/create-batch"},{"title":"Currencies with automatic conversion","href":"/en/api-reference/transactions/currency-conversion"},{"title":"Change Transaction Status","api":"PATCH /transactions/:id/changeStatus","href":"/en/use-cases/transaction-monitoring/change-status-api"},{"title":"Transaction Reason Enum","href":"/en/api-reference/transactions/reason-enum"},{"title":"Transaction Time Zone Enum","href":"/en/api-reference/transactions/time-zone-enum"},{"title":"Payment Details Schema","href":"/en/api-reference/transactions/payment-details-schema"},{"title":"Rules Execution Summary","href":"/en/api-reference/rules-execution-summary"},{"title":"Materialize relationships","api":"POST /entities/{entityId}/relationships/materialize","href":"/en/api-reference/entities/materialize-relationships"},{"title":"Get materialized shareholders","api":"GET /entities/{id}/shareholders","href":"/en/api-reference/entities/shareholders"},{"title":"List entity country activations","api":"GET /entities/{id}/country-activations","href":"/en/api-reference/entities/country-activations-list"},{"title":"Update entity country activation","api":"PATCH /entities/{id}/country-activations/{countryCode}","href":"/en/api-reference/entities/country-activations-update"},{"title":"Update entity attributes","api":"PATCH /entities/{id}/attributes","href":"/en/api-reference/entities/attributes-update"},{"title":"Refresh Entity","api":"POST /entities/{entityId}/refresh","href":"/en/api-reference/entities/refresh"},{"title":"Analyze Entity","api":"POST /entities/{entityId}/analyze","href":"/en/api-reference/entities/analyze"}]}]},{"group":"Devices","pages":[{"title":"Devices API overview","href":"/en/api-reference/devices/overview"},{"group":"API Reference","pages":[{"title":"Register a device for an entity","api":"POST /devices/entity/{entityId}","href":"/en/api-reference/devices/create"},{"title":"List devices for an entity","api":"GET /devices/entity/{entityId}","href":"/en/api-reference/devices/list"}]}]},{"group":"Events","pages":[{"title":"User events API overview","href":"/en/api-reference/events/overview"},{"title":"User event codes","href":"/en/api-reference/events/event-codes"},{"group":"API Reference","pages":[{"title":"Create a user event for rules and fraud detection","api":"POST /events/user","href":"/en/api-reference/events/create"},{"title":"List user events","api":"GET /events/user","href":"/en/api-reference/events/list"},{"title":"Statistics","api":"GET /events/user/stats","href":"/en/api-reference/events/stats"},{"title":"List by Entity","api":"GET /events/user/entity/{entityId}","href":"/en/api-reference/events/list-by-entity"},{"title":"Has events by entity","description":"Fast boolean check whether an entity has any linked user events — same linkage scope as list-by-entity without returning event rows or counts.","api":"GET /events/user/entity/has-events","href":"/en/api-reference/events/has-events-by-entity"}]}]},{"group":"Know Your Customer (KYC)","pages":[{"group":"API Reference","pages":[{"group":"Session-based validation","pages":[{"title":"Create KYC Validation","api":"POST /api/kyc/validations","href":"/en/use-cases/kyc/create-validation"},{"title":"Get KYC validation media","description":"Download document images, portrait, liveness video, and other assets stored for a session-based KYC validation — in the gu1 KYC API for identity verification.","api":"GET /api/kyc/validations/{id}/media","href":"/en/use-cases/kyc/validation-media"},{"title":"Sandbox mock data","href":"/en/use-cases/kyc/sandbox-mock-data"},{"title":"Get KYC Verification URL","api":"GET /api/kyc/validations/{id}","href":"/en/use-cases/kyc/get-kyc-url"},{"title":"Get Current KYC Validation","api":"GET /api/kyc/entities/{entityId}/current","href":"/en/use-cases/kyc/current-validation"},{"title":"List KYC Validations for Entity","api":"GET /api/kyc/entities/{entityId}/validations","href":"/en/use-cases/kyc/list-validations"},{"title":"Check Verification Status","api":"GET /api/kyc/validations/{id}","href":"/en/use-cases/kyc/check-status"},{"title":"Sync KYC Validation","api":"POST /api/kyc/validations/{id}/sync","href":"/en/use-cases/kyc/sync-validation"},{"title":"Approve KYC Validation","api":"POST /api/kyc/validations/{id}/approve","href":"/en/use-cases/kyc/approve-validation"},{"title":"Reject KYC Validation","api":"POST /api/kyc/validations/{id}/reject","href":"/en/use-cases/kyc/reject-validation"},{"title":"Cancel KYC Validation","api":"DELETE /api/kyc/validations/{id}/cancel","href":"/en/use-cases/kyc/cancel-validation"}]},{"group":"Face Match","pages":[{"title":"Face Match (Document + Selfie)","api":"POST /api/kyc/face-match","href":"/en/use-cases/kyc/face-match"},{"title":"Get Face Match Verification","api":"GET /api/kyc/face-match/verifications/{id}","href":"/en/use-cases/kyc/get-face-match-verification"},{"title":"Get Face Match images","api":"GET /api/kyc/face-match/verifications/{id}/document-image","href":"/en/use-cases/kyc/face-match-images"}]},{"group":"Biometric","pages":[{"title":"Embedded Biometric Session","api":"POST /api/kyc/biometric/sessions","href":"/en/use-cases/kyc/embedded-biometric"},{"title":"Get Current Biometric Session","api":"GET /api/kyc/biometric/entities/{entityId}/current","href":"/en/use-cases/kyc/current-biometric-session"},{"title":"Biometric Check","api":"POST /api/kyc/biometric","href":"/en/use-cases/kyc/biometric"}]},{"group":"ID Verification","pages":[{"title":"ID Verification (Document Front/Back)","api":"POST /api/kyc/id-verification","href":"/en/use-cases/kyc/id-verification"},{"title":"Get ID Verification (List \u0026 Single)","api":"GET /api/kyc/id-verification/verifications","href":"/en/use-cases/kyc/get-id-verification-verification"},{"title":"Get ID Verification images","api":"GET /api/kyc/id-verification/verifications/{id}/document-front-image","href":"/en/use-cases/kyc/id-verification-images"}]}]},{"group":"Custom configuration","pages":[{"title":"Custom Configuration","href":"/en/use-cases/kyc/custom-configuration"},{"title":"KYC Warning Risk Codes","href":"/en/use-cases/kyc/warning-risk-codes"}]}]},{"group":"Payment Methods","pages":[{"title":"Payment Methods Overview","href":"/en/api-reference/payment-methods/overview"},{"group":"API Reference","pages":[{"title":"Create Payment Method","api":"POST /entities","href":"/en/api-reference/payment-methods/create"},{"title":"Get Payment Method","api":"GET /entities/{id}","href":"/en/api-reference/payment-methods/get"},{"title":"List Payment Methods","api":"GET /entities","href":"/en/api-reference/payment-methods/list"},{"title":"Update Payment Method","api":"PATCH /entities/{id}","href":"/en/api-reference/payment-methods/update"},{"title":"Materialize relationships","api":"POST /entities/{entityId}/relationships/materialize","href":"/en/api-reference/entities/materialize-relationships"},{"title":"Get materialized shareholders","api":"GET /entities/{id}/shareholders","href":"/en/api-reference/entities/shareholders"},{"title":"List entity country activations","api":"GET /entities/{id}/country-activations","href":"/en/api-reference/entities/country-activations-list"},{"title":"Update entity country activation","api":"PATCH /entities/{id}/country-activations/{countryCode}","href":"/en/api-reference/entities/country-activations-update"},{"title":"Update entity attributes","api":"PATCH /entities/{id}/attributes","href":"/en/api-reference/entities/attributes-update"},{"title":"Refresh Entity","api":"POST /entities/{entityId}/refresh","href":"/en/api-reference/entities/refresh"},{"title":"Analyze Entity","api":"POST /entities/{entityId}/analyze","href":"/en/api-reference/entities/analyze"}]}]},{"group":"Rules","pages":[{"group":"API Reference","pages":[{"title":"Create Rule","api":"POST /rules","href":"/en/api-reference/rules/create"},{"title":"Get Rule","api":"GET /rules/{id}","href":"/en/api-reference/rules/get"},{"title":"List Rules","api":"GET /rules","href":"/en/api-reference/rules/list"},{"title":"Update Rule","api":"PATCH /rules/{id}","href":"/en/api-reference/rules/update"},{"title":"Execute Rule","api":"POST /rules/{ruleId}/execute","href":"/en/api-reference/rules/execute"},{"title":"Condition Fields Reference","href":"/en/api-reference/rules/conditions"}]}]},{"group":"Custom lists","pages":[{"title":"Custom lists (data lists)","href":"/en/api-reference/data-lists/overview"},{"group":"API Reference","pages":[{"title":"Create data list","api":"POST /data-lists","href":"/en/api-reference/data-lists/create"},{"title":"List data lists","api":"GET /data-lists","href":"/en/api-reference/data-lists/list"},{"title":"Get data list by id or lists by type","api":"GET /data-lists/{typeOrId}","href":"/en/api-reference/data-lists/get"},{"title":"Update data list","api":"PATCH /data-lists/{id}","href":"/en/api-reference/data-lists/update"},{"title":"Update data list status","api":"PATCH /data-lists/{id}/status","href":"/en/api-reference/data-lists/update-status"},{"title":"Delete data list","api":"DELETE /data-lists/{id}","href":"/en/api-reference/data-lists/delete"},{"title":"Add items to list","api":"POST /data-lists/{id}/items","href":"/en/api-reference/data-lists/add-items"},{"title":"Bulk import list items","api":"POST /data-lists/{id}/items/bulk","href":"/en/api-reference/data-lists/bulk-import-items"},{"title":"Add items by list type (legacy shortcut)","api":"POST /data-lists/{type}/items","href":"/en/api-reference/data-lists/add-items-by-type"},{"title":"List items in a data list","api":"GET /data-lists/{id}/items","href":"/en/api-reference/data-lists/list-items"},{"title":"Find items by value in a list","api":"POST /data-lists/{id}/items/find","href":"/en/api-reference/data-lists/find-items"},{"title":"Update list item","api":"PATCH /data-lists/{id}/items/{itemId}","href":"/en/api-reference/data-lists/update-item"},{"title":"Delete list item","api":"DELETE /data-lists/{id}/items/{itemId}","href":"/en/api-reference/data-lists/delete-item"},{"title":"Check value in lists by type","api":"POST /data-lists/{type}/check","href":"/en/api-reference/data-lists/check-value"},{"title":"Bulk check values","api":"POST /data-lists/bulk-check","href":"/en/api-reference/data-lists/bulk-check"},{"title":"Get data list statistics","api":"GET /data-lists/{id}/stats","href":"/en/api-reference/data-lists/stats"},{"title":"List itemData keys","api":"GET /data-lists/{id}/item-data-keys","href":"/en/api-reference/data-lists/item-data-keys"},{"title":"Marketplace lists for rules","api":"GET /data-lists/marketplace-lists-for-rules","href":"/en/api-reference/data-lists/marketplace-lists-for-rules"}]}]},{"group":"Risk Matrix","pages":[{"group":"API Reference","pages":[{"title":"List Risk Matrices","api":"GET /risk-matrices","href":"/en/api-reference/risk-matrix/list"},{"title":"Get Risk Matrix","api":"GET /risk-matrices/{id}","href":"/en/api-reference/risk-matrix/get"},{"title":"Create Risk Matrix","api":"POST /risk-matrices","href":"/en/api-reference/risk-matrix/create"},{"title":"Update Risk Matrix","api":"PUT /risk-matrices/{id}","href":"/en/api-reference/risk-matrix/update"}]}]},{"group":"Alerts","pages":[{"group":"API Reference","pages":[{"title":"List Alerts","api":"GET /intelligence/alerts","href":"/en/api-reference/alerts/list"},{"title":"Get Intelligence Inbox","api":"GET /intelligence/inbox","href":"/en/api-reference/alerts/inbox"},{"title":"Acknowledge Alert","api":"POST /intelligence/alerts/{id}/acknowledge","href":"/en/api-reference/alerts/acknowledge"},{"title":"Resolve Alert","api":"POST /intelligence/alerts/{id}/resolve","href":"/en/api-reference/alerts/resolve"},{"title":"Mark Alert as False Positive","api":"PUT /alerts/{id}/false-positive","href":"/en/api-reference/alerts/false-positive"}]}]},{"group":"Investigations","pages":[{"group":"API Reference","pages":[{"title":"List Investigations","api":"GET /intelligence/investigations","href":"/en/api-reference/investigations/list"},{"title":"Get Investigation Alerts","api":"GET /intelligence/investigations/{id}/alerts","href":"/en/api-reference/investigations/get-alerts"},{"title":"Update Investigation Status","api":"PATCH /intelligence/investigations/{id}/status","href":"/en/api-reference/investigations/update-status"},{"title":"Assign Investigation","api":"PUT /intelligence/investigations/{id}/assign","href":"/en/api-reference/investigations/assign"}]}]},{"group":"Data Ingestion","pages":[{"title":"Data Ingestion Overview","href":"/en/api-reference/data-ingestion/overview"},{"title":"Custom Schemas","href":"/en/api-reference/data-ingestion/custom-schemas"},{"title":"Field Mappings","href":"/en/api-reference/data-ingestion/field-mappings"}]},{"group":"Bulk imports","pages":[{"title":"Bulk imports","href":"/en/api-reference/bulk-imports/overview"},{"group":"API Reference","pages":[{"title":"Endpoints overview","href":"/en/api-reference/bulk-imports/api-reference"},{"title":"List mappings","api":"GET /batch-import/mappings","href":"/en/api-reference/bulk-imports/list-mappings"},{"title":"Create mapping","api":"POST /batch-import/mappings","href":"/en/api-reference/bulk-imports/create-mapping"},{"title":"Update mapping","api":"PATCH /batch-import/mappings/{id}","href":"/en/api-reference/bulk-imports/update-mapping"},{"title":"Delete mapping","api":"DELETE /batch-import/mappings/{id}","href":"/en/api-reference/bulk-imports/delete-mapping"},{"title":"Validate CSV","api":"POST /batch-import/validate-csv","href":"/en/api-reference/bulk-imports/validate-csv"},{"title":"Import entities (CSV)","api":"POST /batch-import/import/entities","href":"/en/api-reference/bulk-imports/import-entities"},{"title":"Import user events (CSV)","api":"POST /batch-import/import/user-events","href":"/en/api-reference/bulk-imports/import-user-events"},{"title":"Import transactions (multipart)","api":"POST /batch-import/import/transactions","href":"/en/api-reference/bulk-imports/import-transactions"},{"title":"List unified import history","api":"GET /batch-import/unified-history","href":"/en/api-reference/bulk-imports/list-unified-history"},{"title":"Get batch job status","api":"GET /batch-import/jobs/{jobId}","href":"/en/api-reference/bulk-imports/get-batch-job-status"},{"title":"Download batch job payload","api":"GET /batch-import/jobs/{jobId}/payload","href":"/en/api-reference/bulk-imports/get-batch-job-payload"},{"title":"List mapping audits","api":"GET /batch-import/mapping-audits","href":"/en/api-reference/bulk-imports/list-mapping-audits"},{"title":"Control batch job","api":"POST /batch-import/jobs/{jobId}/control","href":"/en/api-reference/bulk-imports/control-batch-job"},{"title":"Batch import failure codes","href":"/en/api-reference/bulk-imports/batch-import-failure-codes"},{"title":"Transaction batch failures","api":"GET /batch-import/transaction-jobs/{jobId}/failures","href":"/en/api-reference/bulk-imports/get-transaction-batch-failures"},{"title":"User-event batch failures","api":"GET /batch-import/user-event-jobs/{jobId}/failures","href":"/en/api-reference/bulk-imports/get-user-event-batch-failures"},{"title":"Entity batch failures","href":"/en/api-reference/bulk-imports/get-entity-batch-failures"},{"title":"Requeue transaction batch job","api":"POST /batch-import/transaction-jobs/{jobId}/requeue","href":"/en/api-reference/bulk-imports/requeue-transaction-batch-job"},{"title":"Requeue entity bulk import job","api":"POST /batch-import/entity-jobs/{jobId}/requeue","href":"/en/api-reference/bulk-imports/requeue-entity-batch-job"}]}]},{"group":"Documents","pages":[{"group":"API Reference","pages":[{"title":"Upload Document","api":"POST /documents/upload","href":"/en/api-reference/documents/upload"}]}]},{"group":"Enrichment","pages":[{"title":"Enrichment Overview","href":"/en/api-reference/enrichment/overview"},{"group":"API Reference","pages":[{"title":"Execute Enrichment by Entity ID","api":"POST /integration-execution/marketplace/enrichment","href":"/en/api-reference/enrichment/execute-by-id"},{"title":"Execute Enrichment by External ID","api":"POST /integration-execution/marketplace/enrichment-by-external-id","href":"/en/api-reference/enrichment/execute-by-external-id"},{"title":"Get normalized enrichment","api":"GET /entities/{id}/normalized-enrichment","href":"/en/api-reference/enrichment/get-normalized"},{"title":"Get current enrichment data","api":"GET /entities/{id}/enrichment-data","href":"/en/api-reference/enrichment/get-current-data"}]}]},{"group":"AML Crypto","pages":[{"title":"AML Crypto","sidebarTitle":"Overview","href":"/en/api-reference/aml-crypto/overview"},{"group":"API Reference","pages":[{"title":"AML Crypto health","api":"GET /aml-crypto/health","href":"/en/api-reference/aml-crypto/health"},{"title":"Address label","api":"GET /aml-crypto/address-label","href":"/en/api-reference/aml-crypto/address-label"},{"title":"Address risk score","api":"GET /aml-crypto/address-risk-score","href":"/en/api-reference/aml-crypto/address-risk-score"},{"title":"Address risk activity","api":"GET /aml-crypto/address-risk-activity","href":"/en/api-reference/aml-crypto/address-risk-activity"},{"title":"Dark web wallet","api":"GET /aml-crypto/dark-web-wallet","href":"/en/api-reference/aml-crypto/dark-web-wallet"},{"title":"Transaction risk score","api":"GET /aml-crypto/transaction-risk-score","href":"/en/api-reference/aml-crypto/transaction-risk-score"},{"title":"List AML Crypto checks","api":"GET /aml-crypto/checks","href":"/en/api-reference/aml-crypto/list-checks"},{"title":"Get AML Crypto check","api":"GET /aml-crypto/checks/{id}","href":"/en/api-reference/aml-crypto/get-check"}]}]},{"group":"Services","pages":[{"title":"Marketplace Services Overview","href":"/en/api-reference/services/overview"},{"group":"CBU/CVU Holder Intelligence","pages":[{"title":"CBU/CVU Holder Intelligence","sidebarTitle":"Overview","href":"/en/api-reference/services/ar-gueno-holder-intelligence/overview"},{"group":"API Reference","pages":[{"title":"Service Health","api":"GET /integration-services/ar_gueno_holder_intelligence_service/health","href":"/en/api-reference/services/ar-gueno-holder-intelligence/health"},{"title":"Check CUIT in Corpus","api":"GET /integration-services/ar_gueno_holder_intelligence_service/cuits/:cuit/exists","href":"/en/api-reference/services/ar-gueno-holder-intelligence/exists"},{"title":"Accounts Count by CUIT","api":"GET /integration-services/ar_gueno_holder_intelligence_service/cuits/:cuit/accounts-count","href":"/en/api-reference/services/ar-gueno-holder-intelligence/accounts-count"},{"title":"Custom Metrics by CUIT","api":"GET /integration-services/ar_gueno_holder_intelligence_service/cuits/:cuit/metrics","href":"/en/api-reference/services/ar-gueno-holder-intelligence/metrics"}]}]},{"group":"Fraud Prevention Center (CPF)","pages":[{"title":"Fraud Prevention Center (CPF)","sidebarTitle":"Overview","href":"/en/api-reference/services/ar-gueno-cpf/overview"},{"group":"API Reference","pages":[{"title":"CPF — Health","sidebarTitle":"Health","href":"/en/api-reference/services/ar-gueno-cpf/health"},{"title":"CPF — Corpus coverage","sidebarTitle":"Coverage","href":"/en/api-reference/services/ar-gueno-cpf/coverage"},{"title":"CPF — CUIT in-list","sidebarTitle":"CUIT in-list","href":"/en/api-reference/services/ar-gueno-cpf/cuits-in-list"},{"title":"CPF — CUIT lookup","sidebarTitle":"CUIT lookup","href":"/en/api-reference/services/ar-gueno-cpf/cuits"},{"title":"CPF — Account in-list","sidebarTitle":"Account in-list","href":"/en/api-reference/services/ar-gueno-cpf/accounts-in-list"},{"title":"CPF — Account lookup","sidebarTitle":"Account lookup","href":"/en/api-reference/services/ar-gueno-cpf/accounts"},{"title":"CPF — Operation detail","sidebarTitle":"Operations","href":"/en/api-reference/services/ar-gueno-cpf/operations"},{"title":"CPF — Upload workbook","sidebarTitle":"Upload workbook","href":"/en/api-reference/services/ar-gueno-cpf/upload"}]}]}]},{"group":"Integrations","pages":[{"title":"Shared Provider Codes","href":"/en/api-reference/integrations/shared-provider-codes"},{"group":"API Reference","pages":[{"title":"Execute marketplace enrichment without entity","api":"POST /integration-execution/execute-without-entity","href":"/en/api-reference/integrations/execute-without-entity"},{"title":"List headless enrichment executions","api":"GET /integration-execution/headless-executions","href":"/en/api-reference/integrations/headless-executions"},{"title":"Get headless enrichment execution by id","api":"GET /integration-execution/headless-executions/item/:id","href":"/en/api-reference/integrations/headless-executions-item"}]}]},{"group":"Interactive Tutorials","pages":[{"title":"How to invite members to your organization","icon":"user-plus","href":"/en/tutorials/invite-members"},{"title":"How to manage roles and permissions (RBAC)","icon":"shield-halved","href":"/en/tutorials/manage-roles"},{"title":"How to configure and manage teams","icon":"users-gear","href":"/en/tutorials/configure-teams"},{"title":"How to Switch Between Environments (Production and Sandbox)","icon":"toggle-on","href":"/en/tutorials/switch-environments"},{"title":"How to Create and Manage API Keys","icon":"key","href":"/en/tutorials/manage-api-keys"}]}]},{"version":"🇪🇸 ES","pages":[{"title":"🇪🇸 ES","href":"/es/use-cases/kyc/create-validation"}]},{"version":"🇧🇷 PT","pages":[{"title":"🇧🇷 PT","href":"/pt/use-cases/kyc/create-validation"}]}]},"basePath":"","title":"Create KYC Validation - gu1","buildId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","deploymentId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-B7XKH4J3.js","utils-lOYzL7z-.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DF6jUUIM.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dpsj5f7C.js","snippetPresets-CYeiDe8v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CUFz1YZ_.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D8H_iLS4.js","shallow-DdluZBHX.js","getApiPlaygroundDisplay-B9922vev.js","CodeSnippet-CMoRNGYs.js","CodeSnippets-DwyrPHuw.js","Page-DSVu9Ucl.js","getPastedJson-G-zIvlHh.js","icon-B03fnEy0.js","MethodPill-CW7teklc.js","DuplicateIcon-CtO8eekd.js","createIcon-DZTKdM_A.js","DynamicMarkdown-D5M2At0B.js","SectionHeading-C_2NaA2U.js","axios-vUo_bRtp.js"]}