---
title: "POST /v4/integrar/executa-query"
method: POST
path: "/v4/integrar/executa-query"
tags: ["Executar Query"]
---

# POST /v4/integrar/executa-query

`POST /v4/integrar/executa-query`

## Request

- Base URL: `https://integracao.cvcrm.com.br/api`
- URL: `https://integracao.cvcrm.com.br/api/v4/integrar/executa-query`
- Auth: HTTP bearer

> 🔒 **Autenticação necessária**
>
> Esta API utiliza **Bearer Token** no header Authorization.
> Consulte o tutorial completo antes de fazer sua primeira chamada:
> [Como autenticar nas APIs do CV CRM (v3+ — Bearer Token)](https://desenvolvedor.cvcrm.com.br/docs/como-autenticar-nas-apis-do-cv-crm-com-bearer-token)

Executa uma consulta SELECT a partir de uma AST (Abstract Syntax Tree) em JSON. O backend valida que a AST representa apenas SELECT e a converte em SQL com prepared statements, bloqueando qualquer operação DML (INSERT, UPDATE, DELETE, DROP, etc.). Quando 'limit' não é informado, aplica-se o limite padrão de 50 registros (teto máximo de 500). A especificação completa dos nós está em app/src/Vender/Query/Application/Services/AST_GUIDE.md. Requer autenticação JWT (painel gestor).

## Request body

- object
  - `ast` object, required: AST da consulta SELECT. Deve conter 'type' (select), 'columns' e 'from'.
    - `type` 'select', required
    - `columns` object[], required: Colunas. Cada item tem 'expression' e opcionalmente 'alias'.
    - `from` object, required: Tabela única ({type: table, table, alias}) ou árvore de JOINs.
    - `where` object: Expressão de filtro (binary_expression, in, between, etc.).
    - `groupby` object[]
    - `having` object
    - `orderby` object[]
    - `limit` unknown
  - `params` object: Parâmetros nomeados adicionais mesclados aos placeholders gerados pela AST.

## Response `200`

Retorna os dados da query

- object
  - `status` string
  - `code` integer
  - `data` object[]

## Other responses

- `400`: AST inválida, operação não-SELECT ou parâmetro inválido.
- `401`: Token inválido ou não informado.
- `500`: Erro interno!

---

[API](https://skmtc.dev/cvcrm/apis/servi-os-internos-do-construtor-de-vendas.md) - [All operations](https://skmtc.dev/cvcrm/apis/servi-os-internos-do-construtor-de-vendas/llms.txt) - [OpenAPI document](https://skmtc.dev/cvcrm/apis/servi-os-internos-do-construtor-de-vendas/revisions/9f2fd517acbb?raw)