Rigetti Computing account API

The account API from Rigetti Computing — 22 operation(s) for account.

Operations 23

GET /v1/groups/{groupName}/balance Get Group Balance #
GET /v1/groups/{groupName}/billingCustomer #
GET /v1/groups/{groupName}/billingInvoices #
GET /v1/groups/{groupName}/billingInvoices/{billingInvoiceId}/lines #
GET /v1/groups/{groupName}/billingInvoices:getUpcoming #
GET /v1/groups/{groupName}/billingInvoices:listUpcomingLines #
GET /v1/groups/{groupName}/users List users belonging to a group #
POST /v1/groups:addUser Add user to a group #
POST /v1/groups:removeUser Remove user from a group. #
GET /v1/users/{userId}/balance Get User Balance #
GET /v1/users/{userId}/billingCustomer #
GET /v1/users/{userId}/billingInvoices #
GET /v1/users/{userId}/billingInvoices/{billingInvoiceId}/lines #
GET /v1/users/{userId}/billingInvoices:getUpcoming #
GET /v1/users/{userId}/billingInvoices:listUpcomingLines #
POST /v1/users/{userId}/eventBillingPrices:get #
GET /v1/users/{userId}/groups List QCS groups for the requested user #
POST /v1/users:activate Activate User #
GET /v1/viewer/announcements #
DELETE /v1/viewer/announcements/{announcementId} #
PUT /v1/viewer/userProfile #
GET /v1/viewer/onboardingCompleted #
PUT /v1/viewer/onboardingCompleted #

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/rigetti-account-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

rigetti-account-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  x-logo: https://qcs.rigetti.com/static/img/rigetti-logo.svg
  contact:
    email: support@rigetti.com
    url: https://rigetti.zendesk.com
  title: Rigetti QCS Account API
  version: 2020-07-31
  description: "# Introduction\n\nThis is the documentation for the Rigetti QCS HTTP API.\n\nYou can find out more about Rigetti at [https://rigetti.com](https://rigetti.com), and also\ninteract with QCS via the web at [https://qcs.rigetti.com](https://qcs.rigetti.com).\n\nThis API is documented in **OpenAPI format** and so is compatible with the dozens of\nlanguage-specific client generators available\n[here](https://github.com/OpenAPITools/openapi-generator) and elsewhere on the web.\n\n# Principles\n\nThis API follows REST design principles where appropriate, and otherwise an HTTP RPC paradigm.\nWe adhere to the Google [API Improvement Proposals](https://google.aip.dev/general) where\nreasonable to provide a consistent, intuitive developer experience. HTTP response codes match\ntheir specifications, and error messages fit a common format.\n\n# Authentication\n\nAll access to the QCS API requires OAuth2 authentication provided by Okta. You can request\naccess [here](https://www.rigetti.com/get-quantum). Once you have a user account, you can download\nyour access token from QCS [here](https://qcs.rigetti.com/auth/token). \n\nThat access token is valid for 24 hours after issuance. The value of `access_token` within the\nJSON file is the token used for authentication (don't use the entire JSON file).\n\nAuthenticate requests using the `Authorization` header and a `Bearer` prefix:\n\n```\ncurl --header \"Authorization: Bearer eyJraW...Iow\"\n```\n\n# Quantum Processor Access\n\nAccess to the quantum processors themselves is not yet provided directly by this HTTP API, but\nis instead performed over ZeroMQ/[rpcq](https://github.com/rigetti/rpcq). Until that changes,\nwe suggest using [pyquil](https://github.com/rigetti/pyquil) to build and execute quantum\nprograms via the Legacy API.\n\n# Legacy API\n\nOur legacy HTTP API remains accessible at https://forest-server.qcs.rigetti.com, and it shares\na source of truth with this API's services. You can use either service with the same user\naccount and means of authentication. We strongly recommend using the API documented here, as the\nlegacy API is on the path to deprecation.\n"
servers:
- description: Rigetti API
  url: https://api.qcs.rigetti.com
tags:
- name: account
  x-displayName: Account
paths:
  /v1/groups/{groupName}/balance:
    get:
      description: Retrieve the balance of the requested QCS group account.
      operationId: GetGroupBalance
      parameters:
      - description: URL encoded name of group for which to retrieve account balance.
        in: path
        name: groupName
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountBalance'
          description: Request completed successfully.
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Client not authorized to complete request.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: QCS group account does not exist.
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Request validation failed.
      security:
      - JWTBearer: []
      summary: Get Group Balance
      tags:
      - account
  /v1/groups/{groupName}/billingCustomer:
    get:
      description: Retrieve billing customer for a QCS group account.
      operationId: GetGroupBillingCustomer
      parameters:
      - description: URL-encoded name of group.
        in: path
        name: groupName
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BillingCustomer'
          description: Billing customer retrieved successfully.
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Client is not authorized to view account billing customer.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Group billing customer does not exist.
      security:
      - JWTBearer: []
      tags:
      - account
  /v1/groups/{groupName}/billingInvoices:
    get:
      description: Retrieve billing invoices for a QCS group account.
      operationId: ListGroupBillingInvoices
      parameters:
      - description: URL-encoded name of group.
        in: path
        name: groupName
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/pageTokenParam'
      - $ref: '#/components/parameters/pageSizeParam'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListAccountBillingInvoicesResponse'
          description: Billing invoices retrieved successfully.
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Client is not authorized to view group billing invoices.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Group billing customer does not exist.
      security:
      - JWTBearer: []
      tags:
      - account
  /v1/groups/{groupName}/billingInvoices/{billingInvoiceId}/lines:
    get:
      description: Retrieve billing invoice lines for a QCS group account's invoice.
      operationId: ListGroupBillingInvoiceLines
      parameters:
      - description: URL-encoded name of group.
        in: path
        name: groupName
        required: true
        schema:
          type: string
      - description: URL-encoded billing invoice id.
        in: path
        name: billingInvoiceId
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/pageTokenParam'
      - $ref: '#/components/parameters/pageSizeParam'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListAccountBillingInvoiceLinesResponse'
          description: Billing invoice lines retrieved successfully.
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Client is not authorized to view group billing invoice lines.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Group billing customer or invoice does not exist.
      security:
      - JWTBearer: []
      tags:
      - account
  /v1/groups/{groupName}/billingInvoices:getUpcoming:
    get:
      description: Retrieve upcoming invoice for QCS group billing customer.
      operationId: GetGroupUpcomingBillingInvoice
      parameters:
      - description: URL-encoded name of group.
        in: path
        name: groupName
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BillingUpcomingInvoice'
          description: Billing invoice retrieved successfully.
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Client is not authorized to view group billing invoice.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Group billing customer or invoice does not exist.
      security:
      - JWTBearer: []
      tags:
      - account
  /v1/groups/{groupName}/billingInvoices:listUpcomingLines:
    get:
      description: List invoice lines for QCS group billing customer upcoming invoice.
      operationId: ListGroupUpcomingBillingInvoiceLines
      parameters:
      - description: URL-encoded name of group.
        in: path
        name: groupName
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/pageTokenParam'
      - $ref: '#/components/parameters/pageSizeParam'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListAccountBillingInvoiceLinesResponse'
          description: Billing invoice lines retrieved successfully.
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Client is not authorized to view group billing invoice lines.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Group billing customer or invoice does not exist.
      security:
      - JWTBearer: []
      tags:
      - account
  /v1/groups/{groupName}/users:
    get:
      description: List users belonging to a group. Note, group membership may take several minutes to update within our identity provider. After adding or removing a user to or from a group, please allow up to 60 minutes for changes to be reflected.
      operationId: ListGroupUsers
      parameters:
      - description: URL encoded name of group for which to retrieve users.
        in: path
        name: groupName
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/pageSizeParam'
      - $ref: '#/components/parameters/pageTokenParam'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListGroupUsersResponse'
          description: Group users successfully retrieved.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: The requested group does not exist.
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Request validation failed.
      security:
      - JWTBearer: []
      summary: List users belonging to a group
      tags:
      - account
  /v1/groups:addUser:
    post:
      description: Add a user to a group. Note, group membership may take several minutes to update within our identity provider. After adding a user to a group, please allow up to 60 minutes for changes to be reflected.
      operationId: AddGroupUser
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AddGroupUserRequest'
        required: true
      responses:
        '204':
          description: User successfully added to group.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Group or user does not exist.
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Request validation failed.
      security:
      - JWTBearer: []
      summary: Add user to a group
      tags:
      - account
  /v1/groups:removeUser:
    post:
      description: Remove a user from a group. Note, group membership may take several minutes to update within our identity provider. After removing a user from a group, please allow up to 60 minutes for changes to be reflected.
      operationId: RemoveGroupUser
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RemoveGroupUserRequest'
        required: true
      responses:
        '204':
          description: User successfully removed from group.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Group does not exist.
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Request validation failed, possibly because the user does not belong to the group.
      security:
      - JWTBearer: []
      summary: Remove user from a group.
      tags:
      - account
  /v1/users/{userId}/balance:
    get:
      description: Retrieve the balance of the requested QCS user account.
      operationId: GetUserBalance
      parameters:
      - description: The user's QCS id. May be found as `idpId` in the `AuthGetUser` API call.
        in: path
        name: userId
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountBalance'
          description: Request completed successfully.
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Client not authorized to complete request.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: QCS user account does not exist.
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Request validation failed.
      security:
      - JWTBearer: []
      summary: Get User Balance
      tags:
      - account
  /v1/users/{userId}/billingCustomer:
    get:
      description: Retrieve billing customer for a QCS user account.
      operationId: GetUserBillingCustomer
      parameters:
      - description: The user's QCS id. May be found as `idpId` in the `AuthGetUser` API call.
        in: path
        name: userId
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BillingCustomer'
          description: Billing customer retrieved successfully.
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Client is not authorized to view user billing customer.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: User billing customer does not exist.
      security:
      - JWTBearer: []
      tags:
      - account
  /v1/users/{userId}/billingInvoices:
    get:
      description: Retrieve billing invoices for a QCS user account.
      operationId: ListUserBillingInvoices
      parameters:
      - description: The user's QCS id. May be found as `idpId` in the `AuthGetUser` API call.
        in: path
        name: userId
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/pageTokenParam'
      - $ref: '#/components/parameters/pageSizeParam'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListAccountBillingInvoicesResponse'
          description: Billing invoices retrieved successfully.
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Client is not authorized to view user billing invoices.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: User billing customer does not exist.
      security:
      - JWTBearer: []
      tags:
      - account
  /v1/users/{userId}/billingInvoices/{billingInvoiceId}/lines:
    get:
      description: Retrieve billing invoice lines for a QCS user account's invoice.
      operationId: ListUserBillingInvoiceLines
      parameters:
      - description: URL-encoded QCS id of user. May be found as `idpId` in the `AuthGetUser` API call.
        in: path
        name: userId
        required: true
        schema:
          type: string
      - description: URL-encoded billing invoice id.
        in: path
        name: billingInvoiceId
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/pageTokenParam'
      - $ref: '#/components/parameters/pageSizeParam'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListAccountBillingInvoiceLinesResponse'
          description: Billing invoice lines retrieved successfully.
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Client is not authorized to view user billing invoice lines.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: User billing customer or invoice does not exist.
      security:
      - JWTBearer: []
      tags:
      - account
  /v1/users/{userId}/billingInvoices:getUpcoming:
    get:
      description: Retrieve upcoming invoice for QCS user billing customer.
      operationId: GetUserUpcomingBillingInvoice
      parameters:
      - description: The user's QCS id. May be found as `idpId` in the `AuthGetUser` API call.
        in: path
        name: userId
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BillingUpcomingInvoice'
          description: Upcoming billing invoice retrieved successfully.
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Client is not authorized to view user billing invoice.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: User billing customer or invoice does not exist.
      security:
      - JWTBearer: []
      tags:
      - account
  /v1/users/{userId}/billingInvoices:listUpcomingLines:
    get:
      description: List invoice lines for QCS user billing customer upcoming invoice.
      operationId: ListUserUpcomingBillingInvoiceLines
      parameters:
      - description: The user's QCS id. May be found as `idpId` in the `AuthGetUser` API call.
        in: path
        name: userId
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/pageTokenParam'
      - $ref: '#/components/parameters/pageSizeParam'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListAccountBillingInvoiceLinesResponse'
          description: Billing invoice lines retrieved successfully.
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Client is not authorized to view user's billing invoice lines.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Group billing customer or invoice does not exist.
      security:
      - JWTBearer: []
      tags:
      - account
  /v1/users/{userId}/eventBillingPrices:get:
    post:
      description: Retrieve `EventBillingPrice` for a user for a specific event. If no price is configured this operation will return a default `EventBillingPrice` for the specified `product`.
      operationId: GetUserEventBillingPrice
      parameters:
      - description: The user's QCS id. May be found as `idpId` in the `AuthGetUser` API call.
        in: path
        name: userId
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetAccountEventBillingPriceRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EventBillingPriceRate'
          description: Retrieved `EventBillingPrice` successfully.
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Client is not authorized to retrieve the `EventBillingPrice`.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: The `EventBillingPrice` does not exist for the specified event. Because the server guarantees prices for events, the server will trigger alerts whenever returning this response.
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Request parameter validation error.
      security:
      - JWTBearer: []
      tags:
      - account
  /v1/users/{userId}/groups:
    get:
      description: List QCS groups for the requested user
      operationId: ListUserGroups
      parameters:
      - description: The user's QCS id. May be found as `idpId` in the `AuthGetUser` API call.
        in: path
        name: userId
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/pageSizeParam'
      - $ref: '#/components/parameters/pageTokenParam'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListGroupsResponse'
          description: Successfully retrieved groups.
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Request validation failed.
      security:
      - JWTBearer: []
      summary: List QCS groups for the requested user
      tags:
      - account
  /v1/users:activate:
    post:
      description: Activate a user, completing an invitation request.
      operationId: ActivateUser
      summary: Activate User
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ActivateUserRequest'
      responses:
        '204':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/User'
          description: Request completed successfully.
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Request validation failed.
      tags:
      - account
  /v1/viewer/announcements:
    get:
      description: List all announcements relevant to the authenticating user. By default, does not include dismissed announcements.
      operationId: ListViewerAnnouncements
      parameters:
      - $ref: '#/components/parameters/pageSizeParam'
      - $ref: '#/components/parameters/pageTokenParam'
      - name: includeDismissed
        description: Include dismissed announcements in the response.
        in: query
        schema:
          type: boolean
          default: false
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AnnouncementsResponse'
          description: Request completed successfully.
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Request authentication failed.
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Request validation failed.
      security:
      - JWTBearer: []
      tags:
      - account
  /v1/viewer/announcements/{announcementId}:
    delete:
      description: Dismiss an announcement for an authenticating user, indicating that they do not want to see it again.
      operationId: DismissViewerAnnouncement
      parameters:
      - name: announcementId
        description: The ID of an existing announcement.
        in: path
        required: true
        schema:
          type: integer
      responses:
        '200':
          description: Request completed successfully.
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Request authentication failed.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unknown announcement ID.
      security:
      - JWTBearer: []
      tags:
      - account
  /v1/viewer/userProfile:
    put:
      description: Update the profile of the authenticated user.
      operationId: UpdateViewerUserProfile
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateViewerUserProfileRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/User'
          description: Request completed successfully.
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Request authentication failed.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: The authenticated user could not be located within our records. Please contact support@rigetti.com if you reach this error.
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: The request could not be validated.
      security:
      - JWTBearer: []
      tags:
      - account
  /v1/viewer/onboardingCompleted:
    get:
      description: Get the onboarding status of the authenticated user.
      operationId: GetViewerUserOnboardingCompleted
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ViewerUserOnboardingCompleted'
          description: Request completed successfully.
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Request authentication failed.
      security:
      - JWTBearer: []
      tags:
      - account
    put:
      description: Update the onboarding status of the authenticated user.
      operationId: PutViewerUserOnboardingCompleted
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ViewerUserOnboardingCompleted'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ViewerUserOnboardingCompleted'
          description: Request completed successfully.
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Request authentication failed.
      security:
      - JWTBearer: []
      tags:
      - account
components:
  schemas:
    BillingPriceRecurrence:
      description: 'How to invoice for the usage of a product that has a recurring

        (subscription) price.

        '
      properties:
        aggregateUsage:
          description: 'How to determine the aggregate usage over the `interval` when

            `usageType=metered`.

            Using `sum` is recommended.

            '
          enum:
          - last_during_period
          - last_ever
          - max
          - sum
          type: string
        interval:
          description: 'The frequency at which recurring usage should be billed.

            Using `month` is recommended.

            '
          enum:
          - day
          - month
          - week
          - year
          type: string
        intervalCount:
          description: 'The number of `interval` units between each billing cycle.

            For example, `interval=month` and `intervalCount=1` means every month

            (recommended).

            '
          format: int64
          type: integer
        usageType:
          description: 'Use `metered` to calculate a dynamic quantity based on reported

            usage records (recommended).

            Use `licensed` when you provide a fixed quantity, e.g. a TV subscription.

            '
          enum:
          - licensed
          - metered
          type: string
      required:
      - interval
      title: Billing Price Recurrence
      type: object
    BillingInvoiceLine:
      description: A line item on an invoice representing a particular purchase (such as a reservation) or aggregate usage for the invoice period.
      properties:
        amount:
          type: integer
        description:
          type: string
        id:
          type: string
        invoiceItem:
          type: string
        lineItemType:
          enum:
          - invoiceitem
          - subscription
          type: string
        metadata:
          additionalProperties:
            type: string
          type: object
        price:
          $ref: '#/components/schemas/BillingPrice'
        quantity:
          type: integer
        subscription:
          type: string
        subscriptionItem:
          type: string
      required:
      - id
      - description
      - amount
      - quantity
      - lineItemType
      - metadata
      type: object
    Announcement:
      description: An announcement to be displayed to users.
      properties:
        id:
          type: integer
        contentHtml:
          description: The HTML content of the announcement to be displayed.
          type: string
        createdAt:
          type: string
          format: date-time
          description: The RFC3339-format time the announcement was created.
        active:
          type: boolean
          description: Whether the announcement is currently active.
      required:
      - id
      - contentHtml
      - createdAt
      - active
    BillingPrice:
      description: 'A configuration for calculating the cost of `BillingProduct` usage

        based on quantity,

        and when that cost should be added as an invoice item.

        '
      properties:
        active:
          description: Whether the price can be used for new purchases.
          type: boolean
        billingScheme:
          $ref: '#/components/schemas/BillingPriceScheme'
        id:
          description: Unique identifier for the object.
          maxLength: 5000
          type: string
        object:
          description: This object's type, which is always `price`.
          enum:
          - price
          type: string
        priceType:
          description: 'Use `one_time` to invoice immediately based on a single usage

            report, e.g. purchasing a QPU reservation.

            Use `recurring` to ag

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