Skip to main content
GET
List usage requests
List members’ requests for more usage, read one request, and decline a request that is still waiting. There is no webhook. Poll the list. To approve a request, raise that member’s plan or extra usage budget and pass usageRequestId on that write. See Billing Users. The calls use the workspace API key’s BILLING_API scope. The decline runs as the key’s service account owner.

Base URL

Dedicated deploymentsReplace api.langdock.com with <your-deployment-url>/api/public in all requests.

Prerequisites

  • API key with the BILLING_API scope
  • The key owner is a service account that has not been deleted and has an active Admin membership
  • USER_MANAGEMENT_API on the same key when you need email or name
status is pending, resolved, or dismissed. Omit it to list every status. Results are oldest first. limit defaults to 50 and cannot exceed 250. Pass cursor from nextCursor. A cursor from another workspace returns 400 with code INVALID_CURSOR. A request answered between two pages does not skip later rows. The list response is { "usageRequests": [ ... ] } and includes nextCursor until the last page. Reading one request returns the request object. A request outside this workspace returns 404 with code NOT_FOUND. Hiding per user spend does not hide these requests. A member who reaches a limit and does not ask is not in this list. To poll, call GET /usage-requests?status=pending and skip the requests you have already handled.
Langdock intentionally blocks browser-origin requests to protect your API key and ensure your applications remain secure. For more information, please see our guide on API Key Best Practices.

Authorizations

Authorization
string
header
required

API key as Bearer token. Format "Bearer YOUR_API_KEY"

Query Parameters

status
enum<string>

Only return requests with this status.

Available options:
pending,
resolved,
dismissed
limit
integer
default:50
Required range: 1 <= x <= 250
cursor
string<uuid>

Use nextCursor from the preceding page.

Response

Successful response.

usageRequests
object[]
required
nextCursor
string<uuid>