---
title: "Get the next document numbers for an entity"
method: GET
path: "/entities/{entity_id}/settings/next_document_numbers"
tags: ["Entities"]
---

# Get the next document numbers for an entity

`GET /entities/{entity_id}/settings/next_document_numbers`

## Request

- Base URL: `https://api.sandbox.monite.com/v1`
- URL: `https://api.sandbox.monite.com/v1/entities/{entity_id}/settings/next_document_numbers`
- Auth: HTTP bearer

Returns the next sequence number for various document types - invoices, quotes, credit notes, and others. For example, if the last issued invoice is `INV-00042`, the next invoice number is 43.

To set the next document numbers, use `PATCH /entities/{entity_id}/settings`.

For more information, see [Document number customization](https://docs.monite.com/advanced/document-number-customization).

## Path parameters

- `entity_id` string, required

## Headers

- `x-monite-version` string, required

## Response `200`

Successful Response

- NextDocumentNumbers
  - `credit_note` integer: Next credit note number
  - `delivery_note` integer: Next delivery note number
  - `invoice` integer: Next invoice number
  - `purchase_order` integer: Next purchase order number
  - `quote` integer: Next quote number

## Other responses

- `401`: The `Authorization` header is missing or contains an invalid or expired access token. See [Authentication](https://docs.monite.com/api/concepts/authentication) to learn how to authenticate API calls.
- `403`: The specified access token does not have permissions to perform this operation.
- `404`: Not found
- `422`: Validation Error
- `429`: API rate limit has been exceeded. Check the response headers for the rate limit information.

---

[API](https://skmtc.dev/monite/apis/monite-2.md) - [All operations](https://skmtc.dev/monite/apis/monite-2/llms.txt) - [OpenAPI document](https://skmtc.dev/monite/apis/monite-2/revisions/4299ccf95edb?raw)