---
title: "POST /billing/invoices/{id}/mark_as_paid/"
method: POST
path: "/billing/invoices/{id}/mark_as_paid/"
tags: ["billing"]
---

# POST /billing/invoices/{id}/mark_as_paid/

`POST /billing/invoices/{id}/mark_as_paid/`

## Request

- The document declares no server URL.
- Auth: API key in header `Authorization`

## Path parameters

- `id` string, uuid, required

## Query parameters

- `format` 'json' | 'xlsx'

## Request body

- Invoice
  - `id` string, uuid, required
  - `url` string, uri, required
  - `account` InvoiceAccount, required
    - `id` string, uuid, required
    - `slug` string, required
    - `name` string, required
    - `registry_code` string
    - `vatin` string
    - `billing_reference` string
    - `billing_email` string, email
    - `billing_vat` boolean
  - `billing_method` 'braintree' | 'invoice' | 'stripe', required
  - `state` 'draft' | 'confirmed' | 'overdue' | 'paid' | 'cancelled', required
  - `period` string[], required: Indicates what period the price was calculated for
  - `total_no_vat` string, decimal, required
  - `total_vat` string, decimal, required
  - `total_with_vat` string, decimal, required
  - `currency` string, required
  - `vat` boolean, required
  - `due_date` string, date, nullable
  - `paid_at` string, date-time, required
  - `items` InvoiceItem[], required
    - `id` string, uuid, required
    - `invoice` string, uri, required
    - `name` string, required
    - `unit_price` string, decimal, required
    - `quantity` string, decimal, required
    - `unit` string
    - `total` string, decimal, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `pricing` string, uuid, required
  - `confirmed_by` string, uri, required
  - `confirmed_at` string, date-time, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Response `200`

- Invoice
  - `id` string, uuid, required
  - `url` string, uri, required
  - `account` InvoiceAccount, required
    - `id` string, uuid, required
    - `slug` string, required
    - `name` string, required
    - `registry_code` string
    - `vatin` string
    - `billing_reference` string
    - `billing_email` string, email
    - `billing_vat` boolean
  - `billing_method` 'braintree' | 'invoice' | 'stripe', required
  - `state` 'draft' | 'confirmed' | 'overdue' | 'paid' | 'cancelled', required
  - `period` string[], required: Indicates what period the price was calculated for
  - `total_no_vat` string, decimal, required
  - `total_vat` string, decimal, required
  - `total_with_vat` string, decimal, required
  - `currency` string, required
  - `vat` boolean, required
  - `due_date` string, date, nullable
  - `paid_at` string, date-time, required
  - `items` InvoiceItem[], required
    - `id` string, uuid, required
    - `invoice` string, uri, required
    - `name` string, required
    - `unit_price` string, decimal, required
    - `quantity` string, decimal, required
    - `unit` string
    - `total` string, decimal, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `pricing` string, uuid, required
  - `confirmed_by` string, uri, required
  - `confirmed_at` string, date-time, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Changes

- **2026-07-13** `2557a8fec764`: 2 info
  - media type `application/json; version=2.4.12` was changed to `application/json; version=2.4.13` for the response status `200`
  - media type `application/xlsx; version=2.4.12` was changed to `application/xlsx; version=2.4.13` for the response status `200`
- **2022-10-13** `b89c1b3e6d09`: 2 info
  - media type `application/json; version=2.4.11` was changed to `application/json; version=2.4.12` for the response status `200`
  - media type `application/xlsx; version=2.4.11` was changed to `application/xlsx; version=2.4.12` for the response status `200`
- **2022-09-20** `2823b16250b7`: 2 info
  - media type `application/json; version=2.4.10` was changed to `application/json; version=2.4.11` for the response status `200`
  - media type `application/xlsx; version=2.4.10` was changed to `application/xlsx; version=2.4.11` for the response status `200`
- **2022-09-16** `025494408062`: 2 info
  - media type `application/json; version=2.4.5` was changed to `application/json; version=2.4.10` for the response status `200`
  - media type `application/xlsx; version=2.4.5` was changed to `application/xlsx; version=2.4.10` for the response status `200`
- **2022-09-08** `486e2fd12f8f`: 2 info
  - media type `application/json; version=2.3.5` was changed to `application/json; version=2.4.5` for the response status `200`
  - media type `application/xlsx; version=2.3.5` was changed to `application/xlsx; version=2.4.5` for the response status `200`

[Operation history](https://skmtc.dev/oeklo/apis/gsmtasks-project-api/changes/billing/invoices/:id/mark_as_paid/post.md)

---

[API](https://skmtc.dev/oeklo/apis/gsmtasks-project-api.md) - [All operations](https://skmtc.dev/oeklo/apis/gsmtasks-project-api/llms.txt) - [OpenAPI document](https://skmtc.dev/oeklo/apis/gsmtasks-project-api/revisions/2557a8fec764?raw)
