> ## Documentation Index
> Fetch the complete documentation index at: https://docs.semicola.com/llms.txt
> Use this file to discover all available pages before exploring further.

# The app-root Rate Card review decision (null when none is due)



## OpenAPI

````yaml /openapi/v3.yaml get /api/v2/billing/iu-rate-card/login-prompt
openapi: 3.1.0
info:
  title: Semicola Exchange platform API
  version: 3.0.0-preview
  description: >-
    Platform endpoints of Semicola: sign-in, signup and OAuth for MCP clients,
    accounts, members and keys, billing, notifications, the Semi assistant (chat
    stream, confirmations, conversations), the MCP App widget host and realtime
    feeds. Typed agent tools live on the MCP server at /mcp/v3.
servers:
  - url: https://api.semicola.com
security:
  - bearerAuth: []
  - sessionCookie: []
tags:
  - name: Auth
  - name: Signup
  - name: OAuth
  - name: Accounts
  - name: Members
  - name: API Keys
  - name: Buyer Agent Principals
  - name: Asks
  - name: Connected Apps
  - name: Onboarding
  - name: Billing
  - name: AI Usage
  - name: Notifications
  - name: Assistant
  - name: MCP Apps
  - name: Realtime
  - name: Demo
paths:
  /api/v2/billing/iu-rate-card/login-prompt:
    get:
      tags:
        - Billing
      summary: The app-root Rate Card review decision (null when none is due)
      operationId: getBillingIuRateCardLoginPrompt
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    anyOf:
                      - anyOf:
                          - oneOf:
                              - type: object
                                properties:
                                  billingCustomerId:
                                    type: integer
                                    exclusiveMinimum: 0
                                    maximum: 9007199254740991
                                  promptKey:
                                    type: string
                                    pattern: ^v1:[0-9a-f]{64}$
                                  action:
                                    type: string
                                    const: ASK_ADMIN
                                required:
                                  - billingCustomerId
                                  - promptKey
                                  - action
                                additionalProperties: false
                              - type: object
                                properties:
                                  billingCustomerId:
                                    type: integer
                                    exclusiveMinimum: 0
                                    maximum: 9007199254740991
                                  promptKey:
                                    type: string
                                    pattern: ^v1:[0-9a-f]{64}$
                                  action:
                                    type: string
                                    const: REVIEW_PLAN
                                  offerVersion:
                                    type: string
                                    pattern: ^v1:[0-9a-f]{64}$
                                  rateCardPublicVersion:
                                    type: string
                                    minLength: 1
                                required:
                                  - billingCustomerId
                                  - promptKey
                                  - action
                                  - offerVersion
                                  - rateCardPublicVersion
                                additionalProperties: false
                          - type: 'null'
                      - type: 'null'
                  error:
                    anyOf:
                      - type: object
                        properties:
                          code:
                            type: string
                          message:
                            type: string
                          field:
                            type: string
                          details: {}
                        required:
                          - code
                          - message
                        additionalProperties: false
                      - type: 'null'
                required:
                  - data
                  - error
                additionalProperties: false
        default:
          description: >-
            Error envelope `{data: null, error: {code, message, field?,
            details?}}`.
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key or OAuth access token.
    sessionCookie:
      type: apiKey
      in: cookie
      name: sc_session

````