Goldmine
Billing

List workspace invoices

POST
/billing.v1.Billing/ListBillingInvoices

Lists monthly invoices for the selected workspace, including exact amounts paid and refunded. Invoice creation and Checkout redirects do not establish payment.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://loading/billing.v1.Billing/ListBillingInvoices" \  -H "Content-Type: application/json" \  -d '{}'
{
  "invoices": [
    {
      "amount": "string",
      "createdAt": "2019-08-24T14:15:22Z",
      "currency": "string",
      "currencyExponent": 0,
      "id": "string",
      "overpaidAmount": "string",
      "paidAmount": "string",
      "periodEnd": "2019-08-24T14:15:22Z",
      "periodStart": "2019-08-24T14:15:22Z",
      "providerMode": "string",
      "refundedAmount": "string",
      "status": "string"
    }
  ],
  "nextCursor": "string"
}
{
  "code": "invalid_argument",
  "message": "The request was malformed, such as a missing required field or an unparseable cursor."
}
{
  "code": "unauthenticated",
  "message": "The request lacks a valid API key in the Authorization header."
}
{
  "code": "permission_denied",
  "message": "The API key is not allowed to perform this action on this workspace."
}
{
  "code": "internal",
  "message": "An internal server error occurred."
}

ListBillingActivity

Returns a bounded keyset page at a committed workspace high-water mark. External marketplace cost is reported separately and never debits Goldmine service credit. Empty history before ingestion is established is not evidence of no historical purchases.

ListBillingPayments

Lists durable payment attempts with actual provider session, payment intent, refund and last event evidence. Pending, failed and expired attempts do not imply a cash movement; a Checkout redirect never establishes payment.