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

# Pesquisar registros

> Pesquisa linhas na base de dados usando filtros exatos



## OpenAPI

````yaml POST /projects/{project}/tables/{table}/records/search
openapi: 3.1.0
info:
  title: Base39 API
  description: >-
    API da Base39 para inserir e consultar dados na base de forma simples e
    direta
  version: 1.0.0
  contact:
    name: Base39
    url: https://base39.com.br
    email: contato@base39.com.br
servers:
  - url: https://api.base39.com.br/v2
security:
  - OAuth2:
      - read
      - write
tags:
  - name: Records
    description: Operações relacionadas a registros de dados
  - name: Webhooks
    description: Endpoints para recebimento de dados via webhook
  - name: Reports
    description: Operações relacionadas a relatórios
  - name: Files
    description: Operações relacionadas a arquivos
paths:
  /projects/{project}/tables/{table}/records/search:
    post:
      tags:
        - Records
      description: Pesquisa linhas na base de dados usando filtros exatos
      operationId: searchRecords
      parameters:
        - name: project
          in: path
          required: true
          schema:
            type: string
          description: Identificador do projeto
        - name: table
          in: path
          required: true
          schema:
            type: string
          description: Identificador da tabela
      requestBody:
        description: >-
          Filtros de pesquisa. As chaves são dinâmicas e podem ser qualquer
          campo da base.
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                type: string
                description: Valor do campo para filtro
              example:
                f_zmHL6ZWVkZogjCBMYwVMT: São Paulo
                CNPJ: '57778216000108'
        required: true
      responses:
        '200':
          description: Resultados da pesquisa
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    report:
                      type: object
                      properties:
                        sections:
                          type: array
                          items:
                            type: object
                            properties:
                              status:
                                type: string
                                enum:
                                  - done
                                  - processing
                                  - error
                              title:
                                type: string
                              value:
                                type: string
                    fields:
                      type: object
                      additionalProperties:
                        type: string
                        description: Valor do campo
              example:
                - report:
                    sections:
                      - status: done
                        title: Resumo
                        value: ...
                      - status: processing
                        title: Histórico
                        value: ...
                  fields:
                    email: joao@email.com
                    nome: João Silva
                    f_zmHL6ZWVkZogjCBMYwVMT: São Paulo
components:
  securitySchemes:
    OAuth2:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://auth.base39.com.br/oauth2/authorize
          tokenUrl: https://auth.base39.com.br/oauth2/token
          scopes:
            read: Permissão para ler dados
            write: Permissão para escrever dados

````