DAdatadog
Usage Metering

List organization temporary grant requests

List all request statuses within the authenticated organization. Filter by pending status for the review queue. Requires Billing Edit, including for reads. Requires an authenticated human user. Service-account credentials are unsupported. Request status remains approved after expiry, revocation, or replacement.

get/api/v2/usage/admin/temporary-grant-requests

Request

Query parameters

filter[status]'pending' | 'approved' | 'denied' | 'cancelled'

The durable request decision, independent of whether its grant is still active.

Example:pending

Optional status. Defaults to all statuses.

page[limit]integer

Page size, from 1 to 100.

page[cursor]string uuid

UUID cursor from meta.page.next_cursor.

filter[requested_by_user_id]string uuid

Filter by requester UUID within the authenticated organization.

Response

OK

Example response

{
  "data": [
    {
      "attributes": {
        "created_at": "2028-02-16T00:00:00Z",
        "decided_at": "2028-02-16T00:00:00Z",
        "decided_by_user_id": "12345678-1234-1234-1234-123456789012",
        "entity_key": "user_handle:jane@example.com",
        "expires_at": "2028-02-16T00:00:00Z",
        "grant_state": "active",
        "justification": "Credits needed to finish the incident investigation.",
        "quota_namespace": "ai_credits",
        "requested_by_user_id": "12345678-1234-1234-1234-123456789012",
        "status": "pending",
        "total": 200
      },
      "id": "12345678-1234-1234-1234-123456789012",
      "type": "temporary_grant_requests"
    }
  ],
  "meta": {
    "page": {
      "next_cursor": "12345678-1234-1234-1234-123456789012"
    }
  }
}

Changes

Changes to this operation have not been checked yet.