Skip to main content
GET
Read a usage request
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
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.
email and name are included only when the key also has USER_MANAGEMENT_API. Without that scope, those fields are omitted. name may be null when it is included. resolution is increased_limit, upgraded_plan, dismissed, or null while the request is pending. resolvedAt and resolvedByUserId are null while it is pending. resolvedByUserId is the admin or service account that answered the request.
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"

Path Parameters

requestId
string<uuid>
required

Response

Successful response.

id
string<uuid>
required
userId
string<uuid>
required
status
enum<string>
required
Available options:
pending,
resolved,
dismissed
createdAt
string<date-time>
required
resolvedAt
string<date-time> | null
required
resolution
enum<string> | null
required

How the request was answered; null while pending.

Available options:
increased_limit,
upgraded_plan,
dismissed,
null
resolvedByUserId
string<uuid> | null
required

Admin or service account that answered the request.

email
string<email>

Present only when the key also has the USER_MANAGEMENT_API scope.

name
string | null

Present only when the key also has the USER_MANAGEMENT_API scope.