---
title: "Build a GOBL document"
method: POST
path: "/build"
tags: ["Documents"]
---

# Build a GOBL document

`POST /build`

Parses, calculates, and validates a GOBL document. Optionally wraps the result in an envelope.

## Request body

- BuildRequest
  - `data` unknown, required
  - `template` unknown
  - `type` string — Document type hint (e.g. `bill/invoice`).
  - `envelop` boolean — Wrap the result in an envelope.

## Response `200`

Built document or envelope

- unknown

## Other responses

- `400` — Error response
- `422` — Error response

---

[API](https://skmtc.dev/gobl/apis/gobl-api.md) · [All operations](https://skmtc.dev/gobl/apis/gobl-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gobl/gobl-api/revisions/66ef451fe34b/schema)