# Retrieve a grant

Retrieves a single grant.

Endpoint: GET /v3/users/{userId}/grants/{grantId}
Version: 2026-01-08
Security: ZephrHmacHttp

## Path parameters:

  - `userId` (string, required)
    Unique User identifier

  - `grantId` (string, required)
    Unique Grant identifier

## Response 200 fields (application/json):

  - `grantId` (string)
    Example: "e196ad75-a6d0-471b-90b3-de3843dd7860"

  - `user_id` (string)
    Example: "e1812285-2f21-441e-8be4-b08835cd4b2c"

  - `account_id` (string)
    Example: "14515649-565f-4b1c-8346-eb98301c1d6b"

  - `expiry_state` (string)
    Enum: "pending", "active", "expired"

  - `entitlement_type` (string, required)
    An enum describing the type of the entitlement.
    Enum: "bundle", "entitlement", "meter", "credits"

  - `entitlement_id` (string, required)
    Example: "b74df5c4-fded-492c-ad90-07646bded5db"

  - `startTime` (string)
    Example: "2022-06-01 00:00:00"

  - `endTime` (string)
    Example: "2022-12-31 23:59:59"

  - `product_id` (string, required)
    Example: "86abb44a-e6f2-4f9b-ac26-46ae0a13ed31"

  - `createdAt` (string)
    Example: "2022-05-31 23:59:59"