---
title: "Grant Complimentary Access"
method: POST
path: "/admin/billing/grants"
tags: ["admin", "billing"]
---

# Grant Complimentary Access

`POST /admin/billing/grants`

## Request

- Base URL: `https://api.excellence-ai.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.excellence-ai.com/admin/billing/grants`
- Auth: OAuth 2
  - Password
  - Token URL: `api/login`

## Request body

- AdminGrantCreate
  - `user_id` string, required
  - `ends_at` string, date-time, required
  - `starts_at` string, date-time, nullable
  - `note` string, nullable

## Response `200`

Successful Response

- GrantResponse
  - `kind` 'free_month' | 'admin' | 'free_offer' | 'referral_week' | 'referral_month' | 'legacy_grace', required
  - `starts_at` string, date-time, required
  - `ends_at` string, date-time, required

## Other responses

- `422`: Validation Error

## Changes

> 106 revisions in range; 1 not diffed.

- **2026-11-12** `0af74c49ba7a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/excellence-ai/apis/excellence-learning/changes/admin/billing/grants/post.md)

---

[API](https://skmtc.dev/excellence-ai/apis/excellence-learning.md) - [All operations](https://skmtc.dev/excellence-ai/apis/excellence-learning/llms.txt) - [OpenAPI document](https://skmtc.dev/excellence-ai/apis/excellence-learning/revisions/de6afcc9656f?raw)
