Get Billing Requests

Get all billing requests (replacements and refunds)

Endpoint

GET https://api.ugc.inc/billing/requests

Overview

Retrieve all billing requests (replacements and refunds) for your account. Returns requests across all organizations linked to your billing record.

Request

No request body required. Authentication via profile-scoped Bearer token.

Response

data · array

Array of billing request objects

Show Billing request properties

id · string

Request ID

org_id · string

Organization ID the request belongs to

account_id · string

Account ID the request is for

type · 'replacement' | 'refund'

Request type

status · 'pending' | 'approved' | 'denied'

Request status

reason · string | null

Reason provided with the request

created_at · string

ISO 8601 timestamp of when the request was created

resolved_at · string | null

ISO 8601 timestamp of when the request was resolved (null if pending)

cURL

curl https://api.ugc.inc/billing/requests \
  -H "Authorization: Bearer YOUR_API_KEY"

Success Response

{
  "ok": true,
  "code": 200,
  "message": "Success",
  "data": [
    {
      "id": "req_123",
      "org_id": "org_123",
      "account_id": "acc_123",
      "type": "replacement",
      "status": "approved",
      "reason": "Account was banned",
      "created_at": "2025-01-15T10:00:00.000Z",
      "resolved_at": "2025-01-15T10:00:00.000Z"
    },
    {
      "id": "req_124",
      "org_id": "org_123",
      "account_id": "acc_456",
      "type": "refund",
      "status": "pending",
      "reason": "Not satisfied",
      "created_at": "2025-01-20T10:00:00.000Z",
      "resolved_at": null
    }
  ]
}