# Get Invoices By External Status

Get Invoice By External Status.

Endpoint: POST /rest/v1/documents/getByExternalStatus
Version: v1.0.0
Security: PublicApiKey

## Query parameters:

  - `pageNumber` (integer)
    Page number (starting from 1)
    Example: 1

  - `pageSize` (integer)
    Number of items per page
    Example: 200

## Request fields (application/json):

  - `status` (string, required)
    One of the possible statuses of the invoice document.
    Example: "rejected"

  - `companyVatNumber` (string, required)
    The VAT number of the company.
    Example: "HR12345678910"

  - `dateFrom` (string, required)
    Date when an invoice was paid

  - `dateTo` (string, required)
    Date when an invoice was paid

## Response 200 fields (application/json):

  - `items` (array, required)
    List of invoice documents.

  - `items.documentId` (string, required)
    The unique identifier of the invoice document.
    Example: "6787a98e15306d37eed688a8"

  - `totalElements` (integer, required)
    Total number of documents found across all pages
    Example: 47

  - `totalPages` (integer, required)
    Total number of pages available
    Example: 2

  - `size` (integer, required)
    Current page size (number of items per page)
    Example: 25

  - `number` (integer, required)
    Current page number (1-based)
    Example: 1

  - `numberOfElements` (integer, required)
    Number of elements in current page
    Example: 25

  - `first` (boolean, required)
    Whether this is the first page
    Example: true

  - `last` (boolean, required)
    Whether this is the last page

  - `empty` (boolean, required)
    Whether the page is empty

## Response 400 fields (application/json):

  - `statusCode` (integer, required)
    Http status code of the response.
    Example: 400

  - `resultMessage` (string, required)
    Result message.
    Example: "Error processing."

## Response 401 fields (application/json):

  - `statusCode` (integer, required)
    Http status code of the response.
    Example: 400

  - `resultMessage` (string, required)
    Result message.
    Example: "Error processing."

## Response 500 fields (application/json):

  - `statusCode` (integer, required)
    Http status code of the response.
    Example: 400

  - `resultMessage` (string, required)
    Result message.
    Example: "Error processing."