A key generated from Settings → Developers, sent as
Authorization: Bearer dr_live_<12 hex chars>_<64 hex chars>. Keys
carry explicit scopes — each endpoint states the one it requires.
The full key is shown exactly once at generation time and cannot be
retrieved again; only the keyId prefix is shown afterward. A
revoked key fails auth on its very next request.
A saved rule exactly as it is stored, which is what GET /api/preview/segments/{id}
returns. Unlike GroupFilter (what you may send) it has no limit on the length of a
list, and its conditions can be of any type (StoredGroupCondition), because a saved group is not held to the API's rules. A group
stored without a rule comes back as {}.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"DocuRise Developer Docs","colors":{"primary":"#DA350B","light":"#FF3C00","dark":"#AE2D13"},"logo":"https://mintcdn.com/docu-rise/ClhhLqgPXOXvt7Zz/logo.png?fit=max\u0026auto=format\u0026n=ClhhLqgPXOXvt7Zz\u0026q=85\u0026s=b73379a7630a12945d164a128a6ddb12","favicon":"https://mintcdn.com/docu-rise/uxv1U4cKVTA4xM3l/favicon.png?fit=max\u0026auto=format\u0026n=uxv1U4cKVTA4xM3l\u0026q=85\u0026s=0b88e688751814cb08931184873ba0be","appearance":{"default":"light","strict":true},"navbar":{"primary":{"type":"button","label":"Dashboard","href":"https://docurise.io/dashboard"}},"footer":{"socials":{}},"styling":{"latex":false},"navigation":{"languages":[{"language":"en","href":""},{"language":"ko","href":"ko"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"docu-rise","hasAudioNarration":false,"actualSubdomain":"docu-rise","customDomains":["docurise.io"],"gitSource":{"type":"github","owner":"ireneshlee814","repo":"docurise","deployBranch":"master","contentDirectory":"docs-content","isPrivate":true,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6adf1a4ed7cf896c8ad7ba87","collectionId":"94de5c8f-93e4-44a5-af98-0fc3dd32e1b8","liveDeploymentHistoryId":"6adf1a4ed7cf896c8ad7ba87","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6adf7b89b80f21f061134342","clientVersion":"0.0.3966","searchFilterCounts":[{"language":"en","tag":"API Reference","count":27},{"language":"ko","tag":"API Reference","count":27},{"language":"en","tag":"Documents","count":8},{"language":"ko","tag":"문서","count":8},{"language":"en","tag":"Audiences","count":7},{"language":"en","tag":"Guides","count":7},{"language":"ko","tag":"오디언스","count":7},{"language":"ko","tag":"가이드","count":7},{"language":"en","tag":"Instagram","count":4},{"language":"ko","tag":"Instagram","count":4},{"language":"en","tag":"Email","count":3},{"language":"en","tag":"Get Started","count":3},{"language":"ko","tag":"이메일","count":3},{"language":"ko","tag":"시작하기","count":3},{"language":"en","tag":"Contacts","count":2},{"language":"en","tag":"Reference","count":2},{"language":"en","tag":"AI Apps","count":2},{"language":"ko","tag":"연락처","count":2},{"language":"ko","tag":"레퍼런스","count":2},{"language":"ko","tag":"AI 앱","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/get-segment","slug":"/api-reference/get-segment","pageMetadata":{"title":"Get a group","description":"Read one group with its rule and its live member count","openapi":"api-reference/openapi.yaml GET /api/preview/segments/{id}","href":"/api-reference/get-segment"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Read one group with its rule and its live member count\"\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":"Get a group","description":"Read one group with its rule and its live member count","openapi":"api-reference/openapi.yaml GET /api/preview/segments/{id}","href":"/api-reference/get-segment"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"getSegment","tags":["Audiences"],"summary":"Get a group","description":"Read one group with its rule and its live member count","security":["bf8e4b34-ba3e-4e53-8952-aba914172199"],"responses":{"200":"f59bba5f-bd3b-4052-b02b-9e44b371ebf1","401":"4aa8687e-2e85-4918-bba1-80644c976cb7","403":"6f2c055a-390d-4918-8db6-f08bc467ce57","404":"3fa6bc0f-f5b1-46e2-a84b-0cdb5aeaad9b","429":"fe94b559-4d53-4a19-8546-52a53e18436f","500":"b32ec5fd-2038-4d59-9e26-5db43a3fb648","503":"29b64730-c4d9-49c2-8dc4-b34af8088bb8"},"x-codeSamples":[{"lang":"bash","label":"curl","source":"curl 'https://docurise.io/api/preview/segments/3d2b8a64-5e0f-4c71-b9a2-1f7e6c4d8a05' \\\n -H 'Authorization: Bearer dr_live_\u003ckeyId>_\u003csecret>'\n"}],"method":"get","type":"path","servers":["7304e0b3-d967-42dc-a414-a807932689bf"],"path":"/api/preview/segments/{id}","baseUrlOptions":["https://docurise.io"],"title":"Get a group","codeSamples":[{"label":"curl","lang":"bash","source":"curl 'https://docurise.io/api/preview/segments/3d2b8a64-5e0f-4c71-b9a2-1f7e6c4d8a05' \\\n -H 'Authorization: Bearer dr_live_\u003ckeyId>_\u003csecret>'\n"}],"requiredOnlyExamples":false,"requestExampleType":"codeSamples","responseExampleType":"generated"},"dependencies":{"parameters":{"f05b02a4-6a99-4f88-b505-91f6d77a0d1b":{"name":"id","in":"path","required":true,"description":"The group id, from `GET /api/preview/segments` or the response of `POST /api/preview/segments`.","schema":{"type":"string","format":"uuid","isRequired":true,"description":"The group id, from `GET /api/preview/segments` or the response of `POST /api/preview/segments`.","uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"responses":{"f59bba5f-bd3b-4052-b02b-9e44b371ebf1":{"description":"The group.","content":{"application/json":{"schema":{"type":"object","required":["id","name","filter","memberCount","createdAt"],"description":"A group with its rule and its live member count. Never any member data.","properties":{"id":{"type":"string","format":"uuid","description":"The group id.","isRequired":true,"uniqueKey":"id","typeLabel":"string\u003cuuid>"},"name":{"type":"string","description":"The group name.","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"filter":{"type":"object","additionalProperties":true,"description":"A saved rule exactly as it is stored, which is what `GET /api/preview/segments/{id}`\nreturns. Unlike `GroupFilter` (what you may send) it has no limit on the length of a\nlist, and its conditions can be of any type (`StoredGroupCondition`), because a saved group is not held to the API's rules. A group\nstored without a rule comes back as `{}`.\n","properties":{"operator":{"type":"string","enum":["AND","OR"],"description":"How the conditions in `conditions` are joined, `AND` (all of them) or `OR` (any of them).","uniqueKey":"filter.operator","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"type":"object","required":["field"],"additionalProperties":true,"description":"One condition of a saved rule, as it is stored. Unlike `GroupCondition` (what you\nmay send), `field` can be any condition type, including `custom_field`, which the API cannot create. The keys of each type are on\n[Group conditions](/api-reference/group-conditions).\n","properties":{"field":{"type":"string","description":"The condition type. One of the 20 types on Group conditions, or `custom_field`.","isRequired":true,"uniqueKey":"filter.conditions.items.[INDEX].field","typeLabel":"string"}},"example":{"field":"custom_field","questionId":"q9f2k1x7ab","operator":"exists"},"uniqueKey":"filter.conditions.items.[INDEX]","typeLabel":"object"},"description":"The main list of conditions.","uniqueKey":"filter.conditions","typeLabel":"object[]"},"requiredConditions":{"type":"array","items":{"type":"object","required":["field"],"additionalProperties":true,"description":"One condition of a saved rule, as it is stored. Unlike `GroupCondition` (what you\nmay send), `field` can be any condition type, including `custom_field`, which the API cannot create. The keys of each type are on\n[Group conditions](/api-reference/group-conditions).\n","properties":{"field":{"type":"string","description":"The condition type. One of the 20 types on Group conditions, or `custom_field`.","isRequired":true,"uniqueKey":"filter.requiredConditions.items.[INDEX].field","typeLabel":"string"}},"example":{"field":"custom_field","questionId":"q9f2k1x7ab","operator":"exists"},"uniqueKey":"filter.requiredConditions.items.[INDEX]","typeLabel":"object"},"description":"Conditions every member must also match.","uniqueKey":"filter.requiredConditions","typeLabel":"object[]"},"excludeConditions":{"type":"array","items":{"type":"object","required":["field"],"additionalProperties":true,"description":"One condition of a saved rule, as it is stored. Unlike `GroupCondition` (what you\nmay send), `field` can be any condition type, including `custom_field`, which the API cannot create. The keys of each type are on\n[Group conditions](/api-reference/group-conditions).\n","properties":{"field":{"type":"string","description":"The condition type. One of the 20 types on Group conditions, or `custom_field`.","isRequired":true,"uniqueKey":"filter.excludeConditions.items.[INDEX].field","typeLabel":"string"}},"example":{"field":"custom_field","questionId":"q9f2k1x7ab","operator":"exists"},"uniqueKey":"filter.excludeConditions.items.[INDEX]","typeLabel":"object"},"description":"Conditions that remove contacts.","uniqueKey":"filter.excludeConditions","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"filter","typeLabel":"object"},"memberCount":{"type":"integer","minimum":0,"description":"The live number of contacts in the group now (never unsubscribed contacts). A count only; the contacts themselves are never returned.","isRequired":true,"uniqueKey":"memberCount","typeLabel":"integer"},"createdAt":{"type":"string","format":"date-time","description":"When the group was created, RFC 3339 in UTC.","isRequired":true,"uniqueKey":"createdAt","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"","typeLabel":"object"},"example":{"id":"3d2b8a64-5e0f-4c71-b9a2-1f7e6c4d8a05","name":"Newsletter readers, still active","filter":{"operator":"AND","conditions":[{"field":"tag","operator":"has","value":"newsletter"}],"requiredConditions":[{"field":"consent","operator":"active"}],"excludeConditions":[{"field":"last_active","operator":"inactive_for_days","value":90}]},"memberCount":124,"createdAt":"2026-10-22T03:14:15.926Z"},"examples":{"Example":{"title":"Example","value":{"id":"3d2b8a64-5e0f-4c71-b9a2-1f7e6c4d8a05","name":"Newsletter readers, still active","filter":{"operator":"AND","conditions":[{"field":"tag","operator":"has","value":"newsletter"}],"requiredConditions":[{"field":"consent","operator":"active"}],"excludeConditions":[{"field":"last_active","operator":"inactive_for_days","value":90}]},"memberCount":124,"createdAt":"2026-10-22T03:14:15.926Z"}}},"exampleType":"examples"}},"exampleType":"examples"},"4aa8687e-2e85-4918-bba1-80644c976cb7":{"description":"Missing, malformed, or revoked API key (`code: UNAUTHORIZED`).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","retryable"],"properties":{"code":{"type":"string","description":"Stable machine-readable error code — switch on this, not `message`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable detail. May change wording without notice.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"type":"boolean","description":"Whether retrying the identical request may succeed.","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"retryAfterSeconds":{"type":"integer","description":"Present only when a concrete backoff hint applies.","uniqueKey":"error.retryAfterSeconds","typeLabel":"integer"},"details":{"type":"object","description":"Present only for a few specific codes:\n- `PROTECTION_RULE_CONFLICT`: `{ rule: string }`, the protection rule that refused the request\n (`form`, `restricted_access`, `paid_lead_gate`, `free_lead_gate` or `form_no_access_controls`).\n Open-ended: tolerate new values.\n- `NEXT_POST_RULE_EXISTS`: `{ ruleId: string }`, the existing next-post rule.\n- `NOTION_FETCH_FAILED`: `{ notionErrorCode: string }`, one of\n `NOTION_ERROR_PRIVATE`, `NOTION_ERROR_NOT_FOUND`,\n `NOTION_ERROR_NETWORK`, `NOTION_ERROR_RATE_LIMIT`,\n `NOTION_ERROR_TEMPORARILY_UNAVAILABLE`,\n `NOTION_ERROR_PAGE_REJECTED`, `NOTION_ERROR_UNKNOWN`.\n- `HTML_REJECTED`: `{ reason: string }`, one of `too_large`, `css_rejected` or `invalid`.\n Open-ended: tolerate new values.\n- `CONDITION_NOT_SUPPORTED`: `{ field: string, path: string }`, the condition type that is not\n accepted and where it sits in the request. For a condition shape refused where it sits\n also `operator: string` and, when there is an equivalent operator for `requiredConditions`,\n `invertTo: string`.\n- `REFERENCE_NOT_FOUND`: `{ path: string, kind: string }`, where the unknown id sits in the\n request and what it refers to: `document`, `product`, `tier`, `cta`, `folder`, `broadcast` or\n `step`. Open-ended: tolerate new values.\n- `TAG_NOT_FOUND` (from a group rule): `{ tag: string }`, the tag name that does not exist.\n- `GROUP_REFERENCE_NOT_FOUND`: `{ groupIds: string[] }`, the group ids that are not in the account.\n- `GROUP_LIMIT_REACHED`: `{ limit: integer }`, the most groups an account can create through the API.\n","uniqueKey":"error.details","typeLabel":"object"}},"description":"The error. Every error response from the API has it: `code`, `message`, `retryable` and, for some codes, `retryAfterSeconds` and `details`.","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","retryable":true,"retryAfterSeconds":123,"details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"6f2c055a-390d-4918-8db6-f08bc467ce57":{"description":"`PAST_DUE_RESTRICTED`, `PLAN_REQUIRED` or `INSUFFICIENT_SCOPE` (the key lacks `automations:read`).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","retryable"],"properties":{"code":{"type":"string","description":"Stable machine-readable error code — switch on this, not `message`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable detail. May change wording without notice.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"type":"boolean","description":"Whether retrying the identical request may succeed.","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"retryAfterSeconds":{"type":"integer","description":"Present only when a concrete backoff hint applies.","uniqueKey":"error.retryAfterSeconds","typeLabel":"integer"},"details":{"type":"object","description":"Present only for a few specific codes:\n- `PROTECTION_RULE_CONFLICT`: `{ rule: string }`, the protection rule that refused the request\n (`form`, `restricted_access`, `paid_lead_gate`, `free_lead_gate` or `form_no_access_controls`).\n Open-ended: tolerate new values.\n- `NEXT_POST_RULE_EXISTS`: `{ ruleId: string }`, the existing next-post rule.\n- `NOTION_FETCH_FAILED`: `{ notionErrorCode: string }`, one of\n `NOTION_ERROR_PRIVATE`, `NOTION_ERROR_NOT_FOUND`,\n `NOTION_ERROR_NETWORK`, `NOTION_ERROR_RATE_LIMIT`,\n `NOTION_ERROR_TEMPORARILY_UNAVAILABLE`,\n `NOTION_ERROR_PAGE_REJECTED`, `NOTION_ERROR_UNKNOWN`.\n- `HTML_REJECTED`: `{ reason: string }`, one of `too_large`, `css_rejected` or `invalid`.\n Open-ended: tolerate new values.\n- `CONDITION_NOT_SUPPORTED`: `{ field: string, path: string }`, the condition type that is not\n accepted and where it sits in the request. For a condition shape refused where it sits\n also `operator: string` and, when there is an equivalent operator for `requiredConditions`,\n `invertTo: string`.\n- `REFERENCE_NOT_FOUND`: `{ path: string, kind: string }`, where the unknown id sits in the\n request and what it refers to: `document`, `product`, `tier`, `cta`, `folder`, `broadcast` or\n `step`. Open-ended: tolerate new values.\n- `TAG_NOT_FOUND` (from a group rule): `{ tag: string }`, the tag name that does not exist.\n- `GROUP_REFERENCE_NOT_FOUND`: `{ groupIds: string[] }`, the group ids that are not in the account.\n- `GROUP_LIMIT_REACHED`: `{ limit: integer }`, the most groups an account can create through the API.\n","uniqueKey":"error.details","typeLabel":"object"}},"description":"The error. Every error response from the API has it: `code`, `message`, `retryable` and, for some codes, `retryAfterSeconds` and `details`.","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","retryable":true,"retryAfterSeconds":123,"details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"3fa6bc0f-f5b1-46e2-a84b-0cdb5aeaad9b":{"description":"`GROUP_NOT_FOUND`: no such group for this account (unknown, malformed or\nsomeone else's id, all indistinguishable). Or `NOT_FOUND` if the API is not\navailable to the account.\n","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","retryable"],"properties":{"code":{"type":"string","description":"Stable machine-readable error code — switch on this, not `message`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable detail. May change wording without notice.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"type":"boolean","description":"Whether retrying the identical request may succeed.","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"retryAfterSeconds":{"type":"integer","description":"Present only when a concrete backoff hint applies.","uniqueKey":"error.retryAfterSeconds","typeLabel":"integer"},"details":{"type":"object","description":"Present only for a few specific codes:\n- `PROTECTION_RULE_CONFLICT`: `{ rule: string }`, the protection rule that refused the request\n (`form`, `restricted_access`, `paid_lead_gate`, `free_lead_gate` or `form_no_access_controls`).\n Open-ended: tolerate new values.\n- `NEXT_POST_RULE_EXISTS`: `{ ruleId: string }`, the existing next-post rule.\n- `NOTION_FETCH_FAILED`: `{ notionErrorCode: string }`, one of\n `NOTION_ERROR_PRIVATE`, `NOTION_ERROR_NOT_FOUND`,\n `NOTION_ERROR_NETWORK`, `NOTION_ERROR_RATE_LIMIT`,\n `NOTION_ERROR_TEMPORARILY_UNAVAILABLE`,\n `NOTION_ERROR_PAGE_REJECTED`, `NOTION_ERROR_UNKNOWN`.\n- `HTML_REJECTED`: `{ reason: string }`, one of `too_large`, `css_rejected` or `invalid`.\n Open-ended: tolerate new values.\n- `CONDITION_NOT_SUPPORTED`: `{ field: string, path: string }`, the condition type that is not\n accepted and where it sits in the request. For a condition shape refused where it sits\n also `operator: string` and, when there is an equivalent operator for `requiredConditions`,\n `invertTo: string`.\n- `REFERENCE_NOT_FOUND`: `{ path: string, kind: string }`, where the unknown id sits in the\n request and what it refers to: `document`, `product`, `tier`, `cta`, `folder`, `broadcast` or\n `step`. Open-ended: tolerate new values.\n- `TAG_NOT_FOUND` (from a group rule): `{ tag: string }`, the tag name that does not exist.\n- `GROUP_REFERENCE_NOT_FOUND`: `{ groupIds: string[] }`, the group ids that are not in the account.\n- `GROUP_LIMIT_REACHED`: `{ limit: integer }`, the most groups an account can create through the API.\n","uniqueKey":"error.details","typeLabel":"object"}},"description":"The error. Every error response from the API has it: `code`, `message`, `retryable` and, for some codes, `retryAfterSeconds` and `details`.","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","retryable":true,"retryAfterSeconds":123,"details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"fe94b559-4d53-4a19-8546-52a53e18436f":{"description":"Rate limited (`code: RATE_LIMITED`, always retryable): see the `Retry-After` header and `X-RateLimit-*` headers. Or too many requests running at once (`code: TOO_MANY_CONCURRENT_REQUESTS`, always retryable): `Retry-After` is `1` and there are no `X-RateLimit-*` headers.","headers":{"Retry-After":{"schema":{"type":"integer"}},"X-RateLimit-Limit":{"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"schema":{"type":"integer"}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix timestamp (seconds) when the limit resets."}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","retryable"],"properties":{"code":{"type":"string","description":"Stable machine-readable error code — switch on this, not `message`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable detail. May change wording without notice.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"type":"boolean","description":"Whether retrying the identical request may succeed.","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"retryAfterSeconds":{"type":"integer","description":"Present only when a concrete backoff hint applies.","uniqueKey":"error.retryAfterSeconds","typeLabel":"integer"},"details":{"type":"object","description":"Present only for a few specific codes:\n- `PROTECTION_RULE_CONFLICT`: `{ rule: string }`, the protection rule that refused the request\n (`form`, `restricted_access`, `paid_lead_gate`, `free_lead_gate` or `form_no_access_controls`).\n Open-ended: tolerate new values.\n- `NEXT_POST_RULE_EXISTS`: `{ ruleId: string }`, the existing next-post rule.\n- `NOTION_FETCH_FAILED`: `{ notionErrorCode: string }`, one of\n `NOTION_ERROR_PRIVATE`, `NOTION_ERROR_NOT_FOUND`,\n `NOTION_ERROR_NETWORK`, `NOTION_ERROR_RATE_LIMIT`,\n `NOTION_ERROR_TEMPORARILY_UNAVAILABLE`,\n `NOTION_ERROR_PAGE_REJECTED`, `NOTION_ERROR_UNKNOWN`.\n- `HTML_REJECTED`: `{ reason: string }`, one of `too_large`, `css_rejected` or `invalid`.\n Open-ended: tolerate new values.\n- `CONDITION_NOT_SUPPORTED`: `{ field: string, path: string }`, the condition type that is not\n accepted and where it sits in the request. For a condition shape refused where it sits\n also `operator: string` and, when there is an equivalent operator for `requiredConditions`,\n `invertTo: string`.\n- `REFERENCE_NOT_FOUND`: `{ path: string, kind: string }`, where the unknown id sits in the\n request and what it refers to: `document`, `product`, `tier`, `cta`, `folder`, `broadcast` or\n `step`. Open-ended: tolerate new values.\n- `TAG_NOT_FOUND` (from a group rule): `{ tag: string }`, the tag name that does not exist.\n- `GROUP_REFERENCE_NOT_FOUND`: `{ groupIds: string[] }`, the group ids that are not in the account.\n- `GROUP_LIMIT_REACHED`: `{ limit: integer }`, the most groups an account can create through the API.\n","uniqueKey":"error.details","typeLabel":"object"}},"description":"The error. Every error response from the API has it: `code`, `message`, `retryable` and, for some codes, `retryAfterSeconds` and `details`.","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","retryable":true,"retryAfterSeconds":123,"details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"b32ec5fd-2038-4d59-9e26-5db43a3fb648":{"description":"`INTERNAL_ERROR` (retryable). Something failed on our side; the cause is not echoed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","retryable"],"properties":{"code":{"type":"string","description":"Stable machine-readable error code — switch on this, not `message`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable detail. May change wording without notice.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"type":"boolean","description":"Whether retrying the identical request may succeed.","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"retryAfterSeconds":{"type":"integer","description":"Present only when a concrete backoff hint applies.","uniqueKey":"error.retryAfterSeconds","typeLabel":"integer"},"details":{"type":"object","description":"Present only for a few specific codes:\n- `PROTECTION_RULE_CONFLICT`: `{ rule: string }`, the protection rule that refused the request\n (`form`, `restricted_access`, `paid_lead_gate`, `free_lead_gate` or `form_no_access_controls`).\n Open-ended: tolerate new values.\n- `NEXT_POST_RULE_EXISTS`: `{ ruleId: string }`, the existing next-post rule.\n- `NOTION_FETCH_FAILED`: `{ notionErrorCode: string }`, one of\n `NOTION_ERROR_PRIVATE`, `NOTION_ERROR_NOT_FOUND`,\n `NOTION_ERROR_NETWORK`, `NOTION_ERROR_RATE_LIMIT`,\n `NOTION_ERROR_TEMPORARILY_UNAVAILABLE`,\n `NOTION_ERROR_PAGE_REJECTED`, `NOTION_ERROR_UNKNOWN`.\n- `HTML_REJECTED`: `{ reason: string }`, one of `too_large`, `css_rejected` or `invalid`.\n Open-ended: tolerate new values.\n- `CONDITION_NOT_SUPPORTED`: `{ field: string, path: string }`, the condition type that is not\n accepted and where it sits in the request. For a condition shape refused where it sits\n also `operator: string` and, when there is an equivalent operator for `requiredConditions`,\n `invertTo: string`.\n- `REFERENCE_NOT_FOUND`: `{ path: string, kind: string }`, where the unknown id sits in the\n request and what it refers to: `document`, `product`, `tier`, `cta`, `folder`, `broadcast` or\n `step`. Open-ended: tolerate new values.\n- `TAG_NOT_FOUND` (from a group rule): `{ tag: string }`, the tag name that does not exist.\n- `GROUP_REFERENCE_NOT_FOUND`: `{ groupIds: string[] }`, the group ids that are not in the account.\n- `GROUP_LIMIT_REACHED`: `{ limit: integer }`, the most groups an account can create through the API.\n","uniqueKey":"error.details","typeLabel":"object"}},"description":"The error. Every error response from the API has it: `code`, `message`, `retryable` and, for some codes, `retryAfterSeconds` and `details`.","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","retryable":true,"retryAfterSeconds":123,"details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"29b64730-c4d9-49c2-8dc4-b34af8088bb8":{"description":"A server-side dependency is temporarily down (`RATE_LIMIT_UNAVAILABLE`\nor `SERVICE_UNAVAILABLE`). Not a problem with the request or key;\nalways retryable — honor `retryAfterSeconds` when present. The group\nendpoints (`POST /segments`, `POST /segments/preview`,\n`GET /segments/{id}`) also return it when a very heavy rule could not be\ncounted within about 10 seconds: simplify the rule or retry.\n","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","retryable"],"properties":{"code":{"type":"string","description":"Stable machine-readable error code — switch on this, not `message`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable detail. May change wording without notice.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"type":"boolean","description":"Whether retrying the identical request may succeed.","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"retryAfterSeconds":{"type":"integer","description":"Present only when a concrete backoff hint applies.","uniqueKey":"error.retryAfterSeconds","typeLabel":"integer"},"details":{"type":"object","description":"Present only for a few specific codes:\n- `PROTECTION_RULE_CONFLICT`: `{ rule: string }`, the protection rule that refused the request\n (`form`, `restricted_access`, `paid_lead_gate`, `free_lead_gate` or `form_no_access_controls`).\n Open-ended: tolerate new values.\n- `NEXT_POST_RULE_EXISTS`: `{ ruleId: string }`, the existing next-post rule.\n- `NOTION_FETCH_FAILED`: `{ notionErrorCode: string }`, one of\n `NOTION_ERROR_PRIVATE`, `NOTION_ERROR_NOT_FOUND`,\n `NOTION_ERROR_NETWORK`, `NOTION_ERROR_RATE_LIMIT`,\n `NOTION_ERROR_TEMPORARILY_UNAVAILABLE`,\n `NOTION_ERROR_PAGE_REJECTED`, `NOTION_ERROR_UNKNOWN`.\n- `HTML_REJECTED`: `{ reason: string }`, one of `too_large`, `css_rejected` or `invalid`.\n Open-ended: tolerate new values.\n- `CONDITION_NOT_SUPPORTED`: `{ field: string, path: string }`, the condition type that is not\n accepted and where it sits in the request. For a condition shape refused where it sits\n also `operator: string` and, when there is an equivalent operator for `requiredConditions`,\n `invertTo: string`.\n- `REFERENCE_NOT_FOUND`: `{ path: string, kind: string }`, where the unknown id sits in the\n request and what it refers to: `document`, `product`, `tier`, `cta`, `folder`, `broadcast` or\n `step`. Open-ended: tolerate new values.\n- `TAG_NOT_FOUND` (from a group rule): `{ tag: string }`, the tag name that does not exist.\n- `GROUP_REFERENCE_NOT_FOUND`: `{ groupIds: string[] }`, the group ids that are not in the account.\n- `GROUP_LIMIT_REACHED`: `{ limit: integer }`, the most groups an account can create through the API.\n","uniqueKey":"error.details","typeLabel":"object"}},"description":"The error. Every error response from the API has it: `code`, `message`, `retryable` and, for some codes, `retryAfterSeconds` and `details`.","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","retryable":true,"retryAfterSeconds":123,"details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"bf8e4b34-ba3e-4e53-8952-aba914172199":{"apiKey":{"type":"http","scheme":"bearer","bearerFormat":"dr_live_\u003ckeyId>_\u003csecret>","description":"A key generated from Settings → Developers, sent as\n`Authorization: Bearer dr_live_\u003c12 hex chars>_\u003c64 hex chars>`. Keys\ncarry explicit scopes — each endpoint states the one it requires.\nThe full key is shown exactly once at generation time and cannot be\nretrieved again; only the `keyId` prefix is shown afterward. A\nrevoked key fails auth on its very next request.\n","scopes":[],"schemeName":"apiKey"}}},"servers":{"7304e0b3-d967-42dc-a414-a807932689bf":{"url":"https://docurise.io","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"dr_live_\u003ckeyId>_\u003csecret>","description":"A key generated from Settings → Developers, sent as\n`Authorization: Bearer dr_live_\u003c12 hex chars>_\u003c64 hex chars>`. Keys\ncarry explicit scopes — each endpoint states the one it requires.\nThe full key is shown exactly once at generation time and cannot be\nretrieved again; only the `keyId` prefix is shown afterward. A\nrevoked key fails auth on its very next request.\n","scopes":[],"schemeName":"apiKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"A key generated from Settings → Developers, sent as\n`Authorization: Bearer dr_live_\u003c12 hex chars>_\u003c64 hex chars>`. Keys\ncarry explicit scopes — each endpoint states the one it requires.\nThe full key is shown exactly once at generation time and cannot be\nretrieved again; only the `keyId` prefix is shown afterward. A\nrevoked key fails auth on its very next request.\n","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"apiKey","name":"Authorization"}],"title":"apiKey"}]},"originalFileLocation":"api-reference/openapi.yaml"},"subdomain":"docu-rise","siteName":"DocuRise Developer Docs","title":"Get a group - DocuRise Developer Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/get-segment","matchLevel":0},"ko":{"href":"/ko/api-reference/get-segment","matchLevel":1}}},"lastModified":"2026-10-26T16:11:34.233Z","originalFileLocation":"api-reference/get-segment.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"light\";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=\"light\"}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=\"Read one group with its rule and its live member count\">\u003cmeta data-mint-head name=\"application-name\" content=\"DocuRise Developer Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/docu-rise/PjNyTTc63ErGT2fG/_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=\"/docs/mintlify-assets/_mintlify/favicons/docu-rise/PjNyTTc63ErGT2fG/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/docu-rise/PjNyTTc63ErGT2fG/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/docu-rise/PjNyTTc63ErGT2fG/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/docu-rise/PjNyTTc63ErGT2fG/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/docu-rise/PjNyTTc63ErGT2fG/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/docu-rise/PjNyTTc63ErGT2fG/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/docu-rise/PjNyTTc63ErGT2fG/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/docu-rise/PjNyTTc63ErGT2fG/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get a group - DocuRise Developer Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Read one group with its rule and its live member count\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"DocuRise Developer Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docurise.io/docs/api-reference/get-segment\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://docu-rise.mintlify.app/_mintlify/api/og/v2?division=Audiences\u0026amp;title=Get+a+group\u0026amp;description=Read+one+group+with+its+rule+and+its+live+member+count\u0026amp;theme=53f5ca0b0069a8a509ebc847\u0026amp;signature=95a6ff6b30120c21ad102c745bbd2fccc74df71bd824ac64febde7aa14ecaf26\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Get a group - DocuRise Developer Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Read one group with its rule and its live member count\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://docu-rise.mintlify.app/_mintlify/api/og/v2?division=Audiences\u0026amp;title=Get+a+group\u0026amp;description=Read+one+group+with+its+rule+and+its+live+member+count\u0026amp;theme=53f5ca0b0069a8a509ebc847\u0026amp;signature=95a6ff6b30120c21ad102c745bbd2fccc74df71bd824ac64febde7aa14ecaf26\">\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=\"/docs/mintlify-assets/_mintlify/favicons/docu-rise/PjNyTTc63ErGT2fG/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"DocuRise Developer Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#DA350B\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docurise.io/docs/api-reference/get-segment\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/get-segment.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docurise.io/docs/api-reference/get-segment\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://docurise.io/docs/ko/api-reference/get-segment\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docurise.io/docs/api-reference/get-segment\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docurise.io/#organization\",\"name\":\"DocuRise Developer Docs\",\"url\":\"https://docurise.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/docu-rise/ClhhLqgPXOXvt7Zz/logo.png?fit=max\u0026auto=format\u0026n=ClhhLqgPXOXvt7Zz\u0026q=85\u0026s=b73379a7630a12945d164a128a6ddb12\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docurise.io/docs#website\",\"name\":\"DocuRise Developer Docs\",\"url\":\"https://docurise.io/docs\",\"publisher\":{\"@id\":\"https://docurise.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docurise.io/docs/api-reference/get-segment#webpage\",\"url\":\"https://docurise.io/docs/api-reference/get-segment\",\"name\":\"Get a group\",\"description\":\"Read one group with its rule and its live member count\",\"dateModified\":\"2026-10-26T16:11:34.233Z\",\"isPartOf\":{\"@id\":\"https://docurise.io/docs#website\"},\"breadcrumb\":{\"@id\":\"https://docurise.io/docs/api-reference/get-segment#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docurise.io/docs/api-reference/get-segment#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Audiences\",\"item\":\"https://docurise.io/docs/api-reference/list-tags\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get a group\",\"item\":\"https://docurise.io/docs/api-reference/get-segment\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docurise.io/docs/api-reference/get-segment#apireference\",\"headline\":\"Get a group\",\"name\":\"Get a group\",\"description\":\"Read one group with its rule and its live member count\",\"url\":\"https://docurise.io/docs/api-reference/get-segment\",\"mainEntityOfPage\":{\"@id\":\"https://docurise.io/docs/api-reference/get-segment#webpage\"},\"dateModified\":\"2026-10-26T16:11:34.233Z\",\"publisher\":{\"@id\":\"https://docurise.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docurise.io/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"DocuRise Developer Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"DocuRise Developer Docs","nav":{"global":null,"languages":[{"language":"en","tabs":[{"tab":"Guides","icon":"book-open","pages":[{"title":"Guides","href":""}]},{"tab":"API Reference","icon":"code","groups":[{"group":"Documents","pages":[{"title":"Create a document","openapi":"api-reference/openapi.yaml POST /api/preview/documents","href":"/api-reference/create-document"},{"title":"List documents","openapi":"api-reference/openapi.yaml GET /api/preview/documents","href":"/api-reference/list-documents"},{"title":"Get a document","openapi":"api-reference/openapi.yaml GET /api/preview/documents/{id}","href":"/api-reference/get-document"},{"title":"Update a document","openapi":"api-reference/openapi.yaml PATCH /api/preview/documents/{id}","href":"/api-reference/update-document"},{"title":"Get document analytics","openapi":"api-reference/openapi.yaml GET /api/preview/documents/{id}/analytics","href":"/api-reference/get-document-analytics"},{"title":"Get document analytics by channel","openapi":"api-reference/openapi.yaml GET /api/preview/documents/{id}/analytics/channels","href":"/api-reference/get-document-analytics-channels"},{"title":"Get form funnel","openapi":"api-reference/openapi.yaml GET /api/preview/documents/{id}/analytics/funnel","href":"/api-reference/get-form-funnel"},{"title":"List top documents","openapi":"api-reference/openapi.yaml GET /api/preview/analytics/documents","href":"/api-reference/list-top-documents"}]},{"group":"Folders","pages":[{"title":"List folders and courses","openapi":"api-reference/openapi.yaml GET /api/preview/folders","href":"/api-reference/list-folders"}]},{"group":"Products","pages":[{"title":"List products","openapi":"api-reference/openapi.yaml GET /api/preview/products","href":"/api-reference/list-products"}]},{"group":"Audiences","pages":[{"title":"List tags","openapi":"api-reference/openapi.yaml GET /api/preview/tags","href":"/api-reference/list-tags"},{"title":"Create a tag","openapi":"api-reference/openapi.yaml POST /api/preview/tags","href":"/api-reference/create-tag"},{"title":"List groups","openapi":"api-reference/openapi.yaml GET /api/preview/segments","href":"/api-reference/list-segments"},{"title":"Create a group","openapi":"api-reference/openapi.yaml POST /api/preview/segments","href":"/api-reference/create-segment"},{"title":"Preview a group rule","description":"Count who a rule would match without saving anything","openapi":"api-reference/openapi.yaml POST /api/preview/segments/preview","href":"/api-reference/preview-segment"},{"title":"Get a group","openapi":"api-reference/openapi.yaml GET /api/preview/segments/{id}","href":"/api-reference/get-segment"},{"title":"Group conditions","description":"Every condition you can use in a group rule: what it matches, its keys and values, and where to find the ids it needs","href":"/api-reference/group-conditions"}]},{"group":"Contacts","pages":[{"title":"Add a tag to a contact","openapi":"api-reference/openapi.yaml PUT /api/preview/contacts/{contactId}/tags/{tagName}","href":"/api-reference/add-contact-tag"},{"title":"Remove a tag from a contact","openapi":"api-reference/openapi.yaml DELETE /api/preview/contacts/{contactId}/tags/{tagName}","href":"/api-reference/remove-contact-tag"}]},{"group":"Email","pages":[{"title":"List email broadcasts","openapi":"api-reference/openapi.yaml GET /api/preview/email/broadcasts","href":"/api-reference/list-email-broadcasts"},{"title":"Get broadcast insights","openapi":"api-reference/openapi.yaml GET /api/preview/email/broadcasts/{id}/insights","href":"/api-reference/get-broadcast-insights"},{"title":"List automations","openapi":"api-reference/openapi.yaml GET /api/preview/automations","href":"/api-reference/list-automations"}]},{"group":"Instagram","pages":[{"title":"Create an Instagram rule","openapi":"api-reference/openapi.yaml POST /api/preview/instagram/rules","href":"/api-reference/create-instagram-rule"},{"title":"List Instagram rules","openapi":"api-reference/openapi.yaml GET /api/preview/instagram/rules","href":"/api-reference/list-instagram-rules"},{"title":"Get an Instagram rule","openapi":"api-reference/openapi.yaml GET /api/preview/instagram/rules/{id}","href":"/api-reference/get-instagram-rule"},{"title":"Update an Instagram rule","openapi":"api-reference/openapi.yaml PATCH /api/preview/instagram/rules/{id}","href":"/api-reference/update-instagram-rule"}]},{"group":"Account","pages":[{"title":"Inspect the calling key","openapi":"api-reference/openapi.yaml GET /api/preview/whoami","href":"/api-reference/whoami"}]}]}]},{"language":"ko","pages":[{"title":"ko","href":"/ko/api-reference/get-segment"}]}]},"title":"Get a group - DocuRise Developer Docs","buildId":"dpl_3DJU2xKhT5gDPFQL5Tqv7AFnkWsF","deploymentId":"dpl_3DJU2xKhT5gDPFQL5Tqv7AFnkWsF","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DsGgv5pK.js","utils-B0h6ZXi-.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-IgrnFwPw.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C49-TBER.js","snippetPresets-BPHn-9OB.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CGBwAHwX.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BjABHCCH.js","shallow-C0Uj5sOI.js","getApiPlaygroundDisplay-BnYiIeY4.js","CodeSnippet-BJWWrlBw.js","CodeSnippets-bxE5aDye.js","Page-BBU7roUf.js","getPastedJson-BAjriezQ.js","icon-BqcS52QC.js","MethodPill-BPGyN9me.js","DuplicateIcon-CCf2giLL.js","createIcon-CVH8aNt2.js","DynamicMarkdown-BklwmxA6.js","SectionHeading-DYCZQFxh.js","axios-vUo_bRtp.js","Markdown-D26rHnOC.js","clsx-DkiOUx4h.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DI8jfVGc.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DwJy-csb.js"]}