Alphaus Billing API

(BETA) Billing API. Base URL: https://api.alphaus.cloud/m/blue/billing

Operations 146

GET /billing/v1/reseller/announcements/{announcementId} Gets the announcement list. #
GET /v1/accessgroups Lists access group. Only available in Ripple. #
POST /v1/accessgroups Registers the access group. Only available in Ripple. #
GET /v1/accessgroups/{accessGroupId} WORK-IN-PROGRESS: Gets an access group. #
DELETE /v1/accessgroups/{id} Deletes the access group. Only available in Ripple. #
PUT /v1/accessgroups/{id} Updates the access group. Only available in Ripple. #
GET /v1/adjustmentconfig/{vendor} Gets adjustment config #
DELETE /v1/adjustmentconfig/{vendor} Deletes adjustment config #
POST /v1/adjustmentconfig/{vendor} Creates adjustment config #
PUT /v1/adjustmentconfig/{vendor} Updates adjustment config #
POST /v1/aws/dailyrunhistory:read Reads the daily calculation history of all accounts in your billing groups. Only available in Ripple. #
POST /v1/billinggroup/account Add a vendor account to a billing group. #
POST /v1/billinggroup/customfield Add a custom field into a billing group #
DELETE /v1/billinggroup/customfield/{groupId}/{customFieldId} Remove a custom field from a billing group #
POST /v1/billinggroup/customfield:read Show all the billing groups custom fields #
GET /v1/billinggroup/reseller/announcements/{groupId} Gets the announcement list for billing group #
POST /v1/billinggroup/tags Add Tags to the billing group #
DELETE /v1/billinggroup/{id} Delete a billing group. #
GET /v1/billinggroup/{id}/{vendor}/supportplan WORK-IN-PROGRESS: Gets the account support plan in billing group. Only available in Ripple. #
PUT /v1/billinggroup/{id}/{vendor}/supportplan WORK-IN-PROGRESS: Updates the account support plan in billing group. Only available in Ripple. #
POST /v1/billinggroup/{id}/{vendor}/untaggedgroups Sets non-tag group settings for a billing group. #
PUT /v1/billinggroup/{id}:additionalCharges WORK-IN-PROGRESS: Update additonal charges for a billing group #
PUT /v1/billinggroup/{id}:basicInfo Update billing group basic information #
PUT /v1/billinggroup/{id}:customFields WORK-IN-PROGRESS: Update billing group custom fields information #
PUT /v1/billinggroup/{id}:freeFormat WORK-IN-PROGRESS: Update billing group custom fields information #
PUT /v1/billinggroup/{id}:invoiceSettings WORK-IN-PROGRESS: Update invoice settings for a billing group #
PUT /v1/billinggroup/{id}:resellerCharges WORK-IN-PROGRESS: Update reseller charges for a billing group #
PUT /v1/billinggroup/{id}:resources WORK-IN-PROGRESS: Update linked resources for a billing group #
GET /v1/billinggroups Lists all billing groups (streamed). #
POST /v1/billinggroups Registers a billing group. #
GET /v1/billinggroups/billingconductor/{id} WORK-IN-PROGRESS: Gets all Billing Groups in AWS Billing Conductor(ABC) for specific payer id. #
GET /v1/billinggroups/billingconductor/{payerId}/accounts WORK-IN-PROGRESS: Gets all accounts associated to AWS Billing Conductor(ABC) Billing group #
POST /v1/billinggroups/children Creates a child billing group under a parent billing group #
GET /v1/billinggroups/children/{internalId} Gets child billing group info #
DELETE /v1/billinggroups/children/{internalId} Deletes all child billing group info #
PUT /v1/billinggroups/children/{internalId} Updates child billing group's basic info #
PUT /v1/billinggroups/children/{internalId}/invoiceSettings Updates child billing group's invoice settings #
GET /v1/billinggroups/children/{internalId}/serviceDiscounts Returns the service discount associated with the billing group id #
POST /v1/billinggroups/children/{internalId}/serviceDiscounts Sets the child billing group invoice service discounts. Only available in Ripple. #
GET /v1/billinggroups/children/{internalId}/serviceDiscounts/accounts:read Returns the account's service discounts associated with the child billing group id #
POST /v1/billinggroups/children/{internalId}/serviceDiscounts/accounts:set Sets the child billing group's account invoice service discounts. Only available in Ripple. #
POST /v1/billinggroups/children:read Lists child billing groups under a specific filter #
GET /v1/billinggroups/exclude-service-settings List Exclude Service Entries #
DELETE /v1/billinggroups/exclude-service-settings Delete Exclude Service Entry #
POST /v1/billinggroups/exclude-service-settings Create Exclude Service Entry #
PUT /v1/billinggroups/exclude-service-settings Update Exclude Service Entry #
POST /v1/billinggroups/merged Registers a billing group with Merged Endpoints. Only available in Ripple. WORK IN PROGRESS #
GET /v1/billinggroups/{billingInternalId} Gets a billing group. #
GET /v1/billinggroups/{id}/invoicelayoutconfig WORK-IN-PROGRESS. Gets the billing group invoice layout configs, used for overriding MSP level configs. #
DELETE /v1/billinggroups/{id}/invoicelayoutconfig WORK-IN-PROGRESS. Unsets the billing group invoice layout config. #
POST /v1/billinggroups/{id}/invoicelayoutconfig WORK-IN-PROGRESS. Sets the billing group invoice layout configs. #
POST /v1/billinggroups/{id}/invoicetemplate Creates/Updates a billing group's invoice template. Only available in Ripple. #
POST /v1/billinggroups:bulkCreate Create billing group in bulk from CSV file. Returns a long-running operation. Poll status via the Operations service (GET /ops/v1/{name}). #
POST /v1/billinggroups:bulkLinkAccount Link accounts to a billing group in bulk from a CSV file. Returns a long-running operation. Poll status via the Operations service (GET /ops/v1/{name}). #
POST /v1/billinggroups:bulkTag Bulk-tag multiple billing groups from a CSV file. Supports add, delete, and dry-run modes. Returns a long-running operation. Poll status via the Operations service (GET /ops/v1/{na #
GET /v1/billinggroups:paginated Lists all billing groups with pagination support. #
GET /v1/credits Gets the credits #
GET /v1/csvsettings Gets the csv column settings #
POST /v1/customfield Creates new customfield #
DELETE /v1/customfield/{id} Deletes the customfield #
PUT /v1/customfield/{id} Update the `customField` specified id, modifying its key and description #
POST /v1/customfield:read Returns all registered customfields #
POST /v1/customizedbillingservices Creates the customized billing service. Only available in Ripple. #
GET /v1/customizedbillingservices/billinggroup/{groupId}/{vendor} Gets the customized billing service in billing group. Only available in Ripple. #
DELETE /v1/customizedbillingservices/billinggroup/{groupId}/{vendor} Deletes the customized billing service in billing group. Only available in Ripple. #
POST /v1/customizedbillingservices/billinggroup/{groupId}/{vendor} Sets the customized billing service in billing group. Only available in Ripple. #
GET /v1/customizedbillingservices/{id} Gets the customized billing service. Only available in Ripple. #
DELETE /v1/customizedbillingservices/{id} Deletes the customized billing service. Only available in Ripple. #
PUT /v1/customizedbillingservices/{id} Updates the customized billing service by updating the fields specified in the update mask. Only available in Ripple. #
POST /v1/customizedbillingservices:read Reads the customized billing service. Only available in Ripple. #
POST /v1/exchangerate/billinggroup/{month} Set billing group exchangerate. Only available in Ripple. #
POST /v1/exchangerate/global/{vendor}/{month} Set global exchangerate. Only available in Ripple. #
POST /v1/exchangerate/payer/{month} Set payer exchangerate. Only available in Ripple. #
GET /v1/exportcsv/billing-group Export the billing groups into csv format #
GET /v1/exportcsv/invoice-setting Exports the invoice settings into csv format #
POST /v1/freeformat Creates new billing group free format item (miscellaneous) #
GET /v1/freeformat/{groupId} Get billing group free format item (miscellaneous) #
DELETE /v1/freeformat/{groupId} Delete billing group free format item (miscellaneous) #
GET /v1/invoice/displaysettings WORK-IN-PROGRESS: Gets the invoice display settings for invoice-ui #
POST /v1/invoice/displaysettings Creates/Updates an invoice display settings. Only available in Ripple. #
PUT /v1/invoice/exchangerate/{month} Update invoice exchangerate for the month #
POST /v1/invoice/status/{date}:read Reads an invoice status. Only available in Ripple. #
GET /v1/invoice/status/{id} Gets an invoice. Only available in Ripple. #
GET /v1/invoice/template Lists Invoice Template. Only available in Ripple. #
POST /v1/invoice/{date}:converttopdf WORK-IN-PROGRESS: Convert invoice to pdf #
POST /v1/invoice/{date}:create Creates an invoice. Only available in Ripple. #
POST /v1/invoice/{date}:create&savesettings Creates an invoice and add settings. Only available in Ripple. #
POST /v1/invoice/{date}:export Exports an invoice. #
PUT /v1/invoice/{date}:preview Updates an invoice preview. Only available in Ripple. #
POST /v1/invoice/{date}:read Gets an invoice. #
POST /v1/invoice/{date}:savesettings WORK-IN-PROGRESS: Save invoice settings for the month #
POST /v1/invoice:read Reads list of the invoice. #
POST /v1/invoicelayoutconfig WORK-IN-PROGRESS. Creates an invoice layout config. #
DELETE /v1/invoicelayoutconfig/{id} WORK-IN-PROGRESS. Delete an invoice layout config. #
PUT /v1/invoicelayoutconfig/{id} WORK-IN-PROGRESS. Updates an invoice layout config. #
POST /v1/invoicelayoutconfig:read WORK-IN-PROGRESS. Reads all invoice layout config under an msp. #
POST /v1/reseller/announcement Creates new announcement for wave users #
DELETE /v1/reseller/announcement/{announcementId} #
PUT /v1/reseller/announcement/{announcementId} Full update existing announcement #
PATCH /v1/reseller/announcements/bulk/status Update multiple announcements status #
PATCH /v1/reseller/announcements/{announcementId}/date Update announcement date #
GET /v1/resellers ListResellers #
POST /v1/resellers Registers the reseller account. Only available in Ripple. #
GET /v1/resellers/{id} Gets the reseller account. Only available in Ripple. #
DELETE /v1/resellers/{id} Deletes the reseller account. Only available in Ripple. #
PUT /v1/resellers/{id} Updates the reseller account. Only available in Ripple. #
GET /v1/resources/accounts/{vendor} WORK-IN-PROGRESS: Returns all registered accounts that are not associated to any billing groups and accounts found in CUR for the specified month. For Ripple only #
POST /v1/servicediscounts Creates the invoice service discounts. Only available in Ripple. #
POST /v1/servicediscounts/account:export Exports service discounts for account in billing group. Only available in Ripple. #
POST /v1/servicediscounts/billinggroup:export Exports service discounts for billing group. Only available in Ripple. #
DELETE /v1/servicediscounts/{groupId}/account Deletes the account invoice service discounts. Only available in Ripple. #
POST /v1/servicediscounts/{groupId}/account Registers the account invoice service discounts. Only available in Ripple. #
PUT /v1/servicediscounts/{groupId}/account Updates the account invoice service discounts. Only available in Ripple. #
POST /v1/servicediscounts/{groupId}/account:read Reads the account invoice service discounts. Only available in Ripple. #
PUT /v1/servicediscounts/{groupId}/account:remove Removes the account invoice service discounts. Only available in Ripple. #
GET /v1/servicediscounts/{groupId}/billinggroup Returns the service discount associated with the billing group id #
DELETE /v1/servicediscounts/{groupId}/billinggroup Deletes the billing group invoice service discounts. Only available in Ripple. #
POST /v1/servicediscounts/{groupId}/billinggroup Registers the billing group invoice service discounts. Only available in Ripple. #
PUT /v1/servicediscounts/{groupId}/billinggroup Updates the billing group invoice service discounts. Only available in Ripple. #
GET /v1/servicediscounts/{id} Gets the invoice service discounts. Only available in Ripple. #
DELETE /v1/servicediscounts/{id} Deletes the invoice service discounts. Only available in Ripple. #
PUT /v1/servicediscounts/{id} Updates the invoice service discounts. Only available in Ripple. #
POST /v1/servicediscounts/{vendor}/services:read Reads the service relate to the service discounts. Only available in Ripple. #
POST /v1/servicediscounts:export Exports service discounts. Only available in Ripple. #
POST /v1/servicediscounts:read Reads the invoice service discounts. Only available in Ripple. #
GET /v1/settings WORK-IN-PROGRESS: Gets all billing settings. #
GET /v1/tags Returns the customer details and its tags. Port for: m/ripple/tags/vendor/{vendor}?type={type} #
POST /v1/{vendor}/adjustmententries/customfees Creates custom fee entries in the RIPPLE_FEES table. Used to write Guaranteed Commitment entries and Custom Fee entries directly to the fee table. Only available in Ripple. #
GET /v1/{vendor}/adjustmententries/{id} Gets the adjustment entry. Only available in Ripple. #
POST /v1/{vendor}/adjustmententries/{id}/allocate Allocates the adjustment entry item. Only available in Ripple. #
POST /v1/{vendor}/adjustmententries/{id}/allocate:restore Restores the allocate adjustment entry item. Only available in Ripple. #
POST /v1/{vendor}/adjustmententries/{id}/split Splits the adjustment entry item. Only available in Ripple. #
POST /v1/{vendor}/adjustmententries/{id}/split:restore Restores the splitted adjustment entry item. Only available in Ripple. #
POST /v1/{vendor}/adjustmententries:apply Applies the adjustment entry item. Only available in Ripple. #
POST /v1/{vendor}/adjustmententries:read Reads the adjustment entries. Only available in Ripple. #
POST /v1/{vendor}/adjustmententries:restore Restores the adjustment entry item. Only available in Ripple. #
POST /v1/{vendor}/adjustmententryitems:read Lists adjustment entry items from the fee table. Reads fee entries from the RIPPLE_FEES table, optionally filtered by mobingi_type. Note: Commitment entries (mobingi_type="COMMITME #
GET /v1/{vendor}/billinggroups/children/{internalId}/customizedBillingService Gets the customized billing service in child billing group. Only available in Ripple. #
POST /v1/{vendor}/billinggroups/children/{internalId}/customizedBillingService Sets the customized billing service in child billing group. Only available in Ripple. #
GET /v1/{vendor}/exchangerate/{month} ListExchangeRates #
POST /v1/{vendor}/invoiceadjustments:read Reads the adjustment details involved in invoicing of an organization billing group (Wave). #
GET /v1/{vendor}/services Lists available cloud services and their associated SKUs for a given vendor. Use this to retrieve service codes and names that can be referenced in exclude service settings. #
GET /v1/{vendor}/tagsaddingsetting/{groupId} #
PUT /v1/{vendor}/tagsaddingsetting/{groupId} #
POST /v1/{vendor}/untaggedgroups:read Reads the untagged group. Only available in Ripple. #
POST /v1/{vendor}/usagecostsdrift:read Returns a list of accounts that have been updated after invoice along with the differences in costs, if any. Only available in Ripple. #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/alphaus-billing-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

alphaus-billing-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Blue API reference Admin Billing API
  description: 'Alphaus provides an API for interacting with its services. Blue API is a RESTful API that can be accessed by an HTTP client such as `curl`, or any HTTP library which is part of most modern programming languages. This API reference is autogenerated from [protocol buffers](https://developers.google.com/protocol-buffers) defined in this [repository](https://github.com/alphauslabs/blueapi), together with our supported [client libraries](https://alphauslabs.github.io/docs/blueapi/client-sdks/). See the official [documentation](https://alphauslabs.github.io/docs/blueapi/overview/) for more information.


    You may encounter the following feature maturity indicators:

    - **(WORK-IN-PROGRESS)** - Development is ongoing, don''t use yet;

    - **(BETA)** - New or experimental features, subject to changes; and

    - **(DEPRECATED)** - Outdated or replaced features.


    Some endpoints, especially those that return lists of resources, have streaming responses; newline-separated stream of “chunks”. Each chunk is an envelope that can contain either a response message or an error. Only the last chunk will include an error, if any.'
  version: v1
servers:
- url: https://api.alphaus.cloud/m/blue
  description: Base URL reconciled from apis.yml
tags:
- name: Billing
  description: '(BETA) Billing API. Base URL: https://api.alphaus.cloud/m/blue/billing'
  externalDocs:
    description: Service definition
    url: https://github.com/alphauslabs/blueapi/tree/main/billing/
paths:
  /billing/v1/reseller/announcements/{announcementId}:
    get:
      summary: Gets the announcement list.
      operationId: Billing_GetAnnouncements
      responses:
        '200':
          description: A successful response.(streaming responses)
          content:
            application/json:
              schema:
                type: object
                properties:
                  result:
                    $ref: '#/components/schemas/v1Announcement'
                  error:
                    $ref: '#/components/schemas/rpcStatus'
                title: Stream result of v1Announcement
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: announcementId
        description: Optional. Set empty to return all
        in: path
        required: true
        schema:
          type: string
      tags:
      - Billing
  /v1/accessgroups:
    get:
      summary: Lists access group. Only available in Ripple.
      operationId: Billing_ListAccessGroups
      responses:
        '200':
          description: A successful response.(streaming responses)
          content:
            application/json:
              schema:
                type: object
                properties:
                  result:
                    $ref: '#/components/schemas/apiRippleAccessGroup'
                  error:
                    $ref: '#/components/schemas/rpcStatus'
                title: Stream result of apiRippleAccessGroup
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: fieldMask
        description: 'Optional. Get only the value that set fieldMask.


          see more info: https://github.com/protocolbuffers/protobuf/blob/main/src/google/protobuf/field_mask.proto'
        in: query
        required: false
        schema:
          type: string
      tags:
      - Billing
    post:
      summary: Registers the access group. Only available in Ripple.
      operationId: Billing_CreateAccessGroup
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/apiRippleAccessGroup'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      tags:
      - Billing
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1CreateAccessGroupRequest'
        description: Request message for the CreateAccessGroup rpc.
        required: true
  /v1/accessgroups/{accessGroupId}:
    get:
      summary: 'WORK-IN-PROGRESS: Gets an access group.'
      operationId: Billing_GetAccessGroup
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1GetAccessGroupResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: accessGroupId
        in: path
        required: true
        schema:
          type: string
      - name: fieldMask
        description: 'Optional. Get only the value that set fieldMask.


          see more info: https://github.com/protocolbuffers/protobuf/blob/main/src/google/protobuf/field_mask.proto'
        in: query
        required: false
        schema:
          type: string
      tags:
      - Billing
  /v1/accessgroups/{id}:
    delete:
      summary: Deletes the access group. Only available in Ripple.
      operationId: Billing_DeleteAccessGroup
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                type: object
                properties: {}
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: id
        description: Required. access group id.
        in: path
        required: true
        schema:
          type: string
      tags:
      - Billing
    put:
      summary: Updates the access group. Only available in Ripple.
      operationId: Billing_UpdateAccessGroup
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/apiRippleAccessGroup'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: id
        description: Required. access group id.
        in: path
        required: true
        schema:
          type: string
      tags:
      - Billing
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BillingUpdateAccessGroupBody'
        required: true
  /v1/adjustmentconfig/{vendor}:
    get:
      summary: Gets adjustment config
      operationId: Billing_GetAdjustmentConfig
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/apiAdjustmentConfig'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: vendor
        description: Required. At the moment, only `aws` is supported.
        in: path
        required: true
        schema:
          type: string
      - name: includeSPPDiscount
        in: query
        required: false
        schema:
          type: boolean
      tags:
      - Billing
    delete:
      summary: Deletes adjustment config
      operationId: Billing_DeleteAdjustmentConfig
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                type: object
                properties: {}
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: vendor
        description: Required. At the moment, only `aws` is supported.
        in: path
        required: true
        schema:
          type: string
      tags:
      - Billing
    post:
      summary: Creates adjustment config
      description: "[ERRORS] \n- InvalidArgument:\n - the AdjustmentConfig is already exists.\n- NotFound:\n - the AdjustmentConfig is not found."
      operationId: Billing_CreateAdjustmentConfig
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/apiAdjustmentConfig'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: vendor
        description: Required. At the moment, only `aws` is supported.
        in: path
        required: true
        schema:
          type: string
      tags:
      - Billing
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BillingCreateAdjustmentConfigBody'
        required: true
    put:
      summary: Updates adjustment config
      operationId: Billing_UpdateAdjustmentConfig
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/apiAdjustmentConfig'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: vendor
        description: Required. At the moment, only `aws` is supported.
        in: path
        required: true
        schema:
          type: string
      tags:
      - Billing
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BillingUpdateAdjustmentConfigBody'
        required: true
  /v1/aws/dailyrunhistory:read:
    post:
      summary: Reads the daily calculation history of all accounts in your billing groups. Only available in Ripple.
      operationId: Billing_ListAwsDailyRunHistory
      responses:
        '200':
          description: A successful response.(streaming responses)
          content:
            application/json:
              schema:
                type: object
                properties:
                  result:
                    $ref: '#/components/schemas/v1AwsDailyRunHistory'
                  error:
                    $ref: '#/components/schemas/rpcStatus'
                title: Stream result of v1AwsDailyRunHistory
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      tags:
      - Billing
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1ListAwsDailyRunHistoryRequest'
        description: Request message for the Billing.ListAwsCalculationHistory rpc.
        required: true
  /v1/billinggroup/account:
    post:
      summary: Add a vendor account to a billing group.
      operationId: Billing_AddAccountToBillingGroup
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                type: object
                properties: {}
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      tags:
      - Billing
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1AddAccountToBillingGroupRequest'
        required: true
  /v1/billinggroup/customfield:
    post:
      summary: Add  a custom field into a billing group
      operationId: Billing_AddBillingGroupCustomField
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                type: object
                properties: {}
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      tags:
      - Billing
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1AddBillingGroupCustomFieldRequest'
        required: true
  /v1/billinggroup/customfield/{groupId}/{customFieldId}:
    delete:
      summary: Remove a custom field from a billing group
      operationId: Billing_DeleteBillingGroupCustomField
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                type: object
                properties: {}
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: groupId
        description: Required. Billing group internal Id
        in: path
        required: true
        schema:
          type: string
      - name: customFieldId
        description: Required. The id of customfield from get customfield
        in: path
        required: true
        schema:
          type: string
      tags:
      - Billing
  /v1/billinggroup/customfield:read:
    post:
      summary: Show all the billing groups custom fields
      operationId: Billing_ListBillingGroupCustomField
      responses:
        '200':
          description: A successful response.(streaming responses)
          content:
            application/json:
              schema:
                type: object
                properties:
                  result:
                    $ref: '#/components/schemas/v1ListBillingGroupCustomFieldResponse'
                  error:
                    $ref: '#/components/schemas/rpcStatus'
                title: Stream result of v1ListBillingGroupCustomFieldResponse
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      tags:
      - Billing
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1ListBillingGroupCustomFieldRequest'
        required: true
  /v1/billinggroup/reseller/announcements/{groupId}:
    get:
      summary: Gets the announcement list for billing group
      operationId: Billing_GetBillingGroupAnnouncements
      responses:
        '200':
          description: A successful response.(streaming responses)
          content:
            application/json:
              schema:
                type: object
                properties:
                  result:
                    $ref: '#/components/schemas/v1GetBillingGroupAnnouncementsResponse'
                  error:
                    $ref: '#/components/schemas/rpcStatus'
                title: Stream result of v1GetBillingGroupAnnouncementsResponse
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: groupId
        description: Optional. Set empty to return all
        in: path
        required: true
        schema:
          type: string
      tags:
      - Billing
  /v1/billinggroup/tags:
    post:
      summary: Add Tags to the billing group
      operationId: Billing_AddTagsToBillingGroup
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                type: object
                properties: {}
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      tags:
      - Billing
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1AddTagsToBillingGroupRequest'
        required: true
  /v1/billinggroup/{id}:
    delete:
      summary: Delete a billing group.
      operationId: Billing_DeleteBillinGroup
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                type: object
                properties: {}
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      tags:
      - Billing
  /v1/billinggroup/{id}/{vendor}/supportplan:
    get:
      summary: 'WORK-IN-PROGRESS: Gets the account support plan in billing group. Only available in Ripple.'
      operationId: Billing_GetBillingGroupAccountSupportPlan
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1GetBillingGroupAccountSupportPlanResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: id
        description: Required. The billing internal id.
        in: path
        required: true
        schema:
          type: string
      - name: vendor
        description: Required. At the moment, `aws` is supported.
        in: path
        required: true
        schema:
          type: string
      tags:
      - Billing
    put:
      summary: 'WORK-IN-PROGRESS: Updates the account support plan in billing group. Only available in Ripple.'
      operationId: Billing_UpdateBillingGroupAccountSupportPlan
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                type: object
                properties: {}
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: id
        description: Required. The billing internal id.
        in: path
        required: true
        schema:
          type: string
      - name: vendor
        description: Required. At the moment, `aws` is supported.
        in: path
        required: true
        schema:
          type: string
      tags:
      - Billing
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BillingUpdateBillingGroupAccountSupportPlanBody'
        required: true
  /v1/billinggroup/{id}/{vendor}/untaggedgroups:
    post:
      summary: Sets non-tag group settings for a billing group.
      operationId: Billing_UpdateNonTagGroupToBillingGroup
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                type: object
                properties: {}
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: id
        description: Required. The billing group's internal id
        in: path
        required: true
        schema:
          type: string
      - name: vendor
        description: Required. The vendor (aws, azure, etc)
        in: path
        required: true
        schema:
          type: string
      tags:
      - Billing
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BillingUpdateNonTagGroupToBillingGroupBody'
        required: true
  /v1/billinggroup/{id}:additionalCharges:
    put:
      summary: 'WORK-IN-PROGRESS: Update  additonal charges for a billing group'
      operationId: Billing_UpdateBillingGroupAdditionalCharges
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                type: object
                properties: {}
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      tags:
      - Billing
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BillingUpdateBillingGroupAdditionalChargesBody'
        required: true
  /v1/billinggroup/{id}:basicInfo:
    put:
      summary: Update billing group basic information
      operationId: Billing_UpdateBillingGroupBasicInformation
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                type: object
                properties: {}
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      tags:
      - Billing
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BillingUpdateBillingGroupBasicInformationBody'
        required: true
  /v1/billinggroup/{id}:customFields:
    put:
      summary: 'WORK-IN-PROGRESS: Update billing group custom fields information'
      operationId: Billing_UpdateBillingGroupCustomFields
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                type: object
                properties: {}
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      tags:
      - Billing
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BillingUpdateBillingGroupCustomFieldsBody'
        required: true
  /v1/billinggroup/{id}:freeFormat:
    put:
      summary: 'WORK-IN-PROGRESS: Update billing group custom fields information'
      operationId: Billing_UpdateBillingGroupFreeFormat
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                type: object
                properties: {}
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      tags:
      - Billing
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BillingUpdateBillingGroupFreeFormatBody'
        required: true
  /v1/billinggroup/{id}:invoiceSettings:
    put:
      summary: 'WORK-IN-PROGRESS: Update invoice settings for a billing group'
      operationId: Billing_UpdateBillingGroupInvoiceSettings
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                type: object
                properties: {}
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      tags:
      - Billing
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BillingUpdateBillingGroupInvoiceSettingsBody'
        required: true
  /v1/billinggroup/{id}:resellerCharges:
    put:
      summary: 'WORK-IN-PROGRESS: Update reseller charges for a billing group'
      operationId: Billing_UpdateBillingGroupResellerCharges
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                type: object
                properties: {}
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      tags:
      - Billing
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BillingUpdateBillingGroupResellerChargesBody'
        required: true
  /v1/billinggroup/{id}:resources:
    put:
      summary: 'WORK-IN-PROGRESS: Update linked resources for a billing group'
      operationId: Billing_UpdateBillingGroupLinkedResources
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                type: object
                properties: {}
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      tags:
      - Billing
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BillingUpdateBillingGroupLinkedResourcesBody'
        required: true
  /v1/billinggroups:
    get:
      summary: Lists all billing groups (streamed).
      operationId: Billing_ListBillingGroups
      responses:
        '200':
          description: A successful response.(streaming responses)
          content:
            application/json:
              schema:
                type: object
                properties:
                  result:
                    $ref: '#/components/schemas/billingV1BillingGroup'
                  error:
                    $ref: '#/components/schemas/rpcStatus'
                title: Stream result of billingV1BillingGroup
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: fieldMask
        description: 'Optional. Get only the value that set fieldMask.


          see more info: https://github.com/protocolbuffers/protobuf/blob/main/src/google/protobuf/field_mask.proto'
        in: query
        required: false
        schema:
          type: string
      - name: vendors
        description: 'Optional. Filter vendor accounts included in BillingGroup. Format: vendors=vendor1,vendor2,vendor3.

          For example, When Aws and Gcp to be filtered vendors=aws,gcp

          If you want to get all vendors, not set parameter.'
        in: query
        required: false
        schema:
          type: string
      - name: calcType
        description: 'Optional. Filter by calcType. Format: calType=account

          Valid values: account, tag'
        in: query
        required: false
        schema:
          type: string
      - name: displayCost
        description: 'Optional. Filter by displayCost. Format: displayCost=unblended_cost

          valid values: unblended_cost, true_unblended_cost'
        in: query
        required: false
        schema:
          type: string
      - name: bgType
        description: 'Optional. For aws only, filter will be ignored for other vendors.

          Valid values: default, imported'
        in: query
        required: false
        schema:
          type: string
      tags:
      - Billing
    post:
      summary: Registers a billing group.
      operationId: Billing_CreateBillingGroup
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/billingV1BillingGroup'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      tags:
      - Billing
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1CreateBillingGroupRequest'
        description: Request message for the Billing.CreateBillingGroup rpc.
        required: true
  /v1/billinggroups/billingconductor/{id}:
    get:
      summary: 'WORK-IN-PROGRESS: Gets all Billing Groups in AWS Billing Conductor(ABC) for specific payer id.'
      operationId: Billing_ListAbcBillingGroups
      responses:
        '200':
          description: A successful response.(streaming responses)
          content:
            application/json:
              schema:
                type: object
                properties:
                  result:
                    $ref: '#/components/schemas/v1AbcBillingGroup'
                  error:
                    $ref: '#/components/schemas/rpcStatus'
                title: Stream result of v1AbcBillingGroup
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: id
        description: Required. Payer Id.
        in: path
        required: true
        schema:
          type: string
      tags:
      - Billing
  /v1/billinggroups/billingconductor/{payerId}/accounts:
    get:
      summary: 'WORK-IN-PROGRESS: Gets all accounts associated to AWS Billing Conductor(ABC) Billing group'
      operationId: Billing_ListAbcBillingGroupAccounts
      responses:
        '200':
          description: A successful response.(streaming responses)
          content:
            application/json:
              schema:
                type: object
                properties:
                  result:
                    $ref: '#/components/schemas/v1AbcAccount'
                  error:
                    $ref: '#/components/schemas/rpcStatus'
                title: Stream result of v1AbcAccount
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: payerId
        

# --- truncated at 32 KB (293 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/alphaus/refs/heads/main/openapi/alphaus-billing-api-openapi.yml