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

# List your invoices

> The signed-in trader's invoices for Hyperprop add-ons, newest first (up to 50). `status` is `paid`, `open` (awaiting payment — pay it at `hostedUrl`), `void` or `uncollectible`. `pdfUrl` downloads the invoice. Amounts are in the smallest currency unit (cents); `amountCents` includes `taxCents`.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/user/billing/invoices
openapi: 3.0.0
info:
  title: Hyperprop Platform API
  version: 1.0.0
  description: >-
    REST API for the Hyperprop Trading Platform — provision evaluation and
    funded trading accounts, manage traders and plans, react to account
    lifecycle events via signed webhooks, and reconcile billing. Built for prop
    firms integrating from their own backend.


    Authentication, quick start, error handling, idempotency, pagination, custom
    metadata, webhooks, and the MCP connector are documented at
    https://docs.hyperprop.com.
  x-logo:
    url: https://app.hyperprop.com/logo-icon.svg
    altText: Hyperprop
    href: https://hyperprop.com
servers:
  - url: https://api.hyperprop.com/platform
    description: Production
security: []
tags:
  - name: Authentication
    description: >-
      User authentication - signup, signin, signout, password reset, email
      verification, OAuth, and MFA
  - name: User
    description: >-
      User account management - profile, notifications, agreements, dismissals,
      and audit logs. Requires Bearer token.
  - name: Organization
    description: >-
      Organization management - profile, team, trading accounts, plans, and
      rules. Supports **dual authentication**: Bearer JWT token (dashboard
      users) OR X-API-Key (programmatic access).
  - name: Market Data
    description: CME futures contracts and market data. Requires Bearer token.
  - name: Indicator Builder
    description: >-
      AI-assisted authoring of custom Hyperprop Script indicators for the web
      terminal. Requires Bearer token.
  - name: System
    description: System endpoints - health checks and connectivity
paths:
  /v1/user/billing/invoices:
    get:
      tags:
        - User
      summary: List your invoices
      description: >-
        The signed-in trader's invoices for Hyperprop add-ons, newest first (up
        to 50). `status` is `paid`, `open` (awaiting payment — pay it at
        `hostedUrl`), `void` or `uncollectible`. `pdfUrl` downloads the invoice.
        Amounts are in the smallest currency unit (cents); `amountCents`
        includes `taxCents`.
      operationId: getV1UserBillingInvoices
      responses:
        '200':
          description: Invoices returned
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/Model374'
        '401':
          description: Authentication required
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/Model9'
        '500':
          description: An unexpected error occurred
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/Model5'
components:
  schemas:
    Model374:
      type: object
      properties:
        success:
          type: boolean
          example: true
        data:
          $ref: '#/components/schemas/Model373'
    Model9:
      type: object
      properties:
        success:
          type: boolean
          description: Always false on errors
          example: false
        statusCode:
          type: number
          example: 401
        error:
          type: string
          example: Unauthorized
        message:
          type: string
          example: Authentication required
        code:
          type: string
          description: Machine-readable error code — switch on this, not on message text
          example: UNAUTHORIZED
    Model5:
      type: object
      properties:
        success:
          type: boolean
          description: Always false on errors
          example: false
        statusCode:
          type: number
          example: 500
        error:
          type: string
          example: Internal Server Error
        message:
          type: string
          example: An unexpected error occurred
        code:
          type: string
          description: Machine-readable error code — switch on this, not on message text
          example: INTERNAL_ERROR
    Model373:
      type: object
      properties:
        invoices:
          $ref: '#/components/schemas/invoices'
    invoices:
      type: array
      items:
        $ref: '#/components/schemas/Model372'
    Model372:
      type: object
      properties:
        id:
          type: string
          example: in_1QxYz2AbCdEf
        number:
          type: string
          example: HP-0001-0003
        createdAt:
          type: string
          example: '2026-10-29T17:00:05.000Z'
          x-format:
            isoDate: true
        description:
          type: string
          example: CME Market Depth — November 2026
        amountCents:
          type: integer
          example: 5445
        taxCents:
          type: integer
          example: 945
        currency:
          type: string
          example: usd
        status:
          $ref: '#/components/schemas/Model371'
        paidAt:
          type: string
          example: '2026-10-29T17:00:07.000Z'
          x-format:
            isoDate: true
        pdfUrl:
          type: string
          example: https://billing.example.com/invoice/a1b2c3/pdf
          x-format:
            uri: true
        hostedUrl:
          type: string
          example: https://billing.example.com/invoice/a1b2c3
          x-format:
            uri: true
    Model371:
      type: string
      example: paid
      enum:
        - paid
        - open
        - void
        - uncollectible

````

## Related topics

- [List your notifications](/platform-api/user/list-your-notifications.md)
- [List your support tickets](/platform-api/organization/list-your-support-tickets.md)
- [List your price alerts](/platform-api/user/list-your-price-alerts.md)
- [List your journal notes](/platform-api/user/list-your-journal-notes.md)
- [List roles (system presets + your custom roles)](/platform-api/organization/list-roles-system-presets-+-your-custom-roles.md)