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

# List fixed bills

> Returns the active fixed bills (contas fixas) of a space: rent, utilities, boletos, insurance, and other recurring expenses that are not subscriptions. Installment plans are not included. Ordered by `next_due_date`. Requires the `pfm:read` scope.



## OpenAPI

````yaml /openapi.json get /v1/spaces/{space_id}/fixed-bills
openapi: 3.0.3
info:
  description: >-
    Personal REST API for Visor Pro and Premium users. Authenticate with a
    personal API token created in Visor Settings, sent as `Authorization: Bearer
    visor_pat_...`, or with an OAuth access token from the Visor CLI browser
    login.
  title: Visor Personal API
  version: 1.0.0
servers:
  - url: https://api.visorfinance.app
    variables: {}
security:
  - personal_api_token: []
  - visor_cli_oauth:
      - pfm:read
tags: []
paths:
  /v1/spaces/{space_id}/fixed-bills:
    get:
      tags:
        - Recurring expenses
        - Fixed bills
      summary: List fixed bills
      description: >-
        Returns the active fixed bills (contas fixas) of a space: rent,
        utilities, boletos, insurance, and other recurring expenses that are not
        subscriptions. Installment plans are not included. Ordered by
        `next_due_date`. Requires the `pfm:read` scope.
      operationId: VisorWeb.Api.V1.RecurringExpenseController.fixed_bills
      parameters:
        - description: A space `id` from `GET /v1/spaces`
          in: path
          name: space_id
          required: true
          schema:
            format: uuid
            type: string
      responses:
        '200':
          content:
            application/json:
              example:
                data:
                  - account_id: 0b7f6d2e-8c1a-4f3b-9d5e-6a2c4b8e1f90
                    active: true
                    amount: '2500.00'
                    category_id: null
                    currency_code: BRL
                    frequency: monthly
                    id: 7c1e4f2a-3b5d-4a6c-8e9f-0a1b2c3d4e5f
                    last_paid_date: '2026-10-05'
                    name: Aluguel
                    next_due_date: '2026-11-05'
                    service_name: null
              schema:
                $ref: '#/components/schemas/FixedBillListResponse'
          description: Fixed bills of the space
          headers:
            x-ratelimit-limit:
              description: Requests allowed for this token per minute
              schema:
                example: 60
                type: integer
              style: simple
            x-ratelimit-remaining:
              description: Requests left for this token in the current minute
              schema:
                example: 59
                type: integer
              style: simple
            x-request-id:
              description: Request identifier, also returned as `request_id` in errors
              schema:
                type: string
              style: simple
        '401':
          content:
            application/json:
              example:
                errors:
                  - code: INVALID_TOKEN
                    details: {}
                    message: The personal API token is not valid.
                    request_id: F8x2kQ9vXc1AAAAB
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Missing, invalid, expired, or revoked token
          headers:
            x-request-id:
              description: Request identifier, also returned as `request_id` in errors
              schema:
                type: string
              style: simple
        '403':
          content:
            application/json:
              example:
                errors:
                  - code: INSUFFICIENT_SCOPE
                    details:
                      required_scope: pfm:read
                    message: The personal API token does not grant this operation.
                    request_id: F8x2kQ9vXc1AAAAB
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Pro or Premium plan required, or insufficient scope
          headers:
            x-request-id:
              description: Request identifier, also returned as `request_id` in errors
              schema:
                type: string
              style: simple
        '404':
          content:
            application/json:
              example:
                errors:
                  - code: NOT_FOUND
                    details: {}
                    message: The resource does not exist.
                    request_id: F8x2kQ9vXc1AAAAB
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: The space does not exist or the token's user cannot access it
          headers:
            x-request-id:
              description: Request identifier, also returned as `request_id` in errors
              schema:
                type: string
              style: simple
        '406':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: The client does not accept JSON
          headers:
            x-request-id:
              description: Request identifier, also returned as `request_id` in errors
              schema:
                type: string
              style: simple
        '429':
          content:
            application/json:
              example:
                errors:
                  - code: RATE_LIMITED
                    details:
                      retry_after_seconds: 42
                    message: >-
                      Too many requests. Retry after the number of seconds in
                      Retry-After.
                    request_id: F8x2kQ9vXc1AAAAB
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Rate limit exceeded
          headers:
            retry-after:
              description: Seconds until the current window ends
              schema:
                example: 42
                type: integer
              style: simple
            x-ratelimit-limit:
              description: Requests allowed for this token per minute
              schema:
                example: 60
                type: integer
              style: simple
            x-ratelimit-remaining:
              description: Requests left for this token in the current minute
              schema:
                example: 59
                type: integer
              style: simple
            x-request-id:
              description: Request identifier, also returned as `request_id` in errors
              schema:
                type: string
              style: simple
      callbacks: {}
components:
  schemas:
    FixedBillListResponse:
      additionalProperties: false
      properties:
        data:
          items:
            $ref: '#/components/schemas/RecurringExpense'
          type: array
      required:
        - data
      title: FixedBillListResponse
      type: object
    ErrorResponse:
      additionalProperties: false
      properties:
        errors:
          items:
            $ref: '#/components/schemas/Error'
          minItems: 1
          type: array
      required:
        - errors
      title: ErrorResponse
      type: object
    RecurringExpense:
      additionalProperties: false
      properties:
        account_id:
          description: Account `id` that pays the expense; null when not tied to an account
          format: uuid
          nullable: true
          type: string
        active:
          type: boolean
        amount:
          description: Expected amount of one charge as a positive decimal string.
          example: '39.90'
          format: decimal
          type: string
        category_id:
          description: Category `id` from the categories endpoint
          format: uuid
          nullable: true
          type: string
        currency_code:
          description: ISO 4217 code
          example: BRL
          type: string
        frequency:
          description: >-
            How often the expense charges; null when Visor could not determine
            it
          enum:
            - daily
            - weekly
            - biweekly
            - monthly
            - bimonthly
            - quarterly
            - semiannual
            - annual
          nullable: true
          type: string
        id:
          format: uuid
          type: string
        last_paid_date:
          description: Date of the last matched charge; null when none was matched
          format: date
          nullable: true
          type: string
        name:
          description: The name the user set, or the name Visor detected
          type: string
        next_due_date:
          description: Date of the next expected charge; null when unknown
          format: date
          nullable: true
          type: string
        service_name:
          description: >-
            Name of the known service (for example Netflix) Visor matched; null
            otherwise
          nullable: true
          type: string
      required:
        - id
        - name
        - amount
        - currency_code
        - frequency
        - next_due_date
        - last_paid_date
        - active
        - category_id
        - account_id
        - service_name
      title: RecurringExpense
      type: object
    Error:
      additionalProperties: false
      properties:
        code:
          description: Stable machine-readable code
          example: INVALID_TOKEN
          type: string
        details:
          additionalProperties: true
          description: Code-specific context
          type: object
        message:
          description: English text for developers
          type: string
        request_id:
          description: The x-request-id response header of the request
          nullable: true
          type: string
      required:
        - code
        - message
        - details
        - request_id
      title: Error
      type: object
  securitySchemes:
    personal_api_token:
      bearerFormat: visor_pat_<public_id>_<secret>
      description: Personal API token created in Visor Settings
      scheme: bearer
      type: http
    visor_cli_oauth:
      description: >-
        OAuth 2.0 access token of the Visor CLI browser login (authorization
        code with PKCE). Only the first-party Visor CLI client can use it on
        this API.
      flows:
        authorizationCode:
          authorizationUrl: https://dashboard.visorfinance.app/oauth/authorize
          refreshUrl: https://dashboard.visorfinance.app/oauth/token
          scopes:
            pfm:read: Read financial data
            pfm:transactions:write: Create, edit, and delete transactions
            pix:payments:write: Start Pix payments that you confirm with biometrics at your bank
          tokenUrl: https://dashboard.visorfinance.app/oauth/token
      type: oauth2

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.