← Voltar para a visão geral

Cadastros

4 endpoints

Dados estruturais do condomínio

GET/api/v1/condominiums/{condominium}/units

Lista as unidades do condomínio com filtros por bloco, ocupação e nome

Sem autenticação
Headers
AuthorizationObrigatórioBearer <access_token>
X-Request-IdOpcionalEcoado na resposta
Parâmetros
ParâmetroLocalTipoDescrição
condominium*pathstring—
Respostas
POST/api/v1/condominiums/{condominium}/units

Cria uma unidade no condomínio e emite o webhook unit.created

Sem autenticação
Headers
AuthorizationObrigatórioBearer <access_token>
Content-TypeObrigatórioapplication/json
Idempotency-KeyRecomendadoULID, janela de 24h
X-Request-IdOpcionalEcoado na resposta
Parâmetros
ParâmetroLocalTipoDescrição
condominium*pathstring—
Corpo da requisição*
CampoTipoRestriçõesDescrição
name*string0–80 chars—
block_id*integer——
floorintegernullable—
build_typestringno_construction | in_construction | under_maintenance—
is_rentedboolean——
is_occupiedboolean——
parking_spacesinteger0–50Onboarding shortcut over the unit's parking spots. Reading it returns the number of spots the unit owns, adjusted by approved rentals. Writing it reconciles the spot records: raising the number appends unlabelled spots, lowering it removes unlabelled spots that are not lent out. It fails with 422 when reaching the requested number would require deleting a labelled spot or one under an active or pending rental, and when the condominium has more than one parking pool, since the spot's pool decides where it can be used.
areanumbernullable—
street_namestringnullable—
street_numberstringnullable—
Respostas
GET/api/v1/condominiums/{condominium}/parties

Lista moradores com filtro de nome e flag para listar somente bloqueados

Sem autenticação
Headers
AuthorizationObrigatórioBearer <access_token>
X-Request-IdOpcionalEcoado na resposta
Parâmetros
ParâmetroLocalTipoDescrição
condominium*pathstring—
Respostas
POST/api/v1/condominiums/{condominium}/parties

Cria um morador no condomínio e emite o webhook party.created

Sem autenticação
Headers
AuthorizationObrigatórioBearer <access_token>
Content-TypeObrigatórioapplication/json
Idempotency-KeyRecomendadoULID, janela de 24h
X-Request-IdOpcionalEcoado na resposta
Parâmetros
ParâmetroLocalTipoDescrição
condominium*pathstring—
Corpo da requisição*
CampoTipoRestriçõesDescrição
name*string0–255 chars—
social_namestringnullable—
document_rgstringnullable—
document_cpfstring—11 dígitos, sem formatação
document_passportstringnullable—
genderstringmale | female | agender—
birthed_atstring·date——
has_reduced_mobilityboolean——
Respostas