---
title: "Get User Grant Cycle"
method: GET
path: "/api/v2/minikit/user-grant-cycle"
---

# Get User Grant Cycle

`GET /api/v2/minikit/user-grant-cycle`

Retrieve the next grant claim date for a user of your mini app. Returns the user's humanity (orb-verified) grant cycle date if available, otherwise falls back to their document (passport-verified) grant cycle date.

## Query parameters

- `wallet_address` string, required
- `app_id` string, required

## Response `200`

Next grant date

- UserGrantCycleResponse
  - `success` boolean
  - `status` integer
  - `result` object
    - `nextGrantClaimUTCDate` string, date-time

## Other responses

- `400` — User not found / app not installed / no active cycles

---

[API](https://skmtc.dev/world/apis/developer-portal-api.md) · [All operations](https://skmtc.dev/world/apis/developer-portal-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/world/developer-portal-api/revisions/a99055a8765b/schema)