> ## 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. # Pesquisar transações > Use este endpoint para pesquisar transações dentro de um contexto de conciliação. Suporta pesquisa de texto livre, filtros de intervalo de valor, filtros de data e filtros de status com paginação baseada em offset. ## OpenAPI ````yaml pt/openapi/v3-current/matcher.yaml get /v1/imports/contexts/{contextId}/transactions/search openapi: 3.1.0 info: title: Matcher APIs description: >- Referência completa de API para o motor de conciliação Matcher, que fornece conciliação automática de transações entre o Midaz Ledger e 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: Pesquisar transações description: >- Use este endpoint para pesquisar transações dentro de um contexto de conciliação. Suporta pesquisa de texto livre, filtros de intervalo de valor, filtros de data e filtros de status com paginação baseada em offset. 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 da pesquisa com paginação por offset content: application/json: schema: $ref: '#/components/schemas/SearchTransactionsResponse' '400': description: A requisição contém parâmetros ou payload inválidos. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: A requisição não contém credenciais de autenticação válidas. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: Você não tem permissão para acessar este recurso. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '500': description: Ocorreu um erro inesperado no servidor. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: ErrorM0002: $ref: '#/components/examples/ErrorM0002' security: - BearerAuth: [] components: schemas: SearchTransactionsResponse: description: Resultados de busca de transações com paginação por offset type: object properties: items: type: array items: $ref: '#/components/schemas/TransactionResponse' total: type: integer format: int64 description: Total de transações correspondentes limit: type: integer description: Máximo de itens por página example: 20 offset: type: integer description: Número de itens ignorados example: 0 ErrorResponse: description: Resposta de erro padrão retornada por todos os endpoints da API type: object required: - code - title - message properties: code: type: string description: Código de erro de aplicação estável. example: MTCH-0001 title: type: string description: Título de erro legível por humanos. example: Bad Request message: type: string description: Mensagem de erro legível com detalhes. example: context not found error: type: string description: Descontinuado. Mensagem de erro para compatibilidade retroativa. deprecated: true details: description: Contexto adicional do erro como pares chave-valor additionalProperties: {} type: object TransactionResponse: description: Detalhes da transação properties: amount: description: Valor da transação como string example: '1000.50' type: string contextId: description: ID do contexto ao qual esta transação pertence example: 019c96a0-10a0-72d2-9fb0-2b7de8093182 type: string createdAt: description: Timestamp de criação no formato RFC3339 example: '2025-01-15T10:30:00.000Z' type: string currency: description: Código da moeda example: BRL type: string date: description: Data da transação no formato RFC3339 example: '2025-01-15T00:00:00.000Z' type: string description: description: Descrição da transação example: Wire transfer from ABC Corp type: string externalId: description: Identificador externo do sistema de origem example: TXN-12345 type: string extractionStatus: description: Status de extração enum: - PENDING - EXTRACTED - FAILED example: EXTRACTED type: string id: description: Identificador único da transação example: 019c96a0-10ce-75fc-a273-dc799079a99c type: string jobId: description: ID da tarefa de importação que ingeriu esta transação example: 019c96a0-10ce-75fc-a273-dc799079a99c type: string sourceId: description: ID da fonte à qual esta transação pertence example: 019c96a0-108c-7a74-8e31-3789daffe1ed type: string status: description: Status de conciliação atual 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: 'Autenticação por Bearer token (formato: "Bearer {token}")' ````