---
title: "Get Entitlements"
method: GET
path: "/resources/entitlements/v2"
tags: ["Entitlements"]
---

# Get Entitlements

`GET /resources/entitlements/v2`

## Request

- Base URL: `http://localhost:8181`
- URL: `http://localhost:8181/resources/entitlements/v2`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/frontegg/apis/entitlements-agent-pdp/docs/resources/entitlements/v2/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve a paginated list of Entitlements, with the ability to order, sort (`ASC` for ascending, `DESC` for descending), and filter results( expiration date (`expirationDate`) or create date (`createdAt`) fields

## Query parameters

- `offset` number
- `limit` number
- `sortType` 'ASC' | 'DESC'
- `planId` string
- `planIds` string[]
- `assignLevel` 'USER' | 'TENANT'
- `orderBy` 'expirationDate' | 'createdAt'
- `userIds` string[]
- `tenantIds` string[]
- `withRelations` boolean

## Response `200`

- object
  - `items` EntitlementDto[]
    - `id` string, required: UUID string that represents the entitlement ID
    - `planId` string, required: UUID string that represents the plan ID
    - `tenantId` string, required: UUID string that represents the tenant ID
    - `userId` string: UUID string that represents the user ID
    - `expirationDate` string, date-time: Date of entitlement expiration
    - `createdAt` string, date-time, required: Date when entitlement was created
    - `updatedAt` string, date-time: Date when entitlement was last updated
    - `plan` EntitlementPlan, required
      - `id` string, required: UUID string that represents the plan ID
      - `vendorId` string, required: UUID string that represents the vendor ID
      - `name` string, required: String that represents the plan name
      - `defaultTimeLimitation` number: Number that represents the default time limitation in days for auto-assigned plans
      - `description` string: Feature plan description
      - `createdAt` string, required: Date when plan was created
      - `updatedAt` string: Date when plan was last updated
  - `hasNext` boolean

---

[API](https://skmtc.dev/frontegg/apis/entitlements-agent-pdp.md) - [All operations](https://skmtc.dev/frontegg/apis/entitlements-agent-pdp/llms.txt) - [OpenAPI document](https://skmtc.dev/frontegg/apis/entitlements-agent-pdp/revisions/c496ae9e1c3e?raw)