> ## Documentation Index > Fetch the complete documentation index at: https://widgetic.com/llms.txt > Use this file to discover all available pages before exploring further. # Get managed user entitlements > Retrieves all entitlements for a managed user (admin or partner access). ## OpenAPI ````yaml /openapi/widgetic-api-public.json get /entitlements/managed-users/{managedUserId} openapi: 3.0.0 info: title: Widgetic API Gateway version: 1.0.0 description: API documentation for the Widgetic API Gateway license: name: Widgetic Integration License url: https://docs.widgetic.com/resources/license servers: - url: https://api.widgetic.com/v1 description: Production server variables: env: default: production description: Environment apiUrl: default: https://api.widgetic.com description: API URL apiVersion: default: /v1 description: API Version path prefix security: [] tags: [] paths: /entitlements/managed-users/{managedUserId}: get: tags: - Entitlements summary: Get managed user entitlements description: Retrieves all entitlements for a managed user (admin or partner access). operationId: getManagedUserEntitlements parameters: - in: path name: managedUserId required: true schema: type: string format: uuid description: Managed user ID - in: query name: includeExpired schema: type: boolean description: Include expired entitlements in results - in: query name: feature schema: type: string description: Filter by specific feature - in: query name: source schema: type: string description: Filter by entitlement source responses: '200': description: Managed user entitlements retrieved successfully content: application/json: schema: $ref: '#/components/schemas/GetManagedUserEntitlementsResponse' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: Forbidden - You don't have permission to access these entitlements content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - apiKeyAuth: [] x-code-samples: - lang: TypeScript label: TypeScript SDK source: > import { Configuration, EntitlementsApi } from '@widgetic/api-sdk-ts'; const config = new Configuration({ apiKey: 'YOUR_API_KEY' }); const entitlementsApi = new EntitlementsApi(config); try { const entitlements = await entitlementsApi.getManagedUserEntitlements({ managedUserId: '123e4567-e89b-12d3-a456-426614174003' }); console.log('Managed user entitlements:', entitlements); } catch (error) { console.error('Failed to fetch managed user entitlements:', error); } components: schemas: GetManagedUserEntitlementsResponse: type: object required: - success - data properties: success: type: boolean description: Always `true` on a success. example: true data: type: object properties: managedUserId: type: string format: uuid example: 123e4567-e89b-12d3-a456-426614174003 entitlements: type: array items: $ref: '#/components/schemas/Entitlement' meta: $ref: '#/components/schemas/ResponseMeta' ErrorResponse: type: object required: - success - message - error additionalProperties: true properties: success: type: boolean description: Always `false` on a failure. example: false message: type: string description: The same text as `error.message`, for a caller that reads one line. error: $ref: '#/components/schemas/ErrorDetail' Entitlement: type: object description: Feature entitlement for users, partners, or managed users properties: id: type: string format: uuid description: Unique identifier for the entitlement example: 123e4567-e89b-12d3-a456-426614174000 userId: type: string format: uuid description: ID of the user (if user-level entitlement) example: 123e4567-e89b-12d3-a456-426614174001 partnerId: type: string format: uuid description: ID of the partner (if partner-level entitlement) example: 123e4567-e89b-12d3-a456-426614174002 managedUserId: type: string format: uuid description: ID of the managed user (if managed user-level entitlement) example: 123e4567-e89b-12d3-a456-426614174003 feature: type: string description: Feature identifier that this entitlement grants access to example: plan.solo value: type: string description: Value or limit for this feature example: '100' expiresAt: type: string format: date-time description: When this entitlement expires (null for permanent) example: '2024-01-01T00:00:00Z' source: type: string description: Source of the entitlement enum: - subscription - contract - manual - marketplace - addon example: subscription sourceId: type: string description: ID of the source object that granted this entitlement example: 123e4567-e89b-12d3-a456-426614174004 createdAt: type: string format: date-time description: When the entitlement was created example: '2023-01-01T00:00:00Z' updatedAt: type: string format: date-time description: When the entitlement was last updated example: '2023-01-02T00:00:00Z' example: id: 123e4567-e89b-12d3-a456-426614174000 userId: 123e4567-e89b-12d3-a456-426614174001 partnerId: 123e4567-e89b-12d3-a456-426614174002 managedUserId: 123e4567-e89b-12d3-a456-426614174003 feature: plan.solo value: '100' expiresAt: '2024-01-01T00:00:00Z' source: subscription sourceId: 123e4567-e89b-12d3-a456-426614174004 createdAt: '2023-01-01T00:00:00Z' updatedAt: '2023-01-02T00:00:00Z' ResponseMeta: type: object description: >- Extra information about the answer: where a page sits in a list, the cursor of the next page, or warnings about a call that succeeded with a caveat. additionalProperties: true properties: page: type: integer description: The page that was read, counting from 1. example: 1 size: type: integer description: How many items one page holds. example: 20 total: type: integer description: How many items the whole list has. example: 135 limit: type: integer description: The same as `size`. example: 20 offset: type: integer description: How many items come before this page. example: 0 hasNextPage: type: boolean example: true hasPreviousPage: type: boolean example: false nextCursor: type: string nullable: true description: >- Pass this as `cursor` to read the next page of a list that is read by cursor. `null` on the last page. warnings: type: array items: type: string description: >- Things the call did not do, though it succeeded (for example a table that could not be created just now). ErrorDetail: type: object required: - code - message - timestamp properties: code: type: string description: Machine-readable error code. example: RESOURCE_NOT_FOUND message: type: string description: Human-readable explanation. example: Composition not found param: type: string description: The field that caused the error, when one did. example: name docUrl: type: string description: Where this error is explained. suggestedAction: type: string description: What to do about it. retryAfter: type: integer description: >- Seconds to wait before trying again (rate limits). The same number is in the `Retry-After` header. example: 60 details: type: object additionalProperties: true description: >- More about the error: the fields that failed, a limit that was reached. correlationId: type: string description: Quote this when you ask support about the call. example: req_123e4567-e89b-12d3-a456-426614174000 timestamp: type: string format: date-time example: '2026-10-15T10:00:00.000Z' securitySchemes: apiKeyAuth: type: http scheme: bearer bearerFormat: JWT ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.