---
title: "Suggest Positions"
method: POST
path: "/companies/{company_id}/ar/suggest-positions"
tags: ["ar-invoices"]
---

# Suggest Positions

`POST /companies/{company_id}/ar/suggest-positions`

## Request

- Base URL: `https://app.zeno-works.ch` (the document declares no server; this is the origin it was published from)
- URL: `https://app.zeno-works.ch/companies/{company_id}/ar/suggest-positions`
- Auth: none declared

Suggest line positions from a previously-analyzed document (``item``).

## Path parameters

- `company_id` string, required

## Headers

- `authorization` string, nullable

## Cookies

- `access_token` string, nullable

## Request body

- SuggestPositionsIn
  - `item_id` string, required

## Response `200`

Successful Response

- SuggestPositionsOut
  - `positions` PositionSuggestion[], required
    - `line_type` string, required
    - `description` string, nullable
    - `quantity` string, nullable
    - `unit_price` string, nullable
    - `vat_rate_bps` integer, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/zeno-works/apis/zeno-api.md) · [All operations](https://skmtc.dev/zeno-works/apis/zeno-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zeno-works/apis/zeno-api/revisions/1eb93dde146c?raw)
