Cadastrar imóveis CAR em uma consulta

POST

/v2/queries/clients/{clientId}/{queryId}/cars/create

Cadastra na consulta os imóveis CAR informados, buscando os dados de cada um na fonte e calculando os cruzamentos do agcheck. Aceita uma lista em cars, no formato devolvido pelas buscas por arquivo ou por coordenadas, ou um único código em code. Imóveis que já estavam cadastrados e inativos são reativados. A rota não interrompe por causa de um imóvel: cada falha individual volta em message e os demais seguem. Requer autenticação via Bearer JWT ou header x-api-key.

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros de Caminho

Parâmetros Header

Parâmetros Bodyapplication/json

Examples

Respostas

🟢200

application/json

Inferred 200 (from source code)

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠404NotFound

🟠429TooManyRequests

🔴500InternalError

Request Example

Shell

JavaScript

Java

Swift

curl --location '/v2/queries/clients///cars/create' \
--header 'x-api-key: SUA_CHAVE_DE_API' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "ownership": "propria",
    "cars": [
        {
            "car": "string",
            "name": "string",
            "totalArea": 0,
            "intersectionPercent": 0,
            "areaInformed": {
                "area": 0,
                "tipo": "AREA_IMOVEL",
                "geoJson": {
                    "type": "MultiPolygon",
                    "coordinates": []
                }
            }
        }
    ]
}'

Response Example

200 - Sucesso

{
    "createdCars": [
        {
            "_id": "string",
            "name": "string",
            "totalArea": 0,
            "state": "MT",
            "city": "string",
            "productiveArea": 0,
            "geo": [],
            "ownership": "propria"
        }
    ],
    "message": [
        "string"
    ]
}

Modificado em 2026-10-13 09:47:06

Página anterior

Visualizar imóvel CAR

Próxima página

Atualizar imóvel CAR