# Get Documents By Number

Get Documents By Number with optional pagination.

Endpoint: POST /rest/v1/documents/getByNumber
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

  - `sortBy` (string)
    Field name to sort by. Defaults to 'created' if not specified.
    Example: "created"

  - `sortDirection` (string)
    Sorting direction. Defaults to 'desc' if not specified.
    Enum: "asc", "desc"

## Request fields (application/json):

  - `documentNumber` (string, required)
    The number of the document.
    Example: "1_2_3"

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

  - `issueYear` (string)
    Issue year (4 digits, optional). If provided, filters documents created in that year.
    Example: "2024"

## Response 200 fields (application/json):

  - `items` (array, required)
    List of documents found by document number.

  - `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."