> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Buscar transacciones > Utilice este endpoint para buscar transacciones dentro de un contexto de conciliación. Admite búsqueda de texto libre, filtros de rango de monto, filtros de fecha y filtros de estado con paginación por desplazamiento. ## OpenAPI ````yaml es/openapi/v3-current/matcher.yaml get /v1/imports/contexts/{contextId}/transactions/search openapi: 3.1.0 info: title: Matcher APIs description: >- Referencia completa de la API para el motor de conciliación Matcher, que proporciona conciliación automatizada de transacciones entre Midaz Ledger y sistemas externos. version: 4.1.0 license: name: Lerian Studio General License servers: - url: https://matcher.sandbox.lerian.net security: [] paths: /v1/imports/contexts/{contextId}/transactions/search: get: tags: - Ingestion summary: Buscar transacciones description: >- Utilice este endpoint para buscar transacciones dentro de un contexto de conciliación. Admite búsqueda de texto libre, filtros de rango de monto, filtros de fecha y filtros de estado con paginación por desplazamiento. operationId: searchTransactions parameters: - description: A unique identifier for tracing the request across services. in: header name: X-Request-Id schema: type: string - description: The unique identifier of the reconciliation context. in: path name: contextId required: true schema: type: string - description: Free-text search query in: query name: q schema: type: string - description: Minimum transaction amount in: query name: amount_min schema: type: string - description: Maximum transaction amount in: query name: amount_max schema: type: string - description: Start date filter (RFC 3339 format) in: query name: date_from schema: type: string format: date-time - description: End date filter (RFC 3339 format) in: query name: date_to schema: type: string format: date-time - description: Transaction reference (exact match) in: query name: reference schema: type: string - description: Currency code filter in: query name: currency schema: type: string - description: Source ID filter in: query name: source_id schema: type: string - description: Transaction status filter in: query name: status schema: type: string enum: - UNMATCHED - MATCHED - IGNORED - PENDING_REVIEW - description: The maximum number of items to include in the response. in: query name: limit schema: type: integer minimum: 1 maximum: 50 default: 20 - description: The number of items to skip before returning results. in: query name: offset schema: type: integer minimum: 0 default: 0 responses: '200': description: Resultados de búsqueda con paginación por desplazamiento content: application/json: schema: $ref: '#/components/schemas/SearchTransactionsResponse' '400': description: La solicitud contiene parámetros o cuerpo no válidos. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: La solicitud no tiene credenciales de autenticación válidas. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: No tiene permiso para acceder a este recurso. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '500': description: Ocurrió un error inesperado en el servidor. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: ErrorM0002: $ref: '#/components/examples/ErrorM0002' security: - BearerAuth: [] components: schemas: SearchTransactionsResponse: description: >- Resultados de búsqueda de transacciones con paginación por desplazamiento type: object properties: items: type: array items: $ref: '#/components/schemas/TransactionResponse' total: type: integer format: int64 description: Número total de transacciones coincidentes limit: type: integer description: Número máximo de elementos por página example: 20 offset: type: integer description: Número de elementos omitidos example: 0 ErrorResponse: description: Respuesta de error estándar devuelta por todos los endpoints de la API type: object required: - code - title - message properties: code: type: string description: Código de error de aplicación estable. example: MTCH-0001 title: type: string description: Título de error legible por humanos. example: Bad Request message: type: string description: Mensaje de error legible con detalles. example: context not found error: type: string description: >- Obsoleto. Mensaje de error para compatibilidad con versiones anteriores. deprecated: true details: description: Contexto de error adicional como pares clave-valor additionalProperties: {} type: object TransactionResponse: description: Detalles de la transacción properties: amount: description: Monto de la transacción como cadena de texto example: '1000.50' type: string contextId: description: ID de contexto al que pertenece esta transacción example: 019c96a0-10a0-72d2-9fb0-2b7de8093182 type: string createdAt: description: Marca de tiempo de creación en formato RFC3339 example: '2025-01-15T10:30:00.000Z' type: string currency: description: Código de moneda example: BRL type: string date: description: Fecha de la transacción en formato RFC3339 example: '2025-01-15T00:00:00.000Z' type: string description: description: Descripción de la transacción example: Wire transfer from ABC Corp type: string externalId: description: Identificador externo del sistema de origen example: TXN-12345 type: string extractionStatus: description: Estado de extracción enum: - PENDING - EXTRACTED - FAILED example: EXTRACTED type: string id: description: Identificador único de la transacción example: 019c96a0-10ce-75fc-a273-dc799079a99c type: string jobId: description: ID del trabajo que ingirió esta transacción example: 019c96a0-10ce-75fc-a273-dc799079a99c type: string sourceId: description: ID de fuente a la que pertenece esta transacción example: 019c96a0-108c-7a74-8e31-3789daffe1ed type: string status: description: Estado de conciliación actual enum: - PENDING - MATCHED - UNMATCHED example: PENDING type: string type: object examples: ErrorM0002: summary: Internal Server Error value: code: MTCH-0002 title: Internal Server Error message: internal server error securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT description: 'Autenticación con token Bearer (formato: "Bearer {token}")' ````