Goldmine
Billing

Get workspace billing

POST
/billing.v1.Billing/GetWorkspaceBilling

Returns available Goldmine service credit, unbilled usage, amount due and prepaid or postpaid payment terms for the selected workspace. Monetary amounts are exact USD decimal strings with exponent two. Marketplace purchases use external account funds and do not debit this credit.

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/GetWorkspaceBilling" \  -H "Content-Type: application/json" \  -d '{}'
{
  "billing": {
    "amountDue": "string",
    "availableCredit": "string",
    "currency": "string",
    "currencyExponent": 0,
    "invoiceCredit": "string",
    "paymentTerms": "string",
    "providerMode": "string",
    "unbilledUsage": "string",
    "version": "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."
}

GetBillingProfile

Returns the selected workspace profile. Version zero means no profile has been stored. All fields are self-declared and establish no tax or registry verification.

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.