Requires scopeorganization:read · Minimum role viewer
Who is calling and what they can do: the user (null for a service token), the token’s kind and expiry, the organization the token is bound to, the role, the effective scopes for this request, which products are on for the organization, and the user’s other organizations for a switcher. A client’s first call after sign-in. Requires only organization:read, which every role holds.
A Dueflow access token: dfp_ (personal) or dfs_ (service). Permissions are the token's scopes intersected with the role ceiling, re-evaluated per request.
Which products are enabled for the organization: false means the product isn't enabled here, so hide its screens. A product also reads false when the organization can't have it (collections is chapter-only) or this credential's scopes reach none of its endpoints
Every organization the user belongs to, for an organization switcher. Informational: the credential stays bound to organization, so acting on another one takes a credential for it. Empty for a service token. Apps you authorized see only the organization you chose
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Dueflow API","description":"The Dueflow API: read your roster, groups, payments and reimbursements, and write back to them.","colors":{"primary":"#0075FA","light":"#66AEFF","dark":"#0075FA"},"logo":{"light":"https://mintcdn.com/dueflow/WUtCzXvACilGZRqa/logo/wordmark-dark.png?fit=max\u0026auto=format\u0026n=WUtCzXvACilGZRqa\u0026q=85\u0026s=ba1c5ccedabc26b8b53f96e8d5d79797","dark":"https://mintcdn.com/dueflow/WUtCzXvACilGZRqa/logo/wordmark-light.png?fit=max\u0026auto=format\u0026n=WUtCzXvACilGZRqa\u0026q=85\u0026s=45b4e3f3b7ec5cc70d858c1953f38df6","href":"https://dueflow.co"},"favicon":"https://mintcdn.com/dueflow/zkTpZhybx4bM-Y5e/favicon.png?fit=max\u0026auto=format\u0026n=zkTpZhybx4bM-Y5e\u0026q=85\u0026s=aca7b97bfb715d779c53bb2e2cf57962","appearance":{"default":"system"},"background":{"color":{"light":"#FCFCFC","dark":"#18181B"}},"navbar":{"links":[{"href":"mailto:hello@dueflow.co","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://dueflow.co/profile/developer"}},"footer":{"socials":{"website":"https://dueflow.co","x":"https://x.com/dueflow_co","github":"https://github.com/dueflow-co"}},"seo":{"metatags":{"og:site_name":"Dueflow API"}},"fonts":{"heading":{"family":"Gilroy","weight":700,"source":"fonts/gilroy-bold.woff2","format":"woff2"},"body":{"family":"Geist"}},"icons":{"library":"lucide"},"styling":{"eyebrows":"breadcrumbs","codeblocks":"system","latex":false},"contextual":{"options":["copy","view","claude","chatgpt","cursor","mcp"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"dueflow","hasAudioNarration":false,"actualSubdomain":"dueflow","customDomains":["docs.dueflow.co"],"gitSource":{"type":"github","owner":"dueflow-co","repo":"dueflow","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":"","_id":"6aefeda973f97ab7dcd385d0"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6af5c9a5033e137dc78bd12b","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"default","tag":"API reference","count":75},{"language":"default","tag":"Guides","count":13},{"language":"default","tag":"Payments","count":10},{"language":"default","tag":"Cards","count":9},{"language":"default","tag":"Organization","count":9},{"language":"default","tag":"Collections","count":7},{"language":"default","tag":"Fundraising","count":7},{"language":"default","tag":"Groups","count":7},{"language":"default","tag":"Core concepts","count":5},{"language":"default","tag":"Members","count":5}]},"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}],"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"api-reference/organization/retrieve-the-caller","slug":"/api-reference/organization/retrieve-the-caller","pageMetadata":{"title":"Retrieve the caller","description":"> **Requires scope** `organization:read` · **Minimum role** viewer\n\nWho is calling and what they can do: the user (null for a service token), the token's kind and expiry, the organization the token is bound to, the role, the effective scopes for this request, which products are on for the organization, and the user's other organizations for a switcher. A client's first call after sign-in. Requires only `organization:read`, which every role holds.\n\n[Scopes and roles](https://docs.dueflow.co/api-reference/scopes)","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/me","href":"/api-reference/organization/retrieve-the-caller","autogeneratedByOpenApi":true},"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 a: \"a\",\n blockquote: \"blockquote\",\n code: \"code\",\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.blockquote, {\n children: [\"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Requires scope\"\n }), \" \", _jsx(_components.code, {\n children: \"organization:read\"\n }), \" · \", _jsx(_components.strong, {\n children: \"Minimum role\"\n }), \" viewer\"]\n }), \"\\n\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Who is calling and what they can do: the user (null for a service token), the token’s kind and expiry, the organization the token is bound to, the role, the effective scopes for this request, which products are on for the organization, and the user’s other organizations for a switcher. A client’s first call after sign-in. Requires only \", _jsx(_components.code, {\n children: \"organization:read\"\n }), \", which every role holds.\"]\n }), \"\\n\", _jsx(_components.p, {\n children: _jsx(_components.a, {\n href: \"https://docs.dueflow.co/api-reference/scopes\",\n children: \"Scopes and roles\"\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{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":{"codeStyling":"system","config":{},"pageMetadata":{"title":"Retrieve the caller","description":"> **Requires scope** `organization:read` · **Minimum role** viewer\n\nWho is calling and what they can do: the user (null for a service token), the token's kind and expiry, the organization the token is bound to, the role, the effective scopes for this request, which products are on for the organization, and the user's other organizations for a switcher. A client's first call after sign-in. Requires only `organization:read`, which every role holds.\n\n[Scopes and roles](https://docs.dueflow.co/api-reference/scopes)","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/me","href":"/api-reference/organization/retrieve-the-caller","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"getMe","summary":"Retrieve the caller","description":"> **Requires scope** `organization:read` · **Minimum role** viewer\n\nWho is calling and what they can do: the user (null for a service token), the token's kind and expiry, the organization the token is bound to, the role, the effective scopes for this request, which products are on for the organization, and the user's other organizations for a switcher. A client's first call after sign-in. Requires only `organization:read`, which every role holds.\n\n[Scopes and roles](https://docs.dueflow.co/api-reference/scopes)","tags":["Organization"],"security":["5cb0c084-1791-4d66-86cc-d5196b6a1fad"],"x-dueflow-scopes":["organization:read"],"x-dueflow-min-role":"viewer","responses":{"200":"cc847e7f-6273-4279-bf3e-1c1f8596ed5b","400":"78b5acc1-f685-4b39-b84e-e29a04038e84","401":"9a4da92f-cb52-471f-83bc-fc91b6624438","403":"df284f6d-72fb-4685-abad-c2eb1813e63a","404":"4d2e782e-6283-4dd9-ab2a-7c1dc54c7f88","429":"1b42ea32-f4a9-48eb-a0fa-46a829da6bd3","default":"ce65ca7c-0414-4eeb-b427-07fc2a1ed576"},"method":"get","type":"path","servers":["f8133c7a-14c3-4ed7-b002-a40c792db9e8"],"path":"/v1/me","baseUrlOptions":["https://api.dueflow.co"],"title":"Retrieve the caller","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"responses":{"cc847e7f-6273-4279-bf3e-1c1f8596ed5b":{"description":"Success","headers":{"X-Request-Id":{"description":"Identifies the request; quote it to support. Also in the error body as `requestId`.","schema":{"type":"string"}},"RateLimit-Limit":{"description":"Requests the token's budget for this kind of request allows per window.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"user":{"oneOf":[{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"user.oneOf.0.id","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"user.oneOf.0.name","typeLabel":"string"},"email":{"oneOf":[{"format":"email","type":"string","description":"The account email; null through an app you authorized (OAuth), which sees only the organization you chose","isRequired":true,"uniqueKey":"user.oneOf.0.email.oneOf.0","typeLabel":"string\u003cemail>"},{"format":"email","type":"null","description":"The account email; null through an app you authorized (OAuth), which sees only the organization you chose","isRequired":true,"uniqueKey":"user.oneOf.0.email.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"user.oneOf.0.email","typeLabel":"string\u003cemail> | null"}},"required":["id","name","email"],"description":"The person the credential belongs to; null for a service token, which belongs to the organization","isRequired":true,"uniqueKey":"user.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"id":{"type":"string"},"name":{"type":"string"},"email":{"oneOf":[{"format":"email","type":"string","description":"The account email; null through an app you authorized (OAuth), which sees only the organization you chose"},{"format":"email","type":"null","description":"The account email; null through an app you authorized (OAuth), which sees only the organization you chose"}]}},"required":["id","name","email"],"description":"The person the credential belongs to; null for a service token, which belongs to the organization","isRequired":true,"uniqueKey":"user.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"user","typeLabel":"object | null"},"token":{"oneOf":[{"type":"object","properties":{"kind":{"description":"oauth is the access token a connected app received through an OAuth grant: it is refreshed in place and expires within hours","type":"string","enum":["personal","service","oauth"],"isRequired":true,"uniqueKey":"token.oneOf.0.kind","typeLabel":"enum\u003cstring>"},"expiresAt":{"type":"string","format":"date-time","description":"Timestamp: RFC 3339, UTC, millisecond precision (`2026-01-31T17:04:05.123Z`).","isRequired":true,"uniqueKey":"token.oneOf.0.expiresAt","typeLabel":"string\u003cdate-time>"}},"required":["kind","expiresAt"],"description":"The API token the request authenticated with; null outside the API","isRequired":true,"uniqueKey":"token.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"kind":{"description":"oauth is the access token a connected app received through an OAuth grant: it is refreshed in place and expires within hours","type":"string","enum":["personal","service","oauth"]},"expiresAt":{"type":"string","format":"date-time","description":"Timestamp: RFC 3339, UTC, millisecond precision (`2026-01-31T17:04:05.123Z`)."}},"required":["kind","expiresAt"],"description":"The API token the request authenticated with; null outside the API","isRequired":true,"uniqueKey":"token.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"token","typeLabel":"object | null"},"organization":{"description":"The one organization the credential is bound to","type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"organization.id","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"organization.name","typeLabel":"string"},"type":{"type":"string","enum":["chapter","national"],"isRequired":true,"uniqueKey":"organization.type","typeLabel":"enum\u003cstring>"},"parentId":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"organization.parentId.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"organization.parentId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"organization.parentId","typeLabel":"string | null"},"slug":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"organization.slug.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"organization.slug.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"organization.slug","typeLabel":"string | null"},"logoUrl":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"organization.logoUrl.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"organization.logoUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"organization.logoUrl","typeLabel":"string | null"}},"required":["id","name","type","parentId","slug","logoUrl"],"isRequired":true,"uniqueKey":"organization","typeLabel":"object"},"role":{"description":"The role's preset key: admin, editor, viewer, secretary, chapter_consultant, store_manager, fundraiser or custom","type":"string","isRequired":true,"uniqueKey":"role","typeLabel":"string"},"roleName":{"description":"The role's display name: the member's custom title when they have one","type":"string","isRequired":true,"uniqueKey":"roleName","typeLabel":"string"},"scopes":{"description":"The effective scopes for this request (the token's grant, narrowed by the role and the organization's API policy), sorted","type":"array","items":{"type":"string","uniqueKey":"scopes.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"scopes","typeLabel":"string[]"},"features":{"description":"Which products are enabled for the organization: false means the product isn't enabled here, so hide its screens. A product also reads false when the organization can't have it (collections is chapter-only) or this credential's scopes reach none of its endpoints","type":"object","properties":{"fundraise":{"type":"boolean","isRequired":true,"uniqueKey":"features.fundraise","typeLabel":"boolean"},"debtCollections":{"type":"boolean","isRequired":true,"uniqueKey":"features.debtCollections","typeLabel":"boolean"},"virtualCards":{"type":"boolean","isRequired":true,"uniqueKey":"features.virtualCards","typeLabel":"boolean"},"publicApi":{"type":"boolean","isRequired":true,"uniqueKey":"features.publicApi","typeLabel":"boolean"}},"required":["fundraise","debtCollections","virtualCards","publicApi"],"isRequired":true,"uniqueKey":"features","typeLabel":"object"},"memberships":{"description":"Every organization the user belongs to, for an organization switcher. Informational: the credential stays bound to organization, so acting on another one takes a credential for it. Empty for a service token. Apps you authorized see only the organization you chose","type":"array","items":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"memberships.items.[INDEX].id","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"memberships.items.[INDEX].name","typeLabel":"string"},"type":{"type":"string","enum":["chapter","national"],"isRequired":true,"uniqueKey":"memberships.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"role":{"description":"The role's preset key: admin, editor, viewer, secretary, chapter_consultant, store_manager, fundraiser or custom","type":"string","isRequired":true,"uniqueKey":"memberships.items.[INDEX].role","typeLabel":"string"}},"required":["id","name","type","role"],"uniqueKey":"memberships.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"memberships","typeLabel":"object[]"}},"required":["user","token","organization","role","roleName","scopes","features","memberships"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"user":{"id":"\u003cstring>","name":"\u003cstring>","email":"jsmith@example.com"},"token":{"kind":"personal","expiresAt":"2023-11-07T05:31:56Z"},"organization":{"id":"\u003cstring>","name":"\u003cstring>","type":"chapter","parentId":"\u003cstring>","slug":"\u003cstring>","logoUrl":"\u003cstring>"},"role":"\u003cstring>","roleName":"\u003cstring>","scopes":["\u003cstring>"],"features":{"fundraise":true,"debtCollections":true,"virtualCards":true,"publicApi":true},"memberships":[{"id":"\u003cstring>","name":"\u003cstring>","type":"chapter","role":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"78b5acc1-f685-4b39-b84e-e29a04038e84":{"description":"Invalid input: a parameter or body field fails validation (`param` names it), the body isn't JSON, or a business rule refused the request.","headers":{"X-Request-Id":{"description":"Identifies the request; quote it to support. Also in the error body as `requestId`.","schema":{"type":"string"}},"RateLimit-Limit":{"description":"Requests the token's budget for this kind of request allows per window.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"description":"A stable, machine-readable reason. One of `invalid_request` (400), `invalid_token` (401), `insufficient_scope` (403), `step_up_required` (403), `not_found` (404), `method_not_allowed` (405), `conflict` (409), `sync_expired` (410), `rate_limited` (429), `internal_error` (500), `provider_error` (502). New codes may be added; treat an unknown one by its HTTP status.","type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"requestId":{"type":"string","isRequired":true,"uniqueKey":"error.requestId","typeLabel":"string"},"docsUrl":{"type":"string","isRequired":true,"uniqueKey":"error.docsUrl","typeLabel":"string"},"param":{"type":"string","uniqueKey":"error.param","typeLabel":"string"},"requiredScopes":{"type":"array","items":{"type":"string","uniqueKey":"error.requiredScopes.items.[INDEX]","typeLabel":"string"},"uniqueKey":"error.requiredScopes","typeLabel":"string[]"}},"required":["code","message","requestId","docsUrl"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","requestId":"\u003cstring>","docsUrl":"\u003cstring>","param":"\u003cstring>","requiredScopes":["\u003cstring>"]}}}},"exampleType":"generated"}},"exampleType":"generated"},"9a4da92f-cb52-471f-83bc-fc91b6624438":{"description":"Missing, malformed, expired or revoked token.","headers":{"X-Request-Id":{"description":"Identifies the request; quote it to support. Also in the error body as `requestId`.","schema":{"type":"string"}},"RateLimit-Limit":{"description":"Requests the token's budget for this kind of request allows per window.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"description":"A stable, machine-readable reason. One of `invalid_request` (400), `invalid_token` (401), `insufficient_scope` (403), `step_up_required` (403), `not_found` (404), `method_not_allowed` (405), `conflict` (409), `sync_expired` (410), `rate_limited` (429), `internal_error` (500), `provider_error` (502). New codes may be added; treat an unknown one by its HTTP status.","type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"requestId":{"type":"string","isRequired":true,"uniqueKey":"error.requestId","typeLabel":"string"},"docsUrl":{"type":"string","isRequired":true,"uniqueKey":"error.docsUrl","typeLabel":"string"},"param":{"type":"string","uniqueKey":"error.param","typeLabel":"string"},"requiredScopes":{"type":"array","items":{"type":"string","uniqueKey":"error.requiredScopes.items.[INDEX]","typeLabel":"string"},"uniqueKey":"error.requiredScopes","typeLabel":"string[]"}},"required":["code","message","requestId","docsUrl"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","requestId":"\u003cstring>","docsUrl":"\u003cstring>","param":"\u003cstring>","requiredScopes":["\u003cstring>"]}}}},"exampleType":"generated"}},"exampleType":"generated"},"df284f6d-72fb-4685-abad-c2eb1813e63a":{"description":"The token lacks a required scope.","headers":{"X-Request-Id":{"description":"Identifies the request; quote it to support. Also in the error body as `requestId`.","schema":{"type":"string"}},"RateLimit-Limit":{"description":"Requests the token's budget for this kind of request allows per window.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"description":"A stable, machine-readable reason. One of `invalid_request` (400), `invalid_token` (401), `insufficient_scope` (403), `step_up_required` (403), `not_found` (404), `method_not_allowed` (405), `conflict` (409), `sync_expired` (410), `rate_limited` (429), `internal_error` (500), `provider_error` (502). New codes may be added; treat an unknown one by its HTTP status.","type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"requestId":{"type":"string","isRequired":true,"uniqueKey":"error.requestId","typeLabel":"string"},"docsUrl":{"type":"string","isRequired":true,"uniqueKey":"error.docsUrl","typeLabel":"string"},"param":{"type":"string","uniqueKey":"error.param","typeLabel":"string"},"requiredScopes":{"type":"array","items":{"type":"string","uniqueKey":"error.requiredScopes.items.[INDEX]","typeLabel":"string"},"uniqueKey":"error.requiredScopes","typeLabel":"string[]"}},"required":["code","message","requestId","docsUrl"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","requestId":"\u003cstring>","docsUrl":"\u003cstring>","param":"\u003cstring>","requiredScopes":["\u003cstring>"]}}}},"exampleType":"generated"}},"exampleType":"generated"},"4d2e782e-6283-4dd9-ab2a-7c1dc54c7f88":{"description":"No such resource, or the token's organization can't see it.","headers":{"X-Request-Id":{"description":"Identifies the request; quote it to support. Also in the error body as `requestId`.","schema":{"type":"string"}},"RateLimit-Limit":{"description":"Requests the token's budget for this kind of request allows per window.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"description":"A stable, machine-readable reason. One of `invalid_request` (400), `invalid_token` (401), `insufficient_scope` (403), `step_up_required` (403), `not_found` (404), `method_not_allowed` (405), `conflict` (409), `sync_expired` (410), `rate_limited` (429), `internal_error` (500), `provider_error` (502). New codes may be added; treat an unknown one by its HTTP status.","type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"requestId":{"type":"string","isRequired":true,"uniqueKey":"error.requestId","typeLabel":"string"},"docsUrl":{"type":"string","isRequired":true,"uniqueKey":"error.docsUrl","typeLabel":"string"},"param":{"type":"string","uniqueKey":"error.param","typeLabel":"string"},"requiredScopes":{"type":"array","items":{"type":"string","uniqueKey":"error.requiredScopes.items.[INDEX]","typeLabel":"string"},"uniqueKey":"error.requiredScopes","typeLabel":"string[]"}},"required":["code","message","requestId","docsUrl"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","requestId":"\u003cstring>","docsUrl":"\u003cstring>","param":"\u003cstring>","requiredScopes":["\u003cstring>"]}}}},"exampleType":"generated"}},"exampleType":"generated"},"1b42ea32-f4a9-48eb-a0fa-46a829da6bd3":{"description":"Rate limited; see the `Retry-After` header.","headers":{"X-Request-Id":{"description":"Identifies the request; quote it to support. Also in the error body as `requestId`.","schema":{"type":"string"}},"RateLimit-Limit":{"description":"Requests the token's budget for this kind of request allows per window.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"description":"A stable, machine-readable reason. One of `invalid_request` (400), `invalid_token` (401), `insufficient_scope` (403), `step_up_required` (403), `not_found` (404), `method_not_allowed` (405), `conflict` (409), `sync_expired` (410), `rate_limited` (429), `internal_error` (500), `provider_error` (502). New codes may be added; treat an unknown one by its HTTP status.","type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"requestId":{"type":"string","isRequired":true,"uniqueKey":"error.requestId","typeLabel":"string"},"docsUrl":{"type":"string","isRequired":true,"uniqueKey":"error.docsUrl","typeLabel":"string"},"param":{"type":"string","uniqueKey":"error.param","typeLabel":"string"},"requiredScopes":{"type":"array","items":{"type":"string","uniqueKey":"error.requiredScopes.items.[INDEX]","typeLabel":"string"},"uniqueKey":"error.requiredScopes","typeLabel":"string[]"}},"required":["code","message","requestId","docsUrl"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","requestId":"\u003cstring>","docsUrl":"\u003cstring>","param":"\u003cstring>","requiredScopes":["\u003cstring>"]}}}},"exampleType":"generated"}},"exampleType":"generated"},"ce65ca7c-0414-4eeb-b427-07fc2a1ed576":{"description":"Any other failure, such as `internal_error` (500), as the `Error` envelope. A failure in front of the API (a gateway timeout, a request too large) may instead be plain text.","headers":{"X-Request-Id":{"description":"Identifies the request; quote it to support. Also in the error body as `requestId`.","schema":{"type":"string"}},"RateLimit-Limit":{"description":"Requests the token's budget for this kind of request allows per window.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"description":"A stable, machine-readable reason. One of `invalid_request` (400), `invalid_token` (401), `insufficient_scope` (403), `step_up_required` (403), `not_found` (404), `method_not_allowed` (405), `conflict` (409), `sync_expired` (410), `rate_limited` (429), `internal_error` (500), `provider_error` (502). New codes may be added; treat an unknown one by its HTTP status.","type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"requestId":{"type":"string","isRequired":true,"uniqueKey":"error.requestId","typeLabel":"string"},"docsUrl":{"type":"string","isRequired":true,"uniqueKey":"error.docsUrl","typeLabel":"string"},"param":{"type":"string","uniqueKey":"error.param","typeLabel":"string"},"requiredScopes":{"type":"array","items":{"type":"string","uniqueKey":"error.requiredScopes.items.[INDEX]","typeLabel":"string"},"uniqueKey":"error.requiredScopes","typeLabel":"string[]"}},"required":["code","message","requestId","docsUrl"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","requestId":"\u003cstring>","docsUrl":"\u003cstring>","param":"\u003cstring>","requiredScopes":["\u003cstring>"]}}}},"exampleType":"generated"},"text/plain":{"schema":{"type":"string","uniqueKey":"","typeLabel":"string"},"examples":{"Example":{"title":"Example","value":"\u003cstring>"}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"5cb0c084-1791-4d66-86cc-d5196b6a1fad":{"bearerAuth":{"type":"http","scheme":"bearer","description":"A Dueflow access token: `dfp_` (personal) or `dfs_` (service). Permissions are the token's scopes intersected with the role ceiling, re-evaluated per request.","scopes":["organization:read"],"schemeName":"bearerAuth"}}},"servers":{"f8133c7a-14c3-4ed7-b002-a40c792db9e8":{"url":"https://api.dueflow.co","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"A Dueflow access token: `dfp_` (personal) or `dfs_` (service). Permissions are the token's scopes intersected with the role ceiling, re-evaluated per request.","scopes":["organization:read"],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"A Dueflow access token: `dfp_` (personal) or `dfs_` (service). Permissions are the token's scopes intersected with the role ceiling, re-evaluated per request.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"dueflow","siteName":"Dueflow API","title":"Retrieve the caller - Dueflow API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-12T14:14:03.871Z","originalFileLocation":"api-reference/organization/retrieve-the-caller.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=\"\u0026gt; Requires scope organization:read · Minimum role viewer Who is calling and what they can do: the user (null for a service token), the token\u0026#x27;s kind and expiry, the organization the token is bound to, the role, the effective scopes for this request, which products are on for the organization, and the user\u0026#x27;s other organizations for a switcher. A client\u0026#x27;s first call after sign-in. Requires only organization:read, which every role holds. Scopes and roles\">\u003cmeta data-mint-head name=\"application-name\" content=\"Dueflow 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/dueflow/6-1Tg1IBCL9aitOD/_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/dueflow/6-1Tg1IBCL9aitOD/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/dueflow/6-1Tg1IBCL9aitOD/_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/dueflow/6-1Tg1IBCL9aitOD/_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/dueflow/6-1Tg1IBCL9aitOD/_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/dueflow/6-1Tg1IBCL9aitOD/_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/dueflow/6-1Tg1IBCL9aitOD/_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/dueflow/6-1Tg1IBCL9aitOD/_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/dueflow/6-1Tg1IBCL9aitOD/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Retrieve the caller - Dueflow API\">\u003cmeta data-mint-head property=\"og:description\" content=\"\u0026gt; Requires scope organization:read · Minimum role viewer Who is calling and what they can do: the user (null for a service token), the token\u0026#x27;s kind and expiry, the organization the token is bound to, the role, the effective scopes for this request, which products are on for the organization, and the user\u0026#x27;s other organizations for a switcher. A client\u0026#x27;s first call after sign-in. Requires only organization:read, which every role holds. Scopes and roles\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Dueflow API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.dueflow.co/api-reference/organization/retrieve-the-caller\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://dueflow.mintlify.site/_mintlify/api/og/v2?division=Organization\u0026amp;title=Retrieve+the+caller\u0026amp;description=%3E+**Requires+scope**+%60organization%3Aread%60+%C2%B7+**Minimum+role**+viewer%0A%0AWho+is+calling+and+what+they+can+do%3A+the+user+%28null+for+a+service+token%29%2C+the+token%27s+kind+a\u0026amp;theme=79b859704c5a413b132a77d2\u0026amp;signature=d81cfa77d2ef158912faf3cf51768215a8b458605a582faa06bc6f47c79eb53b\">\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 the caller - Dueflow API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"\u0026gt; Requires scope organization:read · Minimum role viewer Who is calling and what they can do: the user (null for a service token), the token\u0026#x27;s kind and expiry, the organization the token is bound to, the role, the effective scopes for this request, which products are on for the organization, and the user\u0026#x27;s other organizations for a switcher. A client\u0026#x27;s first call after sign-in. Requires only organization:read, which every role holds. Scopes and roles\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://dueflow.mintlify.site/_mintlify/api/og/v2?division=Organization\u0026amp;title=Retrieve+the+caller\u0026amp;description=%3E+**Requires+scope**+%60organization%3Aread%60+%C2%B7+**Minimum+role**+viewer%0A%0AWho+is+calling+and+what+they+can+do%3A+the+user+%28null+for+a+service+token%29%2C+the+token%27s+kind+a\u0026amp;theme=79b859704c5a413b132a77d2\u0026amp;signature=d81cfa77d2ef158912faf3cf51768215a8b458605a582faa06bc6f47c79eb53b\">\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/dueflow/6-1Tg1IBCL9aitOD/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Dueflow API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0075FA\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.dueflow.co/api-reference/organization/retrieve-the-caller\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/organization/retrieve-the-caller.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.dueflow.co/#organization\",\"name\":\"Dueflow API\",\"url\":\"https://docs.dueflow.co\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/dueflow/WUtCzXvACilGZRqa/logo/wordmark-dark.png?fit=max\u0026auto=format\u0026n=WUtCzXvACilGZRqa\u0026q=85\u0026s=ba1c5ccedabc26b8b53f96e8d5d79797\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.dueflow.co#website\",\"name\":\"Dueflow API\",\"url\":\"https://docs.dueflow.co\",\"publisher\":{\"@id\":\"https://docs.dueflow.co/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.dueflow.co/api-reference/organization/retrieve-the-caller#webpage\",\"url\":\"https://docs.dueflow.co/api-reference/organization/retrieve-the-caller\",\"name\":\"Retrieve the caller\",\"description\":\"> Requires scope organization:read · Minimum role viewer Who is calling and what they can do: the user (null for a service token), the token's kind and expiry, the organization the token is bound to, the role, the effective scopes for this request, which products are on for the organization, and the user's other organizations for a switcher. A client's first call after sign-in. Requires only organization:read, which every role holds. Scopes and roles\",\"dateModified\":\"2026-11-12T14:14:03.871Z\",\"isPartOf\":{\"@id\":\"https://docs.dueflow.co#website\"},\"breadcrumb\":{\"@id\":\"https://docs.dueflow.co/api-reference/organization/retrieve-the-caller#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.dueflow.co/api-reference/organization/retrieve-the-caller#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Organization\",\"item\":\"https://docs.dueflow.co/api-reference/organization/list-child-chapters\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Retrieve the caller\",\"item\":\"https://docs.dueflow.co/api-reference/organization/retrieve-the-caller\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.dueflow.co/api-reference/organization/retrieve-the-caller#apireference\",\"headline\":\"Retrieve the caller\",\"name\":\"Retrieve the caller\",\"description\":\"> Requires scope organization:read · Minimum role viewer Who is calling and what they can do: the user (null for a service token), the token's kind and expiry, the organization the token is bound to, the role, the effective scopes for this request, which products are on for the organization, and the user's other organizations for a switcher. A client's first call after sign-in. Requires only organization:read, which every role holds. Scopes and roles\",\"url\":\"https://docs.dueflow.co/api-reference/organization/retrieve-the-caller\",\"mainEntityOfPage\":{\"@id\":\"https://docs.dueflow.co/api-reference/organization/retrieve-the-caller#webpage\"},\"dateModified\":\"2026-11-12T14:14:03.871Z\",\"publisher\":{\"@id\":\"https://docs.dueflow.co/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.dueflow.co#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Dueflow API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Dueflow API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/organization/retrieve-the-caller.md","siteName":"Dueflow API","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/introduction"}]},{"tab":"API reference","groups":[{"group":"Audit","pages":[{"title":"List activity log events","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/audit-logs","href":"/api-reference/audit/list-activity-log-events"}]},{"group":"Fundraising","pages":[{"title":"List campaigns","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/campaigns","href":"/api-reference/fundraising/list-campaigns"},{"title":"Create a campaign","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/campaigns","href":"/api-reference/fundraising/create-a-campaign"},{"title":"Retrieve a campaign","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/campaigns/{campaignId}","href":"/api-reference/fundraising/retrieve-a-campaign"},{"title":"Delete a campaign","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/campaigns/{campaignId}","href":"/api-reference/fundraising/delete-a-campaign"},{"title":"Update a campaign","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/campaigns/{campaignId}","href":"/api-reference/fundraising/update-a-campaign"},{"title":"List donations","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/donations","href":"/api-reference/fundraising/list-donations"},{"title":"Retrieve a donation","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/donations/{donationId}","href":"/api-reference/fundraising/retrieve-a-donation"}]},{"group":"Cards","pages":[{"title":"Check a card issuance request","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/card-issuance-requests/{requestId}","href":"/api-reference/cards/check-a-card-issuance-request"},{"title":"List cards","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/cards","href":"/api-reference/cards/list-cards"},{"title":"Create a card","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/cards","href":"/api-reference/cards/create-a-card"},{"title":"Retrieve a card","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/cards/{cardId}","href":"/api-reference/cards/retrieve-a-card"},{"title":"Update a card's limits","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/cards/{cardId}","href":"/api-reference/cards/update-a-cards-limits"},{"title":"Assign a card to a member","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/cards/{cardId}/assign","href":"/api-reference/cards/assign-a-card-to-a-member"},{"title":"Cancel a card","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/cards/{cardId}/cancel","href":"/api-reference/cards/cancel-a-card"},{"title":"Freeze a card","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/cards/{cardId}/freeze","href":"/api-reference/cards/freeze-a-card"},{"title":"Unfreeze a card","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/cards/{cardId}/unfreeze","href":"/api-reference/cards/unfreeze-a-card"}]},{"group":"Card transactions","pages":[{"title":"List card transactions","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/card-transactions","href":"/api-reference/card-transactions/list-card-transactions"},{"title":"Retrieve a card transaction","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/card-transactions/{transactionId}","href":"/api-reference/card-transactions/retrieve-a-card-transaction"},{"title":"Itemize a card transaction","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/card-transactions/{transactionId}","href":"/api-reference/card-transactions/itemize-a-card-transaction"}]},{"group":"Payments","pages":[{"title":"Bill members of child chapters directly","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/chapter-member-payment-requests","href":"/api-reference/payments/bill-members-of-child-chapters-directly"},{"title":"Bill child chapters","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/chapter-payment-requests","href":"/api-reference/payments/bill-child-chapters"},{"title":"Request payments","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/payment-requests","href":"/api-reference/payments/request-payments"},{"title":"List payments","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/payments","href":"/api-reference/payments/list-payments"},{"title":"Retrieve a payment","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/payments/{paymentId}","href":"/api-reference/payments/retrieve-a-payment"},{"title":"Record a manual payment","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/payments/{paymentId}/mark-paid","href":"/api-reference/payments/record-a-manual-payment"},{"title":"Send a payment reminder","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/payments/{paymentId}/remind","href":"/api-reference/payments/send-a-payment-reminder"},{"title":"Resend a payment notification","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/payments/{paymentId}/resend-notification","href":"/api-reference/payments/resend-a-payment-notification"},{"title":"Send a scheduled bill now","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/payments/{paymentId}/send-now","href":"/api-reference/payments/send-a-scheduled-bill-now"},{"title":"Void an unpaid payment","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/payments/{paymentId}/void","href":"/api-reference/payments/void-an-unpaid-payment"}]},{"group":"Organization","pages":[{"title":"List child chapters","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/chapters","href":"/api-reference/organization/list-child-chapters"},{"title":"Retrieve a chapter","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/chapters/{chapterId}","href":"/api-reference/organization/retrieve-a-chapter"},{"title":"Update a chapter","description":"> **Requires scope** `chapters:write` · **Minimum role** editor\n\nEdits a child chapter's name, description and the HQ-only label. National organizations only; archived chapters stay editable.\n\n[Scopes and roles](https://docs.dueflow.co/api-reference/scopes)","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/chapters/{chapterId}","href":"/api-reference/organization/update-a-chapter"},{"title":"Retrieve the caller","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/me","href":"/api-reference/organization/retrieve-the-caller"},{"title":"Retrieve the organization","description":"> **Requires scope** `organization:read` · **Minimum role** viewer\n\nReturns the organization the access token is bound to. A token is bound to exactly one organization; use `/chapters` to reach child chapters.\n\n[Scopes and roles](https://docs.dueflow.co/api-reference/scopes)","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/organization","href":"/api-reference/organization/retrieve-the-organization"},{"title":"Retrieve required roster fields","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/organization/required-roster-fields","href":"/api-reference/organization/retrieve-required-roster-fields"},{"title":"Set required roster fields","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/organization/required-roster-fields","href":"/api-reference/organization/set-required-roster-fields"},{"title":"List terms","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/organization/terms","href":"/api-reference/organization/list-terms"},{"title":"Retrieve the dashboard summary","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/summary","href":"/api-reference/organization/retrieve-the-dashboard-summary"}]},{"group":"Members","pages":[{"title":"List a chapter's members","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/chapters/{chapterId}/members","href":"/api-reference/members/list-a-chapters-members"},{"title":"List members","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/members","href":"/api-reference/members/list-members"},{"title":"Create a member","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/members","href":"/api-reference/members/create-a-member"},{"title":"Retrieve a member","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/members/{memberId}","href":"/api-reference/members/retrieve-a-member"},{"title":"Update a member","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/members/{memberId}","href":"/api-reference/members/update-a-member"}]},{"group":"Chapters","pages":[{"title":"Apply a reviewed HQ roster across chapters","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/chapters/roster-sync","href":"/api-reference/chapters/apply-a-reviewed-hq-roster-across-chapters"}]},{"group":"Collections","pages":[{"title":"Collections status","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/collections","href":"/api-reference/collections/collections-status"},{"title":"A member's collections picture","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/collections/members/{memberId}","href":"/api-reference/collections/a-members-collections-picture"},{"title":"Send the final collections warning","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/collections/members/{memberId}/final-warning","href":"/api-reference/collections/send-the-final-collections-warning"},{"title":"Save a member's mailing address for collections","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/collections/members/{memberId}/mailing-address","href":"/api-reference/collections/save-a-members-mailing-address-for-collections"},{"title":"Refer a member to collections","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/collections/members/{memberId}/referral","href":"/api-reference/collections/refer-a-member-to-collections"},{"title":"List collections placements","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/collections/placements","href":"/api-reference/collections/list-collections-placements"},{"title":"Record an FCS rejection","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/collections/placements/{placementId}/rejection","href":"/api-reference/collections/record-an-fcs-rejection"}]},{"group":"Sync","pages":[{"title":"List deletions","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/deletions","href":"/api-reference/sync/list-deletions"}]},{"group":"Groups","pages":[{"title":"List groups","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/groups","href":"/api-reference/groups/list-groups"},{"title":"Create a group","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/groups","href":"/api-reference/groups/create-a-group"},{"title":"Retrieve a group","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/groups/{groupId}","href":"/api-reference/groups/retrieve-a-group"},{"title":"Update a group","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/groups/{groupId}","href":"/api-reference/groups/update-a-group"},{"title":"List group members","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/groups/{groupId}/members","href":"/api-reference/groups/list-group-members"},{"title":"Add members to a group","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/groups/{groupId}/members","href":"/api-reference/groups/add-members-to-a-group"},{"title":"Remove a member from a group","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/groups/{groupId}/members/{memberId}","href":"/api-reference/groups/remove-a-member-from-a-group"}]},{"group":"Payouts","pages":[{"title":"List payouts","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/payouts","href":"/api-reference/payouts/list-payouts"},{"title":"Retrieve a payout","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/payouts/{payoutId}","href":"/api-reference/payouts/retrieve-a-payout"}]},{"group":"Reimbursements","pages":[{"title":"List reimbursements","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/reimbursements","href":"/api-reference/reimbursements/list-reimbursements"},{"title":"Retrieve a reimbursement","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/reimbursements/{reimbursementId}","href":"/api-reference/reimbursements/retrieve-a-reimbursement"},{"title":"Mark a reimbursement paid","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/reimbursements/{reimbursementId}/mark-paid","href":"/api-reference/reimbursements/mark-a-reimbursement-paid"},{"title":"Approve or reject a reimbursement","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/reimbursements/{reimbursementId}/review","href":"/api-reference/reimbursements/approve-or-reject-a-reimbursement"},{"title":"Void a reimbursement","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/reimbursements/{reimbursementId}/void","href":"/api-reference/reimbursements/void-a-reimbursement"}]},{"group":"Reminders","pages":[{"title":"List reminders","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/reminders","href":"/api-reference/reminders/list-reminders"},{"title":"Retrieve a reminder","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/reminders/{reminderId}","href":"/api-reference/reminders/retrieve-a-reminder"},{"title":"Send a scheduled reminder now","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/reminders/{reminderId}/send","href":"/api-reference/reminders/send-a-scheduled-reminder-now"}]},{"group":"Store","pages":[{"title":"List store listings","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/store/listings","href":"/api-reference/store/list-store-listings"},{"title":"Retrieve a store listing","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/store/listings/{listingId}","href":"/api-reference/store/retrieve-a-store-listing"},{"title":"List a listing's items","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/store/listings/{listingId}/items","href":"/api-reference/store/list-a-listings-items"},{"title":"List store orders","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/store/orders","href":"/api-reference/store/list-store-orders"},{"title":"Retrieve a store order","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/store/orders/{orderId}","href":"/api-reference/store/retrieve-a-store-order"}]}]}]},"basePath":"","title":"Retrieve the caller - Dueflow API","buildId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","deploymentId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CybtLBIt.js","utils-BMLj2fvV.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-B6In562Y.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dr8Mfhp9.js","snippetPresets-2rmQvMVl.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-WMqJYdZj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CJ-MlPHu.js","shallow-dY3TMRCk.js","getApiPlaygroundDisplay-v-1B2bKm.js","CodeSnippet-BDhiTB7U.js","CodeSnippets-D9hnzQcS.js","Page-C4GwDT3_.js","getPastedJson-Th2V45jI.js","icon-BQXch1W9.js","MethodPill-BCqUneP3.js","DuplicateIcon-Q_-bhurZ.js","createIcon-DUjLHRqp.js","DynamicMarkdown-B-f2cqXQ.js","SectionHeading-Da5NsV4v.js","axios-vUo_bRtp.js","Markdown-D13FWkIM.js","clsx-D3Isdib3.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-C-XZBk9h.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink--qIqmmVG.js"]}