Polls the status of a previously-created authorization request. Returns
202 Accepted while the request is pending, and 200 OK once it is
completed, expired, or failed.
On the first response with status = completed, the request is marked as
consumed; subsequent calls return 403 Forbidden. Requests older than 15
minutes are automatically transitioned to expired.
Present for non-success statuses (e.g., expired or failed).
Was this page helpful?
⌘I
{"docsConfig":{"theme":"willow","$schema":"https://mintlify.com/docs.json","name":"Submit","colors":{"primary":"#ec3750","light":"#ec3750","dark":"#ec3750"},"logo":{"light":"https://mintcdn.com/hackclub/VBuQuL9JP8HUcTmH/logo/light.svg?fit=max\u0026auto=format\u0026n=VBuQuL9JP8HUcTmH\u0026q=85\u0026s=098270e29f4a744213f97b8a0b0520f9","dark":"https://mintcdn.com/hackclub/VBuQuL9JP8HUcTmH/logo/dark.svg?fit=max\u0026auto=format\u0026n=VBuQuL9JP8HUcTmH\u0026q=85\u0026s=6fc41f7a63ccca2ea0c5540117c733ed"},"favicon":"https://mintcdn.com/hackclub/VBuQuL9JP8HUcTmH/favicon.svg?fit=max\u0026auto=format\u0026n=VBuQuL9JP8HUcTmH\u0026q=85\u0026s=6e20c0df83a390b52b409cf109fa87d9","navbar":{"links":[{"href":"mailto:leo@hackclub.com","label":"Support"}],"primary":{"type":"button","label":"Admin Dashboard","href":"https://submit.hackclub.com/admin"}},"footer":{"socials":{"github":"https://github.com/hackclub","slack":"https://hackclub.slack.com/archives/C09C74HDSE5"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Submit Admin","icon":"user-lock","href":"https://submit.hackclub.com/admin"},{"anchor":"#submit-help","icon":"slack","href":"https://hackclub.slack.com/archives/C09B1B4DZ41"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"hackclub","hasAudioNarration":false,"actualSubdomain":"hackclub","customDomains":["docs.identity.hackclub.com"],"gitSource":{"type":"github","owner":"hackclub","repo":"submit","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a20cb251322614e255af2a7","collectionId":"b035a4f7-4441-4b32-ae02-5320377b42a1","schemaVersion":"v2"},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6a20cb251322614e255af2a7:success","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"Submit","count":7},{"language":"default","tag":"API documentation","count":3},{"language":"default","tag":"Getting started","count":3},{"language":"default","tag":"Advanced","count":1}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"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},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"api-ref/endpoint/authorize-status","slug":"/api-ref/endpoint/authorize-status","pageMetadata":{"title":"Check authorization status","openapi":"GET /api/authorize/{auth_id}/status","description":"Polls the status of a previously-created authorization request. Returns\n`202 Accepted` while the request is pending, and `200 OK` once it is\ncompleted, expired, or failed.\n\nOn the first response with `status = completed`, the request is marked as\nconsumed; subsequent calls return `403 Forbidden`. Requests older than 15\nminutes are automatically transitioned to `expired`.\n","href":"/api-ref/endpoint/authorize-status"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Polls the status of a previously-created authorization request. Returns\\n\", _jsx(_components.code, {\n children: \"202 Accepted\"\n }), \" while the request is pending, and \", _jsx(_components.code, {\n children: \"200 OK\"\n }), \" once it is\\ncompleted, expired, or failed.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"On the first response with \", _jsx(_components.code, {\n children: \"status = completed\"\n }), \", the request is marked as\\nconsumed; subsequent calls return \", _jsx(_components.code, {\n children: \"403 Forbidden\"\n }), \". Requests older than 15\\nminutes are automatically transitioned to \", _jsx(_components.code, {\n children: \"expired\"\n }), \".\"]\n })]\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{jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,ul:`ul`,..._provideComponents(),...props.components};return _jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Checks the current status of an authorization request`}),`\n`,_jsx(_components.li,{children:`Returns completion details if the user has completed the authorization flow`}),`\n`,_jsx(_components.li,{children:`Requires Bearer token authentication with your program API key`}),`\n`,_jsxs(_components.li,{children:[`Poll this endpoint every 2-3 seconds until status becomes `,_jsx(_components.code,{children:`completed`})]}),`\n`]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Check authorization status","openapi":"GET /api/authorize/{auth_id}/status","description":"Polls the status of a previously-created authorization request. Returns\n`202 Accepted` while the request is pending, and `200 OK` once it is\ncompleted, expired, or failed.\n\nOn the first response with `status = completed`, the request is marked as\nconsumed; subsequent calls return `403 Forbidden`. Requests older than 15\nminutes are automatically transitioned to `expired`.\n","href":"/api-ref/endpoint/authorize-status"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Authorization"],"summary":"Check authorization status","description":"Polls the status of a previously-created authorization request. Returns\n`202 Accepted` while the request is pending, and `200 OK` once it is\ncompleted, expired, or failed.\n\nOn the first response with `status = completed`, the request is marked as\nconsumed; subsequent calls return `403 Forbidden`. Requests older than 15\nminutes are automatically transitioned to `expired`.\n","security":["6af5700e-d3ba-4b59-8108-4756bf51c570"],"parameters":["ae5ebee0-c0c1-471f-8300-fd6dc15cc474"],"responses":{"200":"b417a3e9-98ef-4c90-adc6-059652236329","401":"a2e06ab5-5e84-473e-9312-fcbe2d40224e","404":"8fc7a515-4413-4b1a-ab70-6790579f9bd3"},"method":"get","type":"path","servers":["3ca75507-50be-4d2b-ac8e-431b6f6925bf"],"path":"/api/authorize/{auth_id}/status","baseUrlOptions":["https://submit.hackclub.com"],"title":"Check authorization status","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"ae5ebee0-c0c1-471f-8300-fd6dc15cc474":{"name":"auth_id","in":"path","required":true,"description":"The authorization request ID","schema":{"type":"string","format":"uuid","isRequired":true,"description":"The authorization request ID","uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"responses":{"b417a3e9-98ef-4c90-adc6-059652236329":{"description":"Authorization status retrieved successfully","content":{"application/json":{"schema":{"type":"object","required":["auth_id","status","created_at"],"properties":{"auth_id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"auth_id","typeLabel":"string\u003cuuid>"},"status":{"type":"string","enum":["pending","completed","expired","failed"],"description":"Current status of the authorization request","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"created_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"idv_rec":{"type":"string","description":"Identity record ID (only present when status is 'completed')","uniqueKey":"idv_rec","typeLabel":"string"},"completed_at":{"type":"string","format":"date-time","description":"When the authorization was completed (only present when status is 'completed')","uniqueKey":"completed_at","typeLabel":"string\u003cdate-time>"},"verified":{"type":"boolean","description":"Whether the identity is verified and eligible. Present for all statuses to mirror /api/verify (true for completed, false otherwise).","uniqueKey":"verified","typeLabel":"boolean"},"identity_response":{"oneOf":[{"type":"null","description":"Filtered identity fields, mirroring /api/verify. Present when completed; null otherwise.","uniqueKey":"identity_response.oneOf.0","typeLabel":"null"},{"type":"object","description":"Filtered identity fields, mirroring /api/verify. Present when completed; null otherwise.","properties":{"id":{"type":"string","description":"Identity ID","uniqueKey":"identity_response.oneOf.1.id","typeLabel":"string"},"verification_status":{"type":"string","description":"Verification status of the identity","enum":["verified","pending","rejected","unverified"],"uniqueKey":"identity_response.oneOf.1.verification_status","typeLabel":"enum\u003cstring>"},"ysws_eligible":{"type":"boolean","description":"Whether the identity is eligible for YSWS programs (18 and under).","uniqueKey":"identity_response.oneOf.1.ysws_eligible","typeLabel":"boolean"},"email":{"type":"string","format":"email","uniqueKey":"identity_response.oneOf.1.email","typeLabel":"string\u003cemail>"},"first_name":{"type":"string","uniqueKey":"identity_response.oneOf.1.first_name","typeLabel":"string"},"last_name":{"type":"string","uniqueKey":"identity_response.oneOf.1.last_name","typeLabel":"string"},"slack_id":{"type":"string","description":"Slack user ID (available when slack_id scope is enabled for the program)","uniqueKey":"identity_response.oneOf.1.slack_id","typeLabel":"string"},"rejection_reason":{"type":"string","uniqueKey":"identity_response.oneOf.1.rejection_reason","typeLabel":"string"}},"additionalProperties":true,"uniqueKey":"identity_response.oneOf.1","typeLabel":"object"}],"uniqueKey":"identity_response","typeLabel":"null | object"},"error":{"type":"string","description":"Present for non-success statuses (e.g., expired or failed).","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"pending":{"title":"pending","value":{"auth_id":"8eaa8b02-1018-4075-aec0-7872e5db18aa","status":"pending","created_at":"2025-08-27T00:11:18.546Z","verified":false,"identity_response":null}},"completed":{"title":"completed","value":{"auth_id":"8eaa8b02-1018-4075-aec0-7872e5db18aa","status":"completed","created_at":"2025-08-27T00:11:18.546Z","idv_rec":"user123","completed_at":"2025-08-27T00:15:30.123Z","verified":true,"identity_response":{"id":"id_123","verification_status":"verified","ysws_eligible":true,"email":"user@example.com"}}},"expired":{"title":"expired","value":{"auth_id":"8eaa8b02-1018-4075-aec0-7872e5db18aa","status":"expired","created_at":"2025-08-27T00:11:18.546Z","verified":false,"error":"Authorization expired","identity_response":null}}},"exampleType":"examples"}},"exampleType":"examples"},"a2e06ab5-5e84-473e-9312-fcbe2d40224e":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Error message describing what went wrong","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"Invalid or inactive API key"},"examples":{"Example":{"title":"Example","value":{"error":"Invalid or inactive API key"}}},"exampleType":"examples"}},"exampleType":"examples"},"8fc7a515-4413-4b1a-ab70-6790579f9bd3":{"description":"Authorization request not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Error message describing what went wrong","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"Authorization request not found"},"examples":{"Example":{"title":"Example","value":{"error":"Authorization request not found"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"6af5700e-d3ba-4b59-8108-4756bf51c570":{"ApiKeyAuth":{"type":"http","scheme":"bearer","description":"Program API key obtained from the admin dashboard","scopes":[]}}},"servers":{"3ca75507-50be-4d2b-ac8e-431b6f6925bf":{"url":"https://submit.hackclub.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Program API key obtained from the admin dashboard","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Program API key obtained from the admin dashboard","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"ApiKeyAuth","name":"Authorization"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"api-ref/openapi.json"},"subdomain":"hackclub","siteName":"Submit","title":"Check authorization status - Submit","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-05-11T16:27:40.388Z","originalFileLocation":"api-ref/endpoint/authorize-status.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=\"Polls the status of a previously-created authorization request. Returns 202 Accepted while the request is pending, and 200 OK once it is completed, expired, or failed. On the first response with status = completed, the request is marked as consumed; subsequent calls return 403 Forbidden. Requests older than 15 minutes are automatically transitioned to expired.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Submit\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/hackclub/JmVeb5lIHt88MTmC/_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/hackclub/JmVeb5lIHt88MTmC/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/hackclub/JmVeb5lIHt88MTmC/_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/hackclub/JmVeb5lIHt88MTmC/_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/hackclub/JmVeb5lIHt88MTmC/_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/hackclub/JmVeb5lIHt88MTmC/_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/hackclub/JmVeb5lIHt88MTmC/_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/hackclub/JmVeb5lIHt88MTmC/_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/hackclub/JmVeb5lIHt88MTmC/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Check authorization status - Submit\">\u003cmeta data-mint-head property=\"og:description\" content=\"Polls the status of a previously-created authorization request. Returns 202 Accepted while the request is pending, and 200 OK once it is completed, expired, or failed. On the first response with status = completed, the request is marked as consumed; subsequent calls return 403 Forbidden. Requests older than 15 minutes are automatically transitioned to expired.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Submit\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.identity.hackclub.com/api-ref/endpoint/authorize-status\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://hackclub.mintlify.app/_mintlify/api/og/v2?division=API+documentation\u0026amp;title=Check+authorization+status\u0026amp;description=Polls+the+status+of+a+previously-created+authorization+request.+Returns%0A%60202+Accepted%60+while+the+request+is+pending%2C+and+%60200+OK%60+once+it+is%0Acompleted%2C+expired%2C\u0026amp;theme=ab6d80e4f5e90be2d30e57e6\u0026amp;signature=e78a5c036ee67ab95a4c6054933d9c74796a56ad353d2baf656688e8831e1006\">\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=\"Check authorization status - Submit\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Polls the status of a previously-created authorization request. Returns 202 Accepted while the request is pending, and 200 OK once it is completed, expired, or failed. On the first response with status = completed, the request is marked as consumed; subsequent calls return 403 Forbidden. Requests older than 15 minutes are automatically transitioned to expired.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://hackclub.mintlify.app/_mintlify/api/og/v2?division=API+documentation\u0026amp;title=Check+authorization+status\u0026amp;description=Polls+the+status+of+a+previously-created+authorization+request.+Returns%0A%60202+Accepted%60+while+the+request+is+pending%2C+and+%60200+OK%60+once+it+is%0Acompleted%2C+expired%2C\u0026amp;theme=ab6d80e4f5e90be2d30e57e6\u0026amp;signature=e78a5c036ee67ab95a4c6054933d9c74796a56ad353d2baf656688e8831e1006\">\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/hackclub/JmVeb5lIHt88MTmC/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Submit\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#ec3750\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.identity.hackclub.com/api-ref/endpoint/authorize-status\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-ref/endpoint/authorize-status.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.identity.hackclub.com/#organization\",\"name\":\"Submit\",\"url\":\"https://docs.identity.hackclub.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/hackclub/VBuQuL9JP8HUcTmH/logo/light.svg?fit=max\u0026auto=format\u0026n=VBuQuL9JP8HUcTmH\u0026q=85\u0026s=098270e29f4a744213f97b8a0b0520f9\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.identity.hackclub.com#website\",\"name\":\"Submit\",\"url\":\"https://docs.identity.hackclub.com\",\"publisher\":{\"@id\":\"https://docs.identity.hackclub.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.identity.hackclub.com/api-ref/endpoint/authorize-status#webpage\",\"url\":\"https://docs.identity.hackclub.com/api-ref/endpoint/authorize-status\",\"name\":\"Check authorization status\",\"description\":\"Polls the status of a previously-created authorization request. Returns 202 Accepted while the request is pending, and 200 OK once it is completed, expired, or failed. On the first response with status = completed, the request is marked as consumed; subsequent calls return 403 Forbidden. Requests older than 15 minutes are automatically transitioned to expired.\",\"dateModified\":\"2026-05-11T16:27:40.388Z\",\"isPartOf\":{\"@id\":\"https://docs.identity.hackclub.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.identity.hackclub.com/api-ref/endpoint/authorize-status#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.identity.hackclub.com/api-ref/endpoint/authorize-status#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API documentation\",\"item\":\"https://docs.identity.hackclub.com/api-ref/endpoint/verify\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Check authorization status\",\"item\":\"https://docs.identity.hackclub.com/api-ref/endpoint/authorize-status\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.identity.hackclub.com/api-ref/endpoint/authorize-status#apireference\",\"headline\":\"Check authorization status\",\"name\":\"Check authorization status\",\"description\":\"Polls the status of a previously-created authorization request. Returns 202 Accepted while the request is pending, and 200 OK once it is completed, expired, or failed. On the first response with status = completed, the request is marked as consumed; subsequent calls return 403 Forbidden. Requests older than 15 minutes are automatically transitioned to expired.\",\"url\":\"https://docs.identity.hackclub.com/api-ref/endpoint/authorize-status\",\"mainEntityOfPage\":{\"@id\":\"https://docs.identity.hackclub.com/api-ref/endpoint/authorize-status#webpage\"},\"dateModified\":\"2026-05-11T16:27:40.388Z\",\"publisher\":{\"@id\":\"https://docs.identity.hackclub.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.identity.hackclub.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Submit\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Submit","nav":{"global":{"anchors":[{"anchor":"Submit Admin","icon":"user-lock","href":"https://submit.hackclub.com/admin"},{"anchor":"#submit-help","icon":"slack","href":"https://hackclub.slack.com/archives/C09B1B4DZ41"}]},"tabs":[{"tab":"Submit","groups":[{"group":"Getting started","pages":[{"title":"Introduction","icon":"wave","href":""},{"title":"Quickstart","icon":"rocket","href":"/quickstart"},{"title":"Configuration","icon":"gear","href":"/settings"}]},{"group":"Advanced","pages":[{"title":"Headless Integration","href":"/headless"}]},{"group":"API documentation","pages":[{"title":"Verify session","openapi":"GET /api/verify","href":"/api-ref/endpoint/verify"},{"title":"Create authorization request","openapi":"POST /api/authorize","description":"Creates a new authorization request scoped to the program identified by the\nbearer API key. Returns a popup URL the end user must open to complete\nidentity authorization. Requests expire after 15 minutes.\n","href":"/api-ref/endpoint/authorize"},{"title":"Check authorization status","openapi":"GET /api/authorize/{auth_id}/status","href":"/api-ref/endpoint/authorize-status"}]}]}]},"basePath":"","title":"Check authorization status - Submit","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CS552b7R.js","utils-DDTCYAF2.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-De8ttokP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DrwRDvAh.js","snippetPresets-DtAN0nWx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D5rWArI6.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-O2i12wsz.js","shallow-DV8xABTt.js","getApiPlaygroundDisplay-DBZ0B5Jx.js","CodeSnippet-BVi0tPUX.js","CodeSnippets-CqASbIwY.js","Page-m07pfKpT.js","getPastedJson-DG9vsMS8.js","icon-CXzRSCr8.js","MethodPill-BdKVtEuX.js","DuplicateIcon-CZlmBrJI.js","createIcon-biFEUKPL.js","DynamicMarkdown-B54_zNBF.js","SectionHeading-DwwHK3Pt.js","axios-vUo_bRtp.js","Markdown-DfhCTwyA.js","clsx-xpJZXxdP.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BTZUMDnx.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DqdKa2R4.js"]}