Get 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.

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

Get User Grant Cycle

cURL

curl --request GET \
  --url https://developer.world.org/api/v2/minikit/user-grant-cycle

200

{
  "success": true,
  "status": 123,
  "result": {
    "nextGrantClaimUTCDate": "2023-11-07T05:31:56Z"
  }
}

Query Parameters

wallet_address · string · required

The wallet_address of the user to query. Must be exactly 42 characters long.

Required string length: 42

app_id · string · required

The app_id of your mini app.

Response

200

application/json

Next grant date

success · boolean

status · integer

result · object

Show child attributes