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

# Descripciones ya usadas para autocompletar, con la categoría que una regla aplicaría (10-reglas §3)



## OpenAPI

````yaml /openapi/v1.json get /v1/transactions/description-suggestions
openapi: 3.0.0
info:
  title: Finzaria API
  description: >-
    API REST de Finzaria — finanzas personales para México, dev-first y
    agent-first. Autentícate con tu API key bxm_ (o un token OAuth).
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.finzaria.com/v1
    description: Producción
security: []
tags: []
paths:
  /v1/transactions/description-suggestions:
    get:
      tags:
        - transactions
      summary: >-
        Descripciones ya usadas para autocompletar, con la categoría que una
        regla aplicaría (10-reglas §3)
      operationId: TransactionsController_descriptionSuggestions
      parameters:
        - name: q
          required: true
          in: query
          description: Texto a autocompletar (≥ 2 caracteres).
          schema:
            type: string
        - name: limit
          required: false
          in: query
          schema:
            maximum: 20
            default: 8
            type: number
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/DescriptionSuggestionDto'
      security:
        - bearer: []
components:
  schemas:
    DescriptionSuggestionDto:
      type: object
      properties:
        description:
          type: string
        count:
          type: number
          description: Veces usada en el workspace.
        ruleCategory:
          type: string
          nullable: true
          description: >-
            Ruta de la categoría que la regla ganadora aplicaría a esta
            descripción (null si ninguna).
      required:
        - description
        - count
        - ruleCategory
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: JWT (Supabase Auth)
      type: http

````