---
seo:
  description: >-
    REST API for workspace integrations: contacts, buildings, deals (Vorgänge),
    projects, project modules and PV plans.
sidebar:
  label: Übersicht
title: Bauhow API
---
REST API for workspace integrations: contacts, buildings, deals (Vorgänge), projects, project modules and PV plans.

**Early access.** The API is enabled per workspace on request. Ask for access at https://bauhow.com/support before you build an integration; until then every request answers `403`.

Authenticate with a workspace API key from **Settings → Workspace → API**: `Authorization: Bearer bh_…`. A key acts with the permissions of the member who created it, limited to its scopes.

Version 1.0.0

Base URL: `https://app.bauhow.com/api`

## Contacts

- [`GET /v1/contacts`](/api/reference/contacts/contacts-list) — List contacts.
- [`POST /v1/contacts`](/api/reference/contacts/contacts-create) — Create a contact.
- [`GET /v1/contacts/{id}`](/api/reference/contacts/contacts-get) — Get a contact.
- [`PATCH /v1/contacts/{id}`](/api/reference/contacts/contacts-update) — Update a contact.
- [`DELETE /v1/contacts/{id}`](/api/reference/contacts/contacts-delete) — Delete a contact.
- [`GET /v1/contact-fields`](/api/reference/contacts/contacts-list-fields) — List contact field definitions.

## Buildings

- [`GET /v1/buildings`](/api/reference/buildings/buildings-list) — List buildings.
- [`POST /v1/buildings`](/api/reference/buildings/buildings-create) — Create a building for a contact.
- [`GET /v1/buildings/{id}`](/api/reference/buildings/buildings-get) — Get a building.

## Deals

- [`GET /v1/deals`](/api/reference/deals/deals-list) — List deals (Vorgänge).
- [`POST /v1/deals`](/api/reference/deals/deals-create) — Create a deal.
- [`GET /v1/deals/{id}`](/api/reference/deals/deals-get) — Get a deal.
- [`PATCH /v1/deals/{id}`](/api/reference/deals/deals-update) — Update a deal.
- [`DELETE /v1/deals/{id}`](/api/reference/deals/deals-delete) — Delete a deal.
- [`GET /v1/deal-stages`](/api/reference/deals/deals-list-stages) — List pipeline stages.
- [`PATCH /v1/deal-stages/{id}`](/api/reference/deals/deals-update-stage) — Update a pipeline stage.
- [`GET /v1/deal-project-types`](/api/reference/deals/deals-list-project-types) — List deal project types.

## Projects

- [`GET /v1/projects`](/api/reference/projects/projects-list) — List projects.
- [`POST /v1/projects`](/api/reference/projects/projects-create) — Create a project.
- [`GET /v1/projects/{id}`](/api/reference/projects/projects-get) — Get a project.
- [`PATCH /v1/projects/{id}`](/api/reference/projects/projects-update) — Update a project.
- [`POST /v1/projects/{id}/archive`](/api/reference/projects/projects-archive) — Archive a project.
- [`POST /v1/projects/{id}/restore`](/api/reference/projects/projects-restore) — Restore an archived project.

## Project modules

- [`GET /v1/projects/{projectId}/modules`](/api/reference/project-modules/projects-modules-list) — List the modules of a project.
- [`GET /v1/projects/{projectId}/modules/{moduleKey}`](/api/reference/project-modules/projects-modules-get) — Get a project module.
- [`PATCH /v1/projects/{projectId}/modules/{moduleKey}`](/api/reference/project-modules/projects-modules-update) — Update a project module.

## Photovoltaik

- [`GET /v1/projects/{projectId}/pv-plans`](/api/reference/photovoltaik/projects-pv-plans-list) — List the PV plans of a project.
- [`POST /v1/projects/{projectId}/pv-plans`](/api/reference/photovoltaik/projects-pv-plans-create) — Create a PV plan.
- [`GET /v1/pv-plans/{id}`](/api/reference/photovoltaik/projects-pv-plans-get) — Get a PV plan with its full planner document.
