Returns entitlement records for the requested user_id when the user is associated with your firm. Each record includes the overall entitlement status and your firm’s status for that entitlement, when available.
GET
/
api
/
entitlements
/
user-entitlements
/
{user_id}
/
Retrieve user entitlements by user_id
curl --request GET \ --url https://api.example.com/api/entitlements/user-entitlements/{user_id}/ \ --header 'Authorization: <api-key>'
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Ignite API","colors":{"primary":"#3B82F6","light":"#0085FF","dark":"#2563EB"},"logo":{"light":"https://mintcdn.com/tickblaze/LyaG4yU0RLGol6cN/logo/light.webp?fit=max\u0026auto=format\u0026n=LyaG4yU0RLGol6cN\u0026q=85\u0026s=fe4d152a21d32c41add95b18571f5111","dark":"https://mintcdn.com/tickblaze/LyaG4yU0RLGol6cN/logo/dark.webp?fit=max\u0026auto=format\u0026n=LyaG4yU0RLGol6cN\u0026q=85\u0026s=0d1226b0b27755d07d1e476572d8170b"},"favicon":"https://mintcdn.com/tickblaze/LyaG4yU0RLGol6cN/favicon.webp?fit=max\u0026auto=format\u0026n=LyaG4yU0RLGol6cN\u0026q=85\u0026s=1e0764bf9b8d7e85a46b34dba53db935","contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"tickblaze","hasAudioNarration":false,"actualSubdomain":"tickblaze","customDomains":[],"gitSource":{"type":"github","owner":"tickblaze","repo":"ignite_documentation","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6a92078a528c608ca302fdf5","clientVersion":"0.0.4094","searchFilterCounts":[{"language":"default","tag":"API reference","count":35},{"language":"default","tag":"Accounts","count":10},{"language":"default","tag":"Users","count":10},{"language":"default","tag":"Guides","count":9},{"language":"default","tag":"Trade","count":4},{"language":"default","tag":"Firm onboarding","count":3},{"language":"default","tag":"Get started","count":3},{"language":"default","tag":"Entitlements","count":3},{"language":"default","tag":"withdrawals","count":3},{"language":"default","tag":"Operations","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/entitlements/retrieve-user-entitlements-by-user_id","slug":"/api-reference/entitlements/retrieve-user-entitlements-by-user_id","pageMetadata":{"title":"Retrieve user entitlements by user_id","description":"Returns entitlement records for the requested `user_id` when the user is associated with your firm. Each record includes the overall entitlement status and your firm's status for that entitlement, when available.","deprecated":null,"version":null,"openapi":"/openapi.json get /api/entitlements/user-entitlements/{user_id}/","href":"/api-reference/entitlements/retrieve-user-entitlements-by-user_id","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {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(_components.p, {\n children: [\"Returns entitlement records for the requested \", _jsx(_components.code, {\n children: \"user_id\"\n }), \" when the user is associated with your firm. Each record includes the overall entitlement status and your firm’s status for that entitlement, when available.\"]\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}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}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":"Retrieve user entitlements by user_id","description":"Returns entitlement records for the requested `user_id` when the user is associated with your firm. Each record includes the overall entitlement status and your firm's status for that entitlement, when available.","deprecated":null,"version":null,"openapi":"/openapi.json get /api/entitlements/user-entitlements/{user_id}/","href":"/api-reference/entitlements/retrieve-user-entitlements-by-user_id","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"api_entitlements_user_entitlements_retrieve","description":"Returns entitlement records for the requested `user_id` when the user is associated with your firm. Each record includes the overall entitlement status and your firm's status for that entitlement, when available.","summary":"Retrieve user entitlements by user_id","parameters":["55baa249-0d52-40ef-bd20-3ebcfa590c2a"],"tags":["Entitlements"],"security":["17549f39-16d3-40e2-87ac-f4608ed459b3"],"responses":{"200":"da21dc91-f92f-404e-8ae5-f3ec6cf6175e"},"method":"get","type":"path","servers":[],"path":"/api/entitlements/user-entitlements/{user_id}/","baseUrlOptions":[],"title":"Retrieve user entitlements by user_id","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"55baa249-0d52-40ef-bd20-3ebcfa590c2a":{"in":"path","name":"user_id","schema":{"type":"integer","isRequired":true,"description":"Trader user id whose entitlement records should be returned.","uniqueKey":"","typeLabel":"integer"},"description":"Trader user id whose entitlement records should be returned.","required":true}},"responses":{"da21dc91-f92f-404e-8ae5-f3ec6cf6175e":{"content":{"application/json":{"schema":{"type":"object","required":["meta","results"],"properties":{"meta":{"type":"object","required":["count","page","page_size","total_pages","has_next","has_previous","next","previous"],"description":"Pagination metadata. Use `has_next`/`has_previous` for boolean page checks and `next`/`previous` for page URLs.","example":{"count":123,"page":1,"page_size":20,"total_pages":7,"has_next":true,"has_previous":false,"next":"https://api.example.org/resources/?page=2","previous":null},"properties":{"count":{"type":"integer","example":123,"description":"Total number of items matching the request.","isRequired":true,"uniqueKey":"meta.count","typeLabel":"integer"},"page":{"type":"integer","example":1,"description":"Current 1-indexed page number.","isRequired":true,"uniqueKey":"meta.page","typeLabel":"integer"},"page_size":{"type":"integer","example":20,"description":"Number of items returned per page.","isRequired":true,"uniqueKey":"meta.page_size","typeLabel":"integer"},"total_pages":{"type":"integer","example":7,"description":"Total number of pages available.","isRequired":true,"uniqueKey":"meta.total_pages","typeLabel":"integer"},"has_next":{"type":"boolean","example":true,"description":"Whether another page is available after this one.","isRequired":true,"uniqueKey":"meta.has_next","typeLabel":"boolean"},"has_previous":{"type":"boolean","example":false,"description":"Whether a page is available before this one.","isRequired":true,"uniqueKey":"meta.has_previous","typeLabel":"boolean"},"next":{"oneOf":[{"type":"string","format":"uri","example":"http://api.example.org/accounts/?page=2","description":"URL for the next page, or null on the final page.","isRequired":true,"uniqueKey":"meta.next.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","example":"http://api.example.org/accounts/?page=2","description":"URL for the next page, or null on the final page.","isRequired":true,"uniqueKey":"meta.next.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"meta.next","typeLabel":"string\u003curi> | null"},"previous":{"oneOf":[{"type":"string","format":"uri","example":null,"description":"URL for the previous page, or null on the first page.","isRequired":true,"uniqueKey":"meta.previous.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","example":null,"description":"URL for the previous page, or null on the first page.","isRequired":true,"uniqueKey":"meta.previous.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"meta.previous","typeLabel":"string\u003curi> | null"}},"isRequired":true,"uniqueKey":"meta","typeLabel":"object"},"results":{"type":"array","items":{"type":"object","description":"Aggregate user entitlement with active-firm status context.","properties":{"user_id":{"type":"integer","readOnly":true,"description":"User id for the entitlement holder.","isRequired":true,"uniqueKey":"results.items.[INDEX].user_id","typeLabel":"integer"},"user_email":{"type":"string","format":"email","readOnly":true,"description":"Email address of the user this entitlement applies to.","isRequired":true,"uniqueKey":"results.items.[INDEX].user_email","typeLabel":"string\u003cemail>"},"entitlement":{"type":"object","description":"Entitlement details for this user.","required":["data_level","exchanges","name"],"properties":{"name":{"type":"string","description":"Human-readable entitlement name.","maxLength":64,"isRequired":true,"uniqueKey":"results.items.[INDEX].entitlement.name","typeLabel":"string"},"data_level":{"type":"string","description":"Market-data depth or package tier for this entitlement.\n\n* `l1` - Level 1\n* `l2` - Level 2","enum":["l1","l2"],"isRequired":true,"uniqueKey":"results.items.[INDEX].entitlement.data_level","typeLabel":"enum\u003cstring>"},"exchanges":{"type":"array","items":{"type":"string","uniqueKey":"results.items.[INDEX].entitlement.exchanges.items.[INDEX]","typeLabel":"string"},"readOnly":true,"description":"Exchange codes covered by this entitlement.","isRequired":true,"uniqueKey":"results.items.[INDEX].entitlement.exchanges","typeLabel":"string[]"}},"isRequired":true,"uniqueKey":"results.items.[INDEX].entitlement","typeLabel":"object"},"status":{"type":"string","description":"Overall entitlement status for this user across eligible sources. `AUTHORIZED` takes precedence over `PENDING`; `PENDING` takes precedence over `REVOKED`.\n\n* `PENDING` - Pending Authorization\n* `AUTHORIZED` - Authorized\n* `REVOKED` - Revoked","enum":["PENDING","AUTHORIZED","REVOKED"],"isRequired":true,"uniqueKey":"results.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"firm_status":{"oneOf":[{"type":"string","readOnly":true,"description":"Status of your firm's entitlement for this user. This can differ from `status` when the user remains eligible through another source.","isRequired":true,"uniqueKey":"results.items.[INDEX].firm_status.oneOf.0","typeLabel":"string"},{"type":"null","readOnly":true,"description":"Status of your firm's entitlement for this user. This can differ from `status` when the user remains eligible through another source.","isRequired":true,"uniqueKey":"results.items.[INDEX].firm_status.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.items.[INDEX].firm_status","typeLabel":"string | null"},"created":{"type":"string","format":"date-time","readOnly":true,"description":"Timestamp when this overall entitlement record was created.","isRequired":true,"uniqueKey":"results.items.[INDEX].created","typeLabel":"string\u003cdate-time>"}},"required":["created","entitlement","firm_status","status","user_email","user_id"],"uniqueKey":"results.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"results","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"meta":{"count":123,"page":1,"page_size":20,"total_pages":7,"has_next":true,"has_previous":false,"next":"https://api.example.org/resources/?page=2","previous":null},"results":[{"user_id":123,"user_email":"jsmith@example.com","entitlement":{"name":"\u003cstring>","data_level":"l1","exchanges":["\u003cstring>"]},"status":"PENDING","firm_status":"\u003cstring>","created":"2023-11-07T05:31:56Z"}]}}},"exampleType":"generated"}},"description":"","exampleType":"generated"}},"security":{"17549f39-16d3-40e2-87ac-f4608ed459b3":{"tokenAuth":{"type":"apiKey","in":"header","name":"Authorization","description":"Token-based authentication with required prefix \"Token\"","scopes":[]}}},"servers":{},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"Authorization","description":"Token-based authentication with required prefix \"Token\"","scopes":[]},"schema":{"title":"Authorization","type":"string","description":"Token-based authentication with required prefix \"Token\"","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"tokenAuth","name":"Authorization"}],"title":"tokenAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"tickblaze","siteName":"Ignite API","title":"Retrieve user entitlements by user_id - Ignite API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-28T22:11:27.336Z","originalFileLocation":"api-reference/entitlements/retrieve-user-entitlements-by-user_id.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=\"Returns entitlement records for the requested user_id when the user is associated with your firm. Each record includes the overall entitlement status and your firm\u0026#x27;s status for that entitlement, when available.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Ignite API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/tickblaze/XWSaL7nm9xiQNJDY/_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/tickblaze/XWSaL7nm9xiQNJDY/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/tickblaze/XWSaL7nm9xiQNJDY/_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/tickblaze/XWSaL7nm9xiQNJDY/_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/tickblaze/XWSaL7nm9xiQNJDY/_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/tickblaze/XWSaL7nm9xiQNJDY/_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/tickblaze/XWSaL7nm9xiQNJDY/_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/tickblaze/XWSaL7nm9xiQNJDY/_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/tickblaze/XWSaL7nm9xiQNJDY/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Retrieve user entitlements by user_id - Ignite API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns entitlement records for the requested user_id when the user is associated with your firm. Each record includes the overall entitlement status and your firm\u0026#x27;s status for that entitlement, when available.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Ignite API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://tickblaze.mintlify.app/api-reference/entitlements/retrieve-user-entitlements-by-user_id\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://tickblaze.mintlify.site/_mintlify/api/og/v2?division=Entitlements\u0026amp;title=Retrieve+user+entitlements+by+user_id\u0026amp;description=Returns+entitlement+records+for+the+requested+%60user_id%60+when+the+user+is+associated+with+your+firm.+Each+record+includes+the+overall+entitlement+status+and+your\u0026amp;theme=2fd322792c8ee4df87f64ccb\u0026amp;signature=0a92be78ceb950dd13023473cf84622dc4ae1188daba17e000ef7e47da985b68\">\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=\"Retrieve user entitlements by user_id - Ignite API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns entitlement records for the requested user_id when the user is associated with your firm. Each record includes the overall entitlement status and your firm\u0026#x27;s status for that entitlement, when available.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://tickblaze.mintlify.site/_mintlify/api/og/v2?division=Entitlements\u0026amp;title=Retrieve+user+entitlements+by+user_id\u0026amp;description=Returns+entitlement+records+for+the+requested+%60user_id%60+when+the+user+is+associated+with+your+firm.+Each+record+includes+the+overall+entitlement+status+and+your\u0026amp;theme=2fd322792c8ee4df87f64ccb\u0026amp;signature=0a92be78ceb950dd13023473cf84622dc4ae1188daba17e000ef7e47da985b68\">\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/tickblaze/XWSaL7nm9xiQNJDY/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Ignite API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3B82F6\">\u003clink data-mint-head rel=\"canonical\" href=\"https://tickblaze.mintlify.app/api-reference/entitlements/retrieve-user-entitlements-by-user_id\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/entitlements/retrieve-user-entitlements-by-user_id.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://tickblaze.mintlify.app/#organization\",\"name\":\"Ignite API\",\"url\":\"https://tickblaze.mintlify.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/tickblaze/LyaG4yU0RLGol6cN/logo/light.webp?fit=max\u0026auto=format\u0026n=LyaG4yU0RLGol6cN\u0026q=85\u0026s=fe4d152a21d32c41add95b18571f5111\"}},{\"@type\":\"WebSite\",\"@id\":\"https://tickblaze.mintlify.app#website\",\"name\":\"Ignite API\",\"url\":\"https://tickblaze.mintlify.app\",\"publisher\":{\"@id\":\"https://tickblaze.mintlify.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://tickblaze.mintlify.app/api-reference/entitlements/retrieve-user-entitlements-by-user_id#webpage\",\"url\":\"https://tickblaze.mintlify.app/api-reference/entitlements/retrieve-user-entitlements-by-user_id\",\"name\":\"Retrieve user entitlements by user_id\",\"description\":\"Returns entitlement records for the requested user_id when the user is associated with your firm. Each record includes the overall entitlement status and your firm's status for that entitlement, when available.\",\"dateModified\":\"2026-08-28T22:11:27.336Z\",\"isPartOf\":{\"@id\":\"https://tickblaze.mintlify.app#website\"},\"breadcrumb\":{\"@id\":\"https://tickblaze.mintlify.app/api-reference/entitlements/retrieve-user-entitlements-by-user_id#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://tickblaze.mintlify.app/api-reference/entitlements/retrieve-user-entitlements-by-user_id#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Entitlements\",\"item\":\"https://tickblaze.mintlify.app/api-reference/entitlements/list-user-entitlements\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Retrieve user entitlements by user_id\",\"item\":\"https://tickblaze.mintlify.app/api-reference/entitlements/retrieve-user-entitlements-by-user_id\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://tickblaze.mintlify.app/api-reference/entitlements/retrieve-user-entitlements-by-user_id#apireference\",\"headline\":\"Retrieve user entitlements by user_id\",\"name\":\"Retrieve user entitlements by user_id\",\"description\":\"Returns entitlement records for the requested user_id when the user is associated with your firm. Each record includes the overall entitlement status and your firm's status for that entitlement, when available.\",\"url\":\"https://tickblaze.mintlify.app/api-reference/entitlements/retrieve-user-entitlements-by-user_id\",\"mainEntityOfPage\":{\"@id\":\"https://tickblaze.mintlify.app/api-reference/entitlements/retrieve-user-entitlements-by-user_id#webpage\"},\"dateModified\":\"2026-08-28T22:11:27.336Z\",\"publisher\":{\"@id\":\"https://tickblaze.mintlify.app/#organization\"},\"isPartOf\":{\"@id\":\"https://tickblaze.mintlify.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Ignite API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Ignite API","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API reference","groups":[{"group":"Accounts","pages":[{"title":"Create a trading account","deprecated":null,"version":null,"openapi":"/openapi.json post /api/accounts/","href":"/api-reference/accounts/create-a-trading-account"},{"title":"Retrieve trading account information","deprecated":null,"version":null,"openapi":"/openapi.json get /api/accounts/{id}/","href":"/api-reference/accounts/retrieve-trading-account-information"},{"title":"Deactivate a trading account","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/accounts/{id}/deactivate/","href":"/api-reference/accounts/deactivate-a-trading-account"},{"title":"Reactivate a trading account","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/accounts/{id}/reactivate/","href":"/api-reference/accounts/reactivate-a-trading-account"},{"title":"Adjust balance for trading accounts","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/accounts/balance/","href":"/api-reference/accounts/adjust-balance-for-trading-accounts"},{"title":"Get balance, equity and reporting fields for accounts","deprecated":null,"version":null,"openapi":"/openapi.json get /api/accounts/balance-equity/","href":"/api-reference/accounts/get-balance-equity-and-reporting-fields-for-accounts"},{"title":"List disabled trading accounts","deprecated":null,"version":null,"openapi":"/openapi.json get /api/accounts/disabled/","href":"/api-reference/accounts/list-disabled-trading-accounts"},{"title":"Bulk reactivate trading accounts","deprecated":null,"version":null,"openapi":"/openapi.json post /api/accounts/reactivate/","href":"/api-reference/accounts/bulk-reactivate-trading-accounts"},{"title":"Update trading account statuses","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/accounts/status/","href":"/api-reference/accounts/update-trading-account-statuses"},{"title":"List accounts with optional field selection and nested objects","deprecated":null,"version":null,"openapi":"/openapi.json get /api/accounts/summary/","href":"/api-reference/accounts/list-accounts-with-optional-field-selection-and-nested-objects"}]},{"group":"Challenge","pages":[{"title":"List Challenges","deprecated":null,"version":null,"openapi":"/openapi.json get /api/challenges/","href":"/api-reference/challenge/list-challenges"}]},{"group":"Entitlements","pages":[{"title":"List user entitlements","description":"Returns a paginated list of user entitlement records for users associated with your firm. Each record includes the overall entitlement status and your firm's status for that entitlement, when available.","deprecated":null,"version":null,"openapi":"/openapi.json get /api/entitlements/user-entitlements/","href":"/api-reference/entitlements/list-user-entitlements"},{"title":"Retrieve user entitlements by user_id","deprecated":null,"version":null,"openapi":"/openapi.json get /api/entitlements/user-entitlements/{user_id}/","href":"/api-reference/entitlements/retrieve-user-entitlements-by-user_id"},{"title":"Authorize or revoke user entitlements","description":"Update your firm's entitlement status for the requested user and entitlement package. L2 market data access may be created directly. L1 access can be updated only when the user already has L1 eligibility. Call `PATCH /api/users/{user_id}/entitlements/` using the `user_id` value returned by `GET /api/entitlements/user-entitlements/`, and pass either the entitlement name or exchange codes plus level in the request body to identify which package should be changed. Use `AUTHORIZED` to grant access, `REVOKED` to remove access, or `PENDING` to restore a pending state for your firm. Revoking access for your firm may not change the entitlement status shown by later entitlement reads if the user remains eligible through another source.","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/users/{user_id}/entitlements/","href":"/api-reference/entitlements/authorize-or-revoke-user-entitlements"}]},{"group":"Status","pages":[{"title":"Health probe","deprecated":null,"version":null,"openapi":"/openapi.json get /api/health/","href":"/api-reference/status/health-probe"},{"title":"Scheduled outage status","deprecated":null,"version":null,"openapi":"/openapi.json get /api/maintenance/","href":"/api-reference/status/scheduled-outage-status"}]},{"group":"Trade","pages":[{"title":"Submit close requests for all open positions for an account","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/trade/accounts/{account_id}/positions/close/","href":"/api-reference/trade/submit-close-requests-for-all-open-positions-for-an-account"},{"title":"Submit close requests for all open positions for an account","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/trade/accounts/positions/close/","href":"/api-reference/trade/submit-close-requests-for-all-open-positions-for-an-account-1"},{"title":"List positions across accessible accounts","deprecated":null,"version":null,"openapi":"/openapi.json get /api/trade/positions/","href":"/api-reference/trade/list-positions-across-accessible-accounts"},{"title":"Submit a close request for one account and symbol","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/trade/positions/close/","href":"/api-reference/trade/submit-a-close-request-for-one-account-and-symbol"}]},{"group":"Users","pages":[{"title":"List users","deprecated":null,"version":null,"openapi":"/openapi.json get /api/users/","href":"/api-reference/users/list-users"},{"title":"Create a trader user","deprecated":null,"version":null,"openapi":"/openapi.json post /api/users/","href":"/api-reference/users/create-a-trader-user"},{"title":"Retrieve user details","deprecated":null,"version":null,"openapi":"/openapi.json get /api/users/{id}/","href":"/api-reference/users/retrieve-user-details"},{"title":"Update user contact details","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/users/{id}/","href":"/api-reference/users/update-user-contact-details"},{"title":"Get per-user account counts","deprecated":null,"version":null,"openapi":"/openapi.json get /api/users/{id}/accounts/stats/","href":"/api-reference/users/get-per-user-account-counts"},{"title":"Deactivate a user","deprecated":null,"version":null,"openapi":"/openapi.json post /api/users/{id}/deactivate/","href":"/api-reference/users/deactivate-a-user"},{"title":"Get user entitlements by token","deprecated":null,"version":null,"openapi":"/openapi.json get /api/users/{id}/entitlements/","href":"/api-reference/users/get-user-entitlements-by-token"},{"title":"Reactivate a user","deprecated":null,"version":null,"openapi":"/openapi.json post /api/users/{id}/reactivate/","href":"/api-reference/users/reactivate-a-user"},{"title":"List entitlement flags by user","deprecated":null,"version":null,"openapi":"/openapi.json get /api/users/entitlements/","href":"/api-reference/users/list-entitlement-flags-by-user"},{"title":"Export users CSV","deprecated":null,"version":null,"openapi":"/openapi.json get /api/users/export/","href":"/api-reference/users/export-users-csv"}]},{"group":"withdrawals","pages":[{"title":"List withdrawals","deprecated":null,"version":null,"openapi":"/openapi.json get /api/withdrawals/","href":"/api-reference/withdrawals/list-withdrawals"},{"title":"Check potential withdrawal details","deprecated":null,"version":null,"openapi":"/openapi.json get /api/withdrawals/{account_id}/request/","href":"/api-reference/withdrawals/check-potential-withdrawal-details"},{"title":"Request a withdrawal","deprecated":null,"version":null,"openapi":"/openapi.json post /api/withdrawals/{account_id}/request/","href":"/api-reference/withdrawals/request-a-withdrawal"}]},{"group":"Auth","pages":[{"title":"Authenticate a user","deprecated":null,"version":null,"openapi":"/openapi.json post /auth/login/","href":"/api-reference/auth/authenticate-a-user"},{"title":"Refresh access token","deprecated":null,"version":null,"openapi":"/openapi.json post /auth/refresh/","href":"/api-reference/auth/refresh-access-token"}]}]}]},"basePath":"","title":"Retrieve user entitlements by user_id - Ignite API","buildId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","deploymentId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C-hEh3I2.js","utils-CnF4QiUD.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C7PVNbel.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-8ytevL2A.js","snippetPresets-BT1alx3v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BLXC0i_W.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CyLIGI9_.js","shallow-DC0lGVIW.js","getApiPlaygroundDisplay-CgDQ85tN.js","CodeSnippet-6-I-Gpv9.js","CodeSnippets-BAk1kDdu.js","Page-C945cI-W.js","getPastedJson-B276RuWN.js","icon-BqP8etTm.js","MethodPill-DM6sbxG1.js","DuplicateIcon-PyJglOaE.js","createIcon-CMeOMAc_.js","DynamicMarkdown-BoyYAA8K.js","SectionHeading-DAYv3gvZ.js","axios-vUo_bRtp.js","Markdown-BhTTmazV.js","clsx-CR-RHrVC.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CBUH0-zX.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BmARFYNC.js"]}