---
title: "Get current Surface usage status"
method: GET
path: "/api/me/surface/usage"
tags: ["Surface"]
---

# Get current Surface usage status

`GET /api/me/surface/usage`

## Request

- Base URL: `https://api.sponsorunited.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.sponsorunited.com/api/me/surface/usage`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/sponsorunited/apis/sponsorunited-api/docs/api/me/surface/usage/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the authenticated user's current Surface prompt usage status including limit, used count, remaining count, and threshold warning state.

## Response `200`

Current usage status

- SurfaceUsageResource
  - `usage` object
    - `limit` integer: Monthly prompt limit (0 = unlimited)
    - `used` integer: Prompts used this month
    - `remaining` integer: Prompts remaining this month
    - `limit_type` 'user' | 'organization': Whether limit applies per user or per organization
    - `reset_date` string, date: First day of next month when usage resets
    - `threshold_warning` '75' | '100', nullable: Non-null only on first crossing of 75% or 100% threshold

## Other responses

- `401`: Unauthenticated

---

[API](https://skmtc.dev/sponsorunited/apis/sponsorunited-api.md) - [All operations](https://skmtc.dev/sponsorunited/apis/sponsorunited-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sponsorunited/apis/sponsorunited-api/revisions/cbf1ca5bff8f?raw)