# ImobyFlow API

> API REST de integração da ImobyFlow, plataforma do mercado imobiliário brasileiro: carteira de imóveis, clientes, as recomendações do Radar, parcerias entre corretores, lançamentos, Captação de proprietários, eventos e webhooks assinados. Base: https://api.imobyflow.com.br/v1. Autenticação: `Authorization: Bearer imob_live_…`. / REST integration API for ImobyFlow, a Brazilian real estate platform.

Valores de código (`VENDA`, `LOCACAO`, `ACTIVE`, subtipos como `APARTAMENTO`) são os da plataforma, sem tradução. Erros em `application/problem+json` (RFC 9457) com `code` estável. Escritas aceitam `?dryRun=true` (ensaio) e `Idempotency-Key`. Datas em ISO 8601 UTC; valores em reais.

## Documentação (português)

- [Início](https://imobyflow.com.br/desenvolvedores): o que a API faz, como pedir acesso e a primeira chamada
- [Conceitos e regras](https://imobyflow.com.br/desenvolvedores/conceitos): paginação, erros, escrita, modo ensaio, idempotência e as regras da plataforma
- [Eventos e webhooks](https://imobyflow.com.br/desenvolvedores/eventos-e-webhooks): sincronização incremental e a conferência da assinatura
- [Referência](https://imobyflow.com.br/desenvolvedores/referencia): todas as rotas, por recurso
- [Erros](https://imobyflow.com.br/desenvolvedores/erros): cada código, com a causa e o conserto
- [Referência completa em Markdown](https://imobyflow.com.br/desenvolvedores/llms-full.txt): tudo num arquivo, para assistentes de IA
- [OpenAPI 3.1 — JSON](https://imobyflow.com.br/desenvolvedores/openapi.json) · [YAML](https://imobyflow.com.br/desenvolvedores/openapi.yaml)

## Documentation (English)

- [Developers](https://imobyflow.com.br/en/developers): what the API does, how to get access and the first call
- [Concepts and rules](https://imobyflow.com.br/en/developers/concepts)
- [Events and webhooks](https://imobyflow.com.br/en/developers/events-and-webhooks)
- [Reference](https://imobyflow.com.br/en/developers/reference)
- [Errors](https://imobyflow.com.br/en/developers/errors)
- [Full reference in Markdown](https://imobyflow.com.br/en/developers/llms-full.txt)
- [OpenAPI 3.1 — JSON](https://imobyflow.com.br/en/developers/openapi.json) · [YAML](https://imobyflow.com.br/en/developers/openapi.yaml)

## Optional

- [Termos da API](https://imobyflow.com.br/termos-api): regras de uso e o acordo de tratamento de dados (LGPD)
- [Postman](https://imobyflow.com.br/desenvolvedores/postman.json): coleção pronta para importar
- SDKs oficiais (um arquivo, sem dependência): [TypeScript](https://imobyflow.com.br/desenvolvedores/sdk/typescript) · [Python](https://imobyflow.com.br/desenvolvedores/sdk/python) · [PHP](https://imobyflow.com.br/desenvolvedores/sdk/php)
- [Servidor MCP](https://imobyflow.com.br/desenvolvedores#mcp): `https://api.imobyflow.com.br/mcp`, com a chave da API no `Authorization`; escrita sempre em ensaio até `confirm: true`