Authentication is new. These endpoints are served by your application’s issuer, such as https://<name>.auth.didit.me, and never take your Didit API key.
This is the instant revocation check. It allows 30 requests a minute and 300 an hour per IP address, so verify tokens offline on every request and call it before sensitive actions. See Check the session.
How the session signed in, as one value: for example password, code (email code), magic (magic link), passkey, phone, sso, wallet (Didit ID Wallet) or the name of a social sign-in method. Empty for an agent token.
Verification level and selected claims, the same object the tokens carry as verified, or null when there is none. Read this, not email_verified, to know whether the person verified their identity.
Every customer organization the person belongs to, when organizations are on. Empty otherwise.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Didit Docs","description":"The best way to integrate identity and fraud checks into your app. One API, four product lines (KYC · KYB · Transaction Monitoring · Wallet Screening), 220+ countries, 14,000+ documents, sub-2s inference, $10 free credit/month.","colors":{"primary":"#2567FF","light":"#90B1FF","dark":"#1B4FE0"},"logo":{"light":"https://mintcdn.com/didit-0f962782/dCzNNoYCusBNdK3I/logo/didit.svg?fit=max\u0026auto=format\u0026n=dCzNNoYCusBNdK3I\u0026q=85\u0026s=9f162fb8295fa1fd9300a24b293ce0b7","dark":"https://mintcdn.com/didit-0f962782/TefoKXCbZA_GIK5a/logo/didit-logo-wordmark-white.svg?fit=max\u0026auto=format\u0026n=TefoKXCbZA_GIK5a\u0026q=85\u0026s=c8c541689c814ca6a2c873cf6185a3a7","href":"https://docs.didit.me"},"favicon":"https://mintcdn.com/didit-0f962782/t6r0B-WdGMU5mSS-/favicon.ico?fit=max\u0026auto=format\u0026n=t6r0B-WdGMU5mSS-\u0026q=85\u0026s=b291917b960ebe959ae3b1aa233eafa8","api":{"examples":{"prefill":true},"mdx":{"auth":{"method":"key","name":"x-api-key"},"server":"https://verification.didit.me"}},"background":{"color":{"light":"#FFFFFF","dark":"#1A1A1A"}},"navbar":{"links":[{"icon":"comment-dots","href":"https://wa.me/+19544659728","label":"Support"}],"primary":{"type":"button","label":"Sign in","href":"https://business.didit.me"}},"footer":{"socials":{"x":"https://x.com/getdidit","github":"https://github.com/didit-protocol","linkedin":"https://linkedin.com/company/91001155","website":"https://didit.me"}},"search":{"prompt":"Search Didit docs..."},"seo":{"metatags":{"twitter:site":"@didit","theme-color":"#2567FF","apple-mobile-web-app-title":"Didit Docs"},"organization":{"id":"https://didit.me/#organization","name":"Didit","legalName":"Didit Protocol","url":"https://didit.me","logo":"https://didit.me/logos/primary-horizontal-light.png","sameAs":["https://www.linkedin.com/company/91001155","https://www.youtube.com/@getdidit","https://github.com/didit-protocol","https://x.com/didit"]},"indexing":"navigable"},"fonts":{"heading":{"family":"Inter","weight":500},"body":{"family":"Inter","weight":400}},"errors":{"404":{"redirect":false,"title":"Page not found","description":"This page moved or never existed. [Back to docs](/)"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"thumbnails":{"appearance":"light","background":"https://mintcdn.com/didit-0f962782/Xkecx-xLq1K2abHK/images/og-thumbnail-backplate.png?fit=max\u0026auto=format\u0026n=Xkecx-xLq1K2abHK\u0026q=85\u0026s=c699fa252554b2ac8d4c631e209a1473","fonts":{"family":"Inter"}},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"API Reference","icon":"code","href":"/api-reference/overview"},{"anchor":"Business Console","icon":"gauge","href":"https://business.didit.me"},{"anchor":"OpenAPI Spec","icon":"file-code","href":"https://docs.didit.me/openapi-25.json"},{"anchor":"Integration Prompt","icon":"wand-magic-sparkles","href":"/integration/integration-prompt"},{"anchor":"MCP Server","icon":"plug","href":"/integration/mcp/overview"},{"anchor":"Agent Skills","icon":"robot","href":"https://github.com/didit-protocol/skills"}]},"languages":[{"language":"en","href":""},{"language":"es","href":"es"},{"language":"pt-BR","href":"pt-br"},{"language":"ja","href":"ja"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"didit-0f962782","hasAudioNarration":false,"actualSubdomain":"didit-0f962782","customDomains":["docs.didit.me"],"gitSource":{"type":"github","owner":"didit-protocol","repo":"mintlify-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae266b4651725af2715a107","collectionId":"2efe3568-441a-483f-9a29-94ec75b3b6cc","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae266b4651725af2715a107"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae266b4651725af2715a107","clientVersion":"0.0.4006","searchFilterCounts":[{"language":"en","tag":"API Reference","count":410},{"language":"en","tag":"Database Validation","count":129},{"language":"en","tag":"Get Started","count":83},{"language":"en","tag":"User Verification","count":71},{"language":"en","tag":"Integrate / SDKs","count":53},{"language":"en","tag":"Travel Rule","count":53},{"language":"en","tag":"Verification","count":48},{"language":"en","tag":"Authentication","count":37},{"language":"en","tag":"Digital ID wallets","count":33},{"language":"en","tag":"Transaction Monitoring","count":28},{"language":"es","tag":"Verificación de usuarios","count":19},{"language":"ja","tag":"ユーザー認証","count":19},{"language":"pt-BR","tag":"Verificação de usuários","count":19},{"language":"es","tag":"Primeros pasos","count":17},{"language":"ja","tag":"はじめに","count":17},{"language":"pt-BR","tag":"Primeiros passos","count":17},{"language":"es","tag":"Verificación","count":10},{"language":"ja","tag":"検証","count":10},{"language":"pt-BR","tag":"Verificação","count":10},{"language":"es","tag":"Autenticación","count":5},{"language":"es","tag":"Visión general","count":5},{"language":"ja","tag":"認証","count":5},{"language":"ja","tag":"概要","count":5},{"language":"pt-BR","tag":"Autenticação","count":5},{"language":"pt-BR","tag":"Visão geral","count":5},{"language":"es","tag":"Integración / SDKs","count":4},{"language":"ja","tag":"連携 / SDK","count":4},{"language":"pt-BR","tag":"Integração / SDKs","count":4},{"language":"es","tag":"Monitorización","count":3},{"language":"es","tag":"Seguridad y cumplimiento","count":3},{"language":"ja","tag":"モニタリング","count":3},{"language":"ja","tag":"セキュリティとコンプライアンス","count":3},{"language":"pt-BR","tag":"Monitoramento","count":3},{"language":"pt-BR","tag":"Segurança e conformidade","count":3},{"language":"es","tag":"Verificación de empresas","count":2},{"language":"es","tag":"Ajustes y personalización","count":2},{"language":"ja","tag":"法人確認","count":2},{"language":"ja","tag":"設定とカスタマイズ","count":2},{"language":"pt-BR","tag":"Verificação de empresas","count":2},{"language":"pt-BR","tag":"Configurações e personalização","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"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":"editor-v7-file-tree","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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"editor-agent-model-picker","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":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","href":"/_mintlify/custom/didit-0f962782/e74dc7c3efa9e767/style.css"}],"page":{"pagePath":"authentication/api-reference/get-session","slug":"/authentication/api-reference/get-session","pageMetadata":{"title":"Get Session | Didit Authentication API","sidebarTitle":"Get the session","description":"GET /session/ checks an access token against the live session: it fails at once after revocation, idle timeout, blocking or a refresh.","keywords":["session check","token revocation","access token validation","vendor_data","verified claims","Didit Authentication API"],"openapi":"openapi-authentication.json GET /session/","href":"/authentication/api-reference/get-session"},"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: \"GET /session/ checks an access token against the live session: it fails at once after revocation, idle timeout, blocking or a refresh.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,..._provideComponents(),...props.components},{Warning}=_components;if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Warning,{children:_jsxs(_components.p,{children:[`Authentication is new. These endpoints are served by your application’s issuer, such as `,_jsx(_components.code,{children:`https://\u003cname>.auth.didit.me`}),`, and never take your Didit API key.`]})}),`\n`,_jsxs(_components.p,{children:[`This is the instant revocation check. It allows 30 requests a minute and 300 an hour per IP address, so verify tokens offline on every request and call it before sensitive actions. See `,_jsx(_components.a,{href:`/authentication/tokens-and-jwks#check-the-session`,children:`Check the session`}),`.`]})]})}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":"Get Session | Didit Authentication API","sidebarTitle":"Get the session","description":"GET /session/ checks an access token against the live session: it fails at once after revocation, idle timeout, blocking or a refresh.","keywords":["session check","token revocation","access token validation","vendor_data","verified claims","Didit Authentication API"],"openapi":"openapi-authentication.json GET /session/","href":"/authentication/api-reference/get-session"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/didit-0f962782/5fb7c0c336c92274/snippets/data/database-validation-coverage.js","/_mintlify/custom/didit-0f962782/4ac7d3c2a19a354d/database-validation-playground.js"],"openApiReferenceData":{"operation":{"tags":["Sessions"],"summary":"Get the session","operationId":"authentication_get_session","description":"GET /session/ checks an access token against the live session: it fails at once after revocation, idle timeout, blocking or a refresh.","security":["f16790f5-52e1-4c14-ac4a-a85279c77648"],"x-didit-sdk":{"resource":"authentication","method":"get_session","auth":"access_token","server":true},"responses":{"200":"84b30c20-a36b-4cb6-acee-3ea5257b0900","401":"44cdc4d4-2e1d-4d6d-8055-3084d2f273c6","403":"c9ea7608-7dba-4ee3-b260-eb295849a378","404":"a0899260-fc87-4e12-96cb-a005e876961c","429":"b452cd7a-6381-45f7-8ee7-09e1b7732702","503":"f863f45b-7509-4180-aed0-a5286325a245"},"method":"get","type":"path","servers":["59e9eafe-cb78-4241-8800-f0753a9a3cc6"],"path":"/session/","baseUrlOptions":["https://{issuer}"],"title":"Get the session","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[]},"dependencies":{"parameters":{},"responses":{"84b30c20-a36b-4cb6-acee-3ea5257b0900":{"description":"The session is live.","headers":{"Cache-Control":{"description":"Always `no-store`: never cache this response.","schema":{"type":"string","example":"no-store"}},"Pragma":{"description":"Always `no-cache`.","schema":{"type":"string","example":"no-cache"}}},"content":{"application/json":{"schema":{"type":"object","description":"The live session behind an access token.","required":["sub","sid","application_id","vendor_data","amr","mfa_verified","email","email_verified","phone","verified_identity","verified","expires_at","post_logout_redirect_uri","organizations"],"properties":{"sub":{"type":"string","format":"uuid","description":"The identity ID.","example":"1c9d8b88-1bff-43d1-ad7a-88b2bc0024e9","isRequired":true,"uniqueKey":"sub","typeLabel":"string\u003cuuid>"},"sid":{"type":"string","format":"uuid","description":"The session ID.","example":"c9abf6cc-2d64-4bf2-b31e-a4d09a070ab1","isRequired":true,"uniqueKey":"sid","typeLabel":"string\u003cuuid>"},"application_id":{"type":"string","format":"uuid","example":"7b0a6c2e-3f41-4c9a-8d55-1e2f3a4b5c6d","isRequired":true,"uniqueKey":"application_id","typeLabel":"string\u003cuuid>"},"vendor_data":{"type":"string","description":"The person's reference across Didit products, as in the tokens.","example":"user-42","isRequired":true,"uniqueKey":"vendor_data","typeLabel":"string"},"amr":{"type":"array","description":"How the session signed in, as one value: for example `password`, `code` (email code), `magic` (magic link), `passkey`, `phone`, `sso`, `wallet` (Didit ID Wallet) or the name of a social sign-in method. Empty for an agent token.","items":{"type":"string","uniqueKey":"amr.items.[INDEX]","typeLabel":"string"},"example":["password"],"isRequired":true,"uniqueKey":"amr","typeLabel":"string[]"},"mfa_verified":{"type":"boolean","description":"Whether the session passed a second factor. Always `true` for a passkey sign-in.","example":false,"isRequired":true,"uniqueKey":"mfa_verified","typeLabel":"boolean"},"email":{"oneOf":[{"type":"string","format":"email","example":"person@example.com","isRequired":true,"uniqueKey":"email.oneOf.0","typeLabel":"string\u003cemail>"},{"type":"null","format":"email","example":"person@example.com","isRequired":true,"uniqueKey":"email.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"email","typeLabel":"string\u003cemail> | null"},"email_verified":{"type":"boolean","example":true,"isRequired":true,"uniqueKey":"email_verified","typeLabel":"boolean"},"phone":{"oneOf":[{"type":"string","description":"E.164 phone number, or `null`.","example":null,"isRequired":true,"uniqueKey":"phone.oneOf.0","typeLabel":"string"},{"type":"null","description":"E.164 phone number, or `null`.","example":null,"isRequired":true,"uniqueKey":"phone.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"phone","typeLabel":"string | null"},"verified_identity":{"oneOf":[{"type":"object","description":"What the Didit ID Wallet shared at sign-in. `null` when the person signed in another way.","required":["issuer","subject"],"properties":{"issuer":{"type":"string","description":"The wallet's issuer.","example":"https://apx.didit.me/auth/idv","isRequired":true,"uniqueKey":"verified_identity.oneOf.0.issuer","typeLabel":"string"},"subject":{"type":"string","description":"The person's ID at the wallet.","example":"8b7f5c1e-2d3a-4b5c-9e8f-7a6b5c4d3e2f","isRequired":true,"uniqueKey":"verified_identity.oneOf.0.subject","typeLabel":"string"},"shared_session":{"type":"object","description":"A verification the person chose to share, which you redeem with your own API key.","properties":{"share_token":{"type":"string","uniqueKey":"verified_identity.oneOf.0.shared_session.share_token","typeLabel":"string"},"session_id":{"type":"string","uniqueKey":"verified_identity.oneOf.0.shared_session.session_id","typeLabel":"string"},"from_application_id":{"type":"string","uniqueKey":"verified_identity.oneOf.0.shared_session.from_application_id","typeLabel":"string"}},"uniqueKey":"verified_identity.oneOf.0.shared_session","typeLabel":"object"},"claims":{"type":"object","description":"The verified facts the person agreed to share, limited to what your application asked for.","additionalProperties":{"oneOf":[{"type":"boolean","uniqueKey":"verified_identity.oneOf.0.claims.additionalProperties.oneOf.0","typeLabel":"boolean"},{"type":"string","uniqueKey":"verified_identity.oneOf.0.claims.additionalProperties.oneOf.1","typeLabel":"string"}],"uniqueKey":"verified_identity.oneOf.0.claims.additionalProperties","typeLabel":"boolean | string"},"example":{"over_18":true,"given_name":"Alex"},"uniqueKey":"verified_identity.oneOf.0.claims","typeLabel":"object"}},"isRequired":true,"uniqueKey":"verified_identity.oneOf.0","typeLabel":"object"},{"type":"null","description":"What the Didit ID Wallet shared at sign-in. `null` when the person signed in another way.","required":["issuer","subject"],"properties":{"issuer":{"type":"string","description":"The wallet's issuer.","example":"https://apx.didit.me/auth/idv"},"subject":{"type":"string","description":"The person's ID at the wallet.","example":"8b7f5c1e-2d3a-4b5c-9e8f-7a6b5c4d3e2f"},"shared_session":{"type":"object","description":"A verification the person chose to share, which you redeem with your own API key.","properties":{"share_token":{"type":"string"},"session_id":{"type":"string"},"from_application_id":{"type":"string"}}},"claims":{"type":"object","description":"The verified facts the person agreed to share, limited to what your application asked for.","additionalProperties":{"oneOf":[{"type":"boolean"},{"type":"string"}]},"example":{"over_18":true,"given_name":"Alex"}}},"isRequired":true,"uniqueKey":"verified_identity.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"verified_identity","typeLabel":"object | null"},"verified":{"oneOf":[{"type":"object","description":"Verification level and selected claims, the same object the tokens carry as `verified`, or `null` when there is none. Read this, not `email_verified`, to know whether the person verified their identity.","properties":{"level":{"type":"string","enum":["liveness","liveness_face_match","full_id"],"description":"The highest level passed. From weakest to strongest: `liveness`, `liveness_face_match`, `full_id`.","example":"full_id","uniqueKey":"verified.oneOf.0.level","typeLabel":"enum\u003cstring>"},"over_18":{"type":"boolean","example":true,"uniqueKey":"verified.oneOf.0.over_18","typeLabel":"boolean"},"over_21":{"type":"boolean","example":true,"uniqueKey":"verified.oneOf.0.over_21","typeLabel":"boolean"},"given_name":{"type":"string","example":"Alex","uniqueKey":"verified.oneOf.0.given_name","typeLabel":"string"},"family_name":{"type":"string","example":"Doe","uniqueKey":"verified.oneOf.0.family_name","typeLabel":"string"},"birthdate":{"type":"string","description":"Date of birth from the document, `YYYY-MM-DD`.","example":"1990-04-12","uniqueKey":"verified.oneOf.0.birthdate","typeLabel":"string"},"nationality":{"type":"string","description":"ISO 3166-1 alpha-2 country code.","example":"ES","uniqueKey":"verified.oneOf.0.nationality","typeLabel":"string"},"country":{"type":"string","description":"ISO 3166-1 alpha-2 code of the document's country.","example":"ES","uniqueKey":"verified.oneOf.0.country","typeLabel":"string"},"document_verified":{"type":"boolean","example":true,"uniqueKey":"verified.oneOf.0.document_verified","typeLabel":"boolean"},"liveness":{"type":"boolean","example":true,"uniqueKey":"verified.oneOf.0.liveness","typeLabel":"boolean"}},"isRequired":true,"uniqueKey":"verified.oneOf.0","typeLabel":"object"},{"type":"null","description":"Verification level and selected claims, the same object the tokens carry as `verified`, or `null` when there is none. Read this, not `email_verified`, to know whether the person verified their identity.","properties":{"level":{"type":"string","enum":["liveness","liveness_face_match","full_id"],"description":"The highest level passed. From weakest to strongest: `liveness`, `liveness_face_match`, `full_id`.","example":"full_id"},"over_18":{"type":"boolean","example":true},"over_21":{"type":"boolean","example":true},"given_name":{"type":"string","example":"Alex"},"family_name":{"type":"string","example":"Doe"},"birthdate":{"type":"string","description":"Date of birth from the document, `YYYY-MM-DD`.","example":"1990-04-12"},"nationality":{"type":"string","description":"ISO 3166-1 alpha-2 country code.","example":"ES"},"country":{"type":"string","description":"ISO 3166-1 alpha-2 code of the document's country.","example":"ES"},"document_verified":{"type":"boolean","example":true},"liveness":{"type":"boolean","example":true}},"isRequired":true,"uniqueKey":"verified.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"verified","typeLabel":"object | null"},"expires_at":{"type":"string","format":"date-time","description":"When the session ends at the latest. Idle timeout can end it sooner.","example":"2026-11-16T10:41:14.347557Z","isRequired":true,"uniqueKey":"expires_at","typeLabel":"string\u003cdate-time>"},"post_logout_redirect_uri":{"type":"string","description":"Where your application sends the person after sign-out. Empty string when not set.","example":"https://app.example.com/","isRequired":true,"uniqueKey":"post_logout_redirect_uri","typeLabel":"string"},"organizations":{"type":"array","description":"Every customer organization the person belongs to, when organizations are on. Empty otherwise.","items":{"type":"object","required":["organization_id","organization__name","role","custom_role"],"properties":{"organization_id":{"type":"string","format":"uuid","example":"3e9a1f0b-5c2d-4e7f-8a6b-9c0d1e2f3a4b","isRequired":true,"uniqueKey":"organizations.items.[INDEX].organization_id","typeLabel":"string\u003cuuid>"},"organization__name":{"type":"string","description":"The organization's name.","example":"Northwind","isRequired":true,"uniqueKey":"organizations.items.[INDEX].organization__name","typeLabel":"string"},"role":{"type":"string","enum":["admin","member","billing"],"example":"admin","isRequired":true,"uniqueKey":"organizations.items.[INDEX].role","typeLabel":"enum\u003cstring>"},"custom_role":{"oneOf":[{"type":"object","description":"The custom role assigned to the member, or `null`.","required":["key","permissions"],"properties":{"key":{"type":"string","example":"approver","isRequired":true,"uniqueKey":"organizations.items.[INDEX].custom_role.oneOf.0.key","typeLabel":"string"},"permissions":{"type":"array","items":{"type":"string","uniqueKey":"organizations.items.[INDEX].custom_role.oneOf.0.permissions.items.[INDEX]","typeLabel":"string"},"example":["payouts.approve"],"isRequired":true,"uniqueKey":"organizations.items.[INDEX].custom_role.oneOf.0.permissions","typeLabel":"string[]"}},"isRequired":true,"uniqueKey":"organizations.items.[INDEX].custom_role.oneOf.0","typeLabel":"object"},{"type":"null","description":"The custom role assigned to the member, or `null`.","required":["key","permissions"],"properties":{"key":{"type":"string","example":"approver"},"permissions":{"type":"array","items":{"type":"string"},"example":["payouts.approve"]}},"isRequired":true,"uniqueKey":"organizations.items.[INDEX].custom_role.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"organizations.items.[INDEX].custom_role","typeLabel":"object | null"}},"uniqueKey":"organizations.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"organizations","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Session":{"title":"Session","value":{"sub":"1c9d8b88-1bff-43d1-ad7a-88b2bc0024e9","sid":"c9abf6cc-2d64-4bf2-b31e-a4d09a070ab1","application_id":"7b0a6c2e-3f41-4c9a-8d55-1e2f3a4b5c6d","vendor_data":"user-42","amr":["password"],"mfa_verified":false,"email":"person@example.com","email_verified":true,"phone":null,"verified_identity":null,"verified":null,"expires_at":"2026-11-16T10:41:14.347557Z","post_logout_redirect_uri":"","organizations":[]}},"VerifiedMember":{"title":"VerifiedMember","value":{"sub":"1c9d8b88-1bff-43d1-ad7a-88b2bc0024e9","sid":"c9abf6cc-2d64-4bf2-b31e-a4d09a070ab1","application_id":"7b0a6c2e-3f41-4c9a-8d55-1e2f3a4b5c6d","vendor_data":"user-42","amr":["passkey"],"mfa_verified":true,"email":"person@example.com","email_verified":true,"phone":"+34600000000","verified_identity":null,"verified":{"level":"full_id","over_18":true,"given_name":"Alex","country":"ES"},"expires_at":"2026-11-16T10:41:14.347557Z","post_logout_redirect_uri":"https://app.example.com/","organizations":[{"organization_id":"3e9a1f0b-5c2d-4e7f-8a6b-9c0d1e2f3a4b","organization__name":"Northwind","role":"admin","custom_role":null}]}}},"exampleType":"examples"}},"exampleType":"examples"},"44cdc4d4-2e1d-4d6d-8055-3084d2f273c6":{"description":"The access token is missing, malformed, expired, signed by another issuer or key, an ID token, an agent token, or replaced by a refresh; or its session was revoked, idled out, passed its lifetime or no longer meets your MFA policy, or its person was blocked or their email is no longer verified. Send the person through sign-in again.","headers":{"WWW-Authenticate":{"description":"`Bearer`.","schema":{"type":"string","example":"Bearer"}},"Cache-Control":{"description":"Always `no-store`: never cache this response.","schema":{"type":"string","example":"no-store"}},"Pragma":{"description":"Always `no-cache`.","schema":{"type":"string","example":"no-cache"}}},"content":{"application/json":{"schema":{"type":"object","required":["detail"],"properties":{"detail":{"type":"string","example":"invalid_token","isRequired":true,"uniqueKey":"detail","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"InvalidToken":{"title":"InvalidToken","value":{"detail":"invalid_token"}}},"exampleType":"examples"}},"exampleType":"examples"},"c9ea7608-7dba-4ee3-b260-eb295849a378":{"description":"The request carried an `Origin` that is neither the application's own nor in its allowed origins. Server requests send no `Origin`.","headers":{"Cache-Control":{"description":"Always `no-store`: never cache this response.","schema":{"type":"string","example":"no-store"}},"Pragma":{"description":"Always `no-cache`.","schema":{"type":"string","example":"no-cache"}}},"content":{"application/json":{"schema":{"type":"object","required":["detail"],"properties":{"detail":{"type":"string","example":"invalid_token","isRequired":true,"uniqueKey":"detail","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"OriginNotAllowed":{"title":"OriginNotAllowed","value":{"detail":"origin_not_allowed"}}},"exampleType":"examples"}},"exampleType":"examples"},"a0899260-fc87-4e12-96cb-a005e876961c":{"description":"The address belongs to an application, but Authentication is not active for it; on the `apx.didit.me` address, the application ID is unknown. An address that belongs to no application is refused before it reaches the endpoint, and that response is not JSON.","headers":{"Cache-Control":{"description":"Always `no-store`: never cache this response.","schema":{"type":"string","example":"no-store"}},"Pragma":{"description":"Always `no-cache`.","schema":{"type":"string","example":"no-cache"}}},"content":{"application/json":{"schema":{"type":"object","required":["detail"],"properties":{"detail":{"type":"string","example":"invalid_token","isRequired":true,"uniqueKey":"detail","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"ApplicationNotFound":{"title":"ApplicationNotFound","value":{"detail":"No Configuration matches the given query."}}},"exampleType":"examples"}},"exampleType":"examples"},"b452cd7a-6381-45f7-8ee7-09e1b7732702":{"description":"Too many requests from this IP address for this endpoint, or, on a `POST` or `DELETE`, a bot protection bucket is empty. Nothing ran: wait `Retry-After` seconds, then retry.","headers":{"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer","example":60}},"Cache-Control":{"description":"Always `no-store`: never cache this response.","schema":{"type":"string","example":"no-store"}},"Pragma":{"description":"Always `no-cache`.","schema":{"type":"string","example":"no-cache"}}},"content":{"application/json":{"schema":{"type":"object","required":["detail"],"properties":{"detail":{"type":"string","example":"invalid_token","isRequired":true,"uniqueKey":"detail","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"RateLimited":{"title":"RateLimited","value":{"detail":"Too many requests from this IP address. Please wait before trying again. Expected available in 60 seconds."}},"BotProtection":{"title":"BotProtection","value":{"detail":"rate_limited Expected available in 2 seconds."}}},"exampleType":"examples"}},"exampleType":"examples"},"f863f45b-7509-4180-aed0-a5286325a245":{"description":"A service the request depends on is briefly unavailable. Retry with backoff.","headers":{"Cache-Control":{"description":"Always `no-store`: never cache this response.","schema":{"type":"string","example":"no-store"}},"Pragma":{"description":"Always `no-cache`.","schema":{"type":"string","example":"no-cache"}}},"content":{"application/json":{"schema":{"title":"OAuth error","type":"object","description":"An OAuth error (RFC 6749 section 5.2) or a service error.","required":["error"],"properties":{"error":{"type":"string","example":"invalid_grant","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"OAuth error · object"},"examples":{"TemporarilyUnavailable":{"title":"TemporarilyUnavailable","value":{"error":"temporarily_unavailable"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"f16790f5-52e1-4c14-ac4a-a85279c77648":{"AccessToken":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"The person's access token from `POST /token/`: an ES256 JWT with header `typ: at+jwt`, valid for at most 5 minutes. Not your Didit API key.","scopes":[],"schemeName":"AccessToken"}}},"servers":{"59e9eafe-cb78-4241-8800-f0753a9a3cc6":{"url":"https://{issuer}","description":"Your application's issuer: its sign-in origin.","variables":{"issuer":{"default":"your-app.auth.didit.me","description":"The issuer's host: `\u003cname>.auth.didit.me` (live), `\u003cname>.sandbox.auth.didit.me` (sandbox) or your active custom domain."}}}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"The person's access token from `POST /token/`: an ES256 JWT with header `typ: at+jwt`, valid for at most 5 minutes. Not your Didit API key.","scopes":[],"schemeName":"AccessToken"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"The person's access token from `POST /token/`: an ES256 JWT with header `typ: at+jwt`, valid for at most 5 minutes. Not your Didit API key.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"AccessToken","name":"Authorization"}],"title":"AccessToken"}]},"originalFileLocation":"openapi-authentication.json"},"subdomain":"didit-0f962782","siteName":"Didit Docs","title":"Get Session | Didit Authentication API - Didit Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/authentication/api-reference/get-session","matchLevel":0},"es":{"href":"/es","matchLevel":4},"pt-BR":{"href":"/pt-br","matchLevel":4},"ja":{"href":"/ja","matchLevel":4}}},"lastModified":"2026-10-28T18:43:51.042Z","originalFileLocation":"authentication/api-reference/get-session.mdx","locale":"en"},"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=\"GET /session/ checks an access token against the live session: it fails at once after revocation, idle timeout, blocking or a refresh.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Didit Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/didit-0f962782/h7Er2opLBVoQwrdf/_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/didit-0f962782/h7Er2opLBVoQwrdf/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/didit-0f962782/h7Er2opLBVoQwrdf/_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/didit-0f962782/h7Er2opLBVoQwrdf/_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/didit-0f962782/h7Er2opLBVoQwrdf/_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/didit-0f962782/h7Er2opLBVoQwrdf/_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/didit-0f962782/h7Er2opLBVoQwrdf/_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/didit-0f962782/h7Er2opLBVoQwrdf/_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/didit-0f962782/h7Er2opLBVoQwrdf/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get Session | Didit Authentication API - Didit Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"GET /session/ checks an access token against the live session: it fails at once after revocation, idle timeout, blocking or a refresh.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Didit Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.didit.me/authentication/api-reference/get-session\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://didit-0f962782.mintlify.app/_mintlify/api/og/v2?division=API+reference\u0026amp;title=Get+Session+%7C+Didit+Authentication+API\u0026amp;description=GET+%2Fsession%2F+checks+an+access+token+against+the+live+session%3A+it+fails+at+once+after+revocation%2C+idle+timeout%2C+blocking+or+a+refresh.\u0026amp;theme=f6d5c5eb819d99f700ee852a\u0026amp;signature=5a59a2ae5fb7f32453e35651a0cd102ad8e86c8b27580c41b7c1fb9260a112fe\">\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=\"Get Session | Didit Authentication API - Didit Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"GET /session/ checks an access token against the live session: it fails at once after revocation, idle timeout, blocking or a refresh.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://didit-0f962782.mintlify.app/_mintlify/api/og/v2?division=API+reference\u0026amp;title=Get+Session+%7C+Didit+Authentication+API\u0026amp;description=GET+%2Fsession%2F+checks+an+access+token+against+the+live+session%3A+it+fails+at+once+after+revocation%2C+idle+timeout%2C+blocking+or+a+refresh.\u0026amp;theme=f6d5c5eb819d99f700ee852a\u0026amp;signature=5a59a2ae5fb7f32453e35651a0cd102ad8e86c8b27580c41b7c1fb9260a112fe\">\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/didit-0f962782/h7Er2opLBVoQwrdf/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Didit Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2567FF\">\u003cmeta data-mint-head name=\"theme-color\" content=\"#2567FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.didit.me/authentication/api-reference/get-session\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/authentication/api-reference/get-session.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://didit.me/#organization\",\"name\":\"Didit\",\"legalName\":\"Didit Protocol\",\"url\":\"https://didit.me\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://didit.me/logos/primary-horizontal-light.png\"},\"sameAs\":[\"https://www.linkedin.com/company/91001155\",\"https://www.youtube.com/@getdidit\",\"https://github.com/didit-protocol\",\"https://x.com/didit\"]},{\"@type\":\"WebSite\",\"@id\":\"https://docs.didit.me#website\",\"name\":\"Didit Docs\",\"url\":\"https://docs.didit.me\",\"publisher\":{\"@id\":\"https://didit.me/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.didit.me/authentication/api-reference/get-session#webpage\",\"url\":\"https://docs.didit.me/authentication/api-reference/get-session\",\"name\":\"Get Session | Didit Authentication API\",\"description\":\"GET /session/ checks an access token against the live session: it fails at once after revocation, idle timeout, blocking or a refresh.\",\"dateModified\":\"2026-10-28T18:43:51.042Z\",\"isPartOf\":{\"@id\":\"https://docs.didit.me#website\"},\"breadcrumb\":{\"@id\":\"https://docs.didit.me/authentication/api-reference/get-session#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.didit.me/authentication/api-reference/get-session#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Authentication\",\"item\":\"https://docs.didit.me/authentication/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"API reference\",\"item\":\"https://docs.didit.me/authentication/api-reference/get-openid-configuration\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Get Session | Didit Authentication API\",\"item\":\"https://docs.didit.me/authentication/api-reference/get-session\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.didit.me/authentication/api-reference/get-session#apireference\",\"headline\":\"Get Session | Didit Authentication API\",\"name\":\"Get Session | Didit Authentication API\",\"description\":\"GET /session/ checks an access token against the live session: it fails at once after revocation, idle timeout, blocking or a refresh.\",\"url\":\"https://docs.didit.me/authentication/api-reference/get-session\",\"mainEntityOfPage\":{\"@id\":\"https://docs.didit.me/authentication/api-reference/get-session#webpage\"},\"dateModified\":\"2026-10-28T18:43:51.042Z\",\"keywords\":\"session check, token revocation, access token validation, vendor_data, verified claims, Didit Authentication API\",\"publisher\":{\"@id\":\"https://didit.me/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.didit.me#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Didit Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Didit Docs","nav":{"global":{"anchors":[{"anchor":"API Reference","icon":"code","href":"/api-reference/overview"},{"anchor":"Business Console","icon":"gauge","href":"https://business.didit.me"},{"anchor":"OpenAPI Spec","icon":"file-code","href":"https://docs.didit.me/openapi-25.json"},{"anchor":"Integration Prompt","icon":"wand-magic-sparkles","href":"/integration/integration-prompt"},{"anchor":"MCP Server","icon":"plug","href":"/integration/mcp/overview"},{"anchor":"Agent Skills","icon":"robot","href":"https://github.com/didit-protocol/skills"}]},"languages":[{"language":"en","tabs":[{"tab":"Get Started","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/rocket.svg","pages":[{"title":"Get Started","href":""}]},{"tab":"Integrate / SDKs","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/code.svg","groups":[{"group":"Guides","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/book.svg","pages":[{"title":"SDKs \u0026 Integrations: Web, Mobile \u0026 Zapier","sidebarTitle":"SDKs \u0026 Integrations","href":"/integration/sdks"},{"title":"API Full Flow: End-to-End KYC Integration Guide","sidebarTitle":"API Full Flow","href":"/integration/api-full-flow"},{"title":"Webhooks: Real-Time KYC \u0026 KYB Events, HMAC Signing","sidebarTitle":"Webhooks","href":"/integration/webhooks"},{"title":"Alert Webhooks: Team Alerts to Your Endpoint","sidebarTitle":"Alert webhooks","href":"/integration/alert-webhooks"},{"title":"Verification Statuses: Session Lifecycle \u0026 Codes","sidebarTitle":"Verification Statuses","href":"/integration/verification-statuses"},{"title":"API Rate Limiting: Limits, Headers \u0026 429 Backoff","sidebarTitle":"Rate Limiting","href":"/integration/rate-limiting"},{"title":"Sandbox Test Data: Scenarios, Magic Values \u0026 Documents","sidebarTitle":"Sandbox \u0026 Test Data","href":"/integration/sandbox-testing"},{"title":"Programmatic Registration: KYC API for AI Agents","sidebarTitle":"Programmatic Registration","href":"/integration/programmatic-registration"},{"title":"Three-product integration prompt","sidebarTitle":"Integration prompt","href":"/integration/integration-prompt"}]},{"group":"Authentication","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/code.svg","pages":[{"title":"Authentication: End-User Sign-In, Passkeys and Sessions","sidebarTitle":"Authentication","href":"/authentication/overview"},{"group":"Quickstarts","pages":[{"title":"JavaScript quickstart","href":"/authentication/quickstarts/javascript"},{"title":"React quickstart","href":"/authentication/quickstarts/react"},{"title":"Next.js quickstart","href":"/authentication/quickstarts/nextjs"},{"title":"iOS quickstart","href":"/authentication/quickstarts/ios"},{"title":"Android quickstart","href":"/authentication/quickstarts/android"},{"title":"React Native quickstart","href":"/authentication/quickstarts/react-native"},{"title":"Flutter quickstart","href":"/authentication/quickstarts/flutter"}]},{"title":"Sign-In Methods: Passkeys, Codes, Social, SSO","sidebarTitle":"Sign-in methods","href":"/authentication/sign-in-methods"},{"title":"Tokens and JWKS: Verify Didit Authentication JWTs","sidebarTitle":"Tokens and JWKS","href":"/authentication/tokens-and-jwks"},{"title":"Authentication Events and Webhooks","sidebarTitle":"Events and webhooks","href":"/authentication/events-and-webhooks"},{"title":"Migrate Users: Import Passwords and MFA","sidebarTitle":"Migrate your users","href":"/authentication/migration"},{"title":"Bot Protection at Sign-In: Stuffing, Brute Force","sidebarTitle":"Bot protection","href":"/authentication/bot-protection"},{"group":"API reference","pages":[{"title":"Get OpenID Configuration | Didit Authentication API","sidebarTitle":"Get OpenID configuration","openapi":"openapi-authentication.json GET /.well-known/openid-configuration","href":"/authentication/api-reference/get-openid-configuration"},{"title":"Get Signing Keys (JWKS) | Didit Authentication API","sidebarTitle":"Get signing keys (JWKS)","openapi":"openapi-authentication.json GET /.well-known/jwks.json","href":"/authentication/api-reference/get-jwks"},{"title":"Token Endpoint: Code Exchange and Refresh | Didit Authentication API","sidebarTitle":"Exchange or refresh tokens","description":"POST /token/ exchanges a PKCE authorization code or rotates a refresh token. Reusing a refresh token revokes the session.","openapi":"openapi-authentication.json POST /token/","href":"/authentication/api-reference/token"},{"title":"Get Session | Didit Authentication API","sidebarTitle":"Get the session","openapi":"openapi-authentication.json GET /session/","href":"/authentication/api-reference/get-session"},{"title":"Revoke Session (Sign Out) | Didit Authentication API","sidebarTitle":"Revoke the session","description":"DELETE /session/ ends the session behind an access token and returns 204. Its refresh token stops working and session checks fail at once.","openapi":"openapi-authentication.json DELETE /session/","href":"/authentication/api-reference/revoke-session"},{"title":"Create Step-Up | Didit Authentication API","sidebarTitle":"Create a step-up","openapi":"openapi-authentication.json POST /step-up/","href":"/authentication/api-reference/create-step-up"},{"title":"Get Step-Up Status | Didit Authentication API","sidebarTitle":"Get a step-up","openapi":"openapi-authentication.json GET /step-up/{step_up_id}/","href":"/authentication/api-reference/retrieve-step-up"},{"title":"Create Monitoring Token | Didit Authentication API","sidebarTitle":"Create a monitoring token","openapi":"openapi-authentication.json POST /monitoring-token/","href":"/authentication/api-reference/create-monitoring-token"}]}]},{"group":"Model Context Protocol (MCP)","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/code.svg","pages":[{"title":"Didit MCP Server: Identity Verification for AI Agents","sidebarTitle":"Overview","href":"/integration/mcp/overview"},{"title":"Connect Claude to the Didit MCP Server","sidebarTitle":"Connect Claude","href":"/integration/mcp/claude"},{"title":"Install the Didit MCP: Claude, Cursor, VS Code, Windsurf","sidebarTitle":"Installation","href":"/integration/mcp/installation"},{"title":"Didit MCP Authentication: Log in with Didit (OAuth)","sidebarTitle":"Authentication","href":"/integration/mcp/authentication"},{"title":"Didit MCP Tools Reference: 156 Identity Tools","sidebarTitle":"Tools","href":"/integration/mcp/tools"},{"title":"Didit MCP Examples: Prompts \u0026 Agent Conversations","sidebarTitle":"Examples","href":"/integration/mcp/examples"},{"title":"Didit MCP: Advanced, Troubleshooting \u0026 Self-Hosting","sidebarTitle":"Advanced","href":"/integration/mcp/advanced"}]},{"group":"Web SDKs","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/browser.svg","pages":[{"title":"Web Identity Verification SDKs: JS \u0026 Iframe","sidebarTitle":"Web SDKs","href":"/integration/web-sdks/overview"},{"title":"JavaScript Identity Verification SDK: Web KYC","sidebarTitle":"JavaScript SDK","href":"/integration/web-sdks/javascript-sdk"},{"title":"Web Redirect KYC: Hosted Verification Page","sidebarTitle":"Web Redirect","href":"/integration/web-sdks/web-redirect"},{"title":"Iframe Identity Verification: Embedded Web KYC","sidebarTitle":"InContext (Iframe)","href":"/integration/web-sdks/incontext-iframe"},{"title":"WebView KYC: Mobile Identity Verification","sidebarTitle":"WebView Integration","href":"/integration/web-sdks/webview-in-ios-android"}]},{"group":"Native SDKs","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/mobile.svg","pages":[{"title":"Native Mobile KYC SDKs: iOS, Android, RN, Flutter","sidebarTitle":"Native SDKs","href":"/integration/native-sdks/overview"},{"title":"iOS Swift Identity Verification SDK: Mobile KYC","sidebarTitle":"iOS SDK","href":"/integration/native-sdks/ios-sdk"},{"title":"Android Kotlin Identity Verification SDK: KYC","sidebarTitle":"Android SDK","href":"/integration/native-sdks/android-sdk"},{"title":"React Native KYC SDK: Mobile Verification","sidebarTitle":"React Native SDK","href":"/integration/native-sdks/react-native-sdk"},{"title":"Flutter KYC SDK: Dart Mobile Verification","sidebarTitle":"Flutter SDK","href":"/integration/native-sdks/flutter-sdk"}]},{"group":"Integrations","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/puzzle.svg","pages":[{"title":"No-Code KYC Engines: Zapier Identity Automation","sidebarTitle":"No-Code Engine Integrations","href":"/integration/engines/overview"},{"title":"Zapier Identity Verification Automation","sidebarTitle":"Zapier","href":"/integration/engines/zapier"},{"title":"Okta \u0026 Auth0 Identity Verification","href":"/integration/engines/okta-auth0-idv"},{"title":"WordPress KYC Plugin: WooCommerce Age Check","sidebarTitle":"WordPress + WooCommerce","href":"/integration/web-sdks/wordpress-woocommerce"},{"title":"Shopify KYC App - Identity \u0026 Age Verification","sidebarTitle":"Shopify","href":"/integration/web-sdks/shopify"},{"title":"Salesforce Identity Verification App: KYC \u0026 KYB","sidebarTitle":"Salesforce","href":"/integration/web-sdks/salesforce"}]}]},{"tab":"API Reference","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/code.svg","pages":[{"title":"API Reference","href":"/api-reference/overview"}]},{"tab":"User Verification","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/user-verifications.svg","pages":[{"title":"User Verification","href":"/core-technology/liveness/overview"}]},{"tab":"Business Verification","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/business-verifications.svg","pages":[{"title":"Business Verification","href":"/business-verification/overview"}]},{"tab":"Transaction Monitoring","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/transactions.svg","pages":[{"title":"Transaction Monitoring","href":"/transaction-monitoring/overview"}]},{"tab":"Changelog","icon":"https://mintlify.s3.us-west-1.amazonaws.com/didit-0f962782/icons/calendar.svg","pages":[{"title":"Changelog","href":"/changelog/october-2026"}]}]},{"language":"es","pages":[{"title":"es","href":"/es"}]},{"language":"pt-BR","pages":[{"title":"pt-BR","href":"/pt-br"}]},{"language":"ja","pages":[{"title":"ja","href":"/ja"}]}]},"title":"Get Session | Didit Authentication API - Didit Docs","buildId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","deploymentId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DmVyH30O.js","utils-BHQqGGOd.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CD-E4BIt.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp5Lq9Ds.js","snippetPresets-C4xAVCFP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CgXVLxUC.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BF8I5oUf.js","shallow-Byd0lWnC.js","getApiPlaygroundDisplay-BGOZG1OK.js","CodeSnippet-CpvQL0CY.js","CodeSnippets-B8wkBKXa.js","Page-CBCH2P7b.js","getPastedJson-Ry3scI3Y.js","icon-D7a9HcdD.js","MethodPill-CJ8pmHhz.js","DuplicateIcon-rh1HJF0t.js","createIcon-DvGznqYs.js","DynamicMarkdown-Cc6AuSHS.js","SectionHeading-B4A0S-ep.js","axios-vUo_bRtp.js","Markdown-Cc16CX65.js","clsx-Cs6nMGht.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-zbf22OZA.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-C_fs-y5n.js"]}