Buscar Lançamentos de Investimentos

Mesma consulta de Listar Lançamentos de Investimentos, com os parâmetros no corpo da requisição. Use quando a lista de investmentIds for grande demais para a URL.

Endpoint

Método e URL:

POST /api/v1/companies/:companyId/accounting/investments/entries/search

Parâmetros da URL:

• companyId (uuid, obrigatório): Identificador da empresa

Corpo (JSON):

• investmentIds (uuid[], obrigatório): Investimentos a consultar, ao menos um — todos devem pertencer à empresa, caso contrário 404
• from, to (string, opcionais): Período sobre placedAt, ambos inclusivos — mesmo formato da query (Período)
• filters (array, opcional): Condições sobre os campos filtráveis — aqui como array JSON comum, sem encoding
• joinOperator (opcional): and (padrão) ou or
• sort (array, opcional): { id, desc }[]
• search (string, opcional): Busca nos campos de texto do lançamento
• page (number, opcional): Página, a partir de 1 (padrão: 1)
• perPage (number, opcional): Itens por página, de 1 a 500 (padrão: 30)

Apesar do POST, o endpoint é somente leitura.

Exemplo

curl -X POST "https://api-business.openi.com.br/api/v1/companies/{companyId}/accounting/investments/entries/search" \
  -H "Authorization: Bearer oak_368ba506f7b2_9f2c..." \
  -H "Content-Type: application/json" \
  -d '{
    "investmentIds": ["9e8d7c6b-5a4f-4e3d-2c1b-0a9f8e7d6c5b", "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d"],
    "from": "2026-01-01",
    "filters": [{ "id": "type", "operator": "inArray", "value": ["IR", "IOF"] }],
    "sort": [{ "id": "placedAt", "desc": true }],
    "perPage": 100
  }'

Resposta

Idêntica a Listar Lançamentos de Investimentos.