# Get Inbox Document Statuses

Get Inbox Document Statuses By VAT Number And DateFrom/To Range.

Endpoint: POST /rest/v1/documents/inbox/status
Version: v1.0.0
Security: 

## Request fields (application/json):

  - `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 documents inbox statuses return model.

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

  - `items.documentSenderName` (string, required)
    The name of the sender of the document.
    Example: "Example Sender Ltd."

  - `items.documentNumber` (string, required)
    The document number of the invoice.
    Example: "INV-2023-001"

  - `items.internalStatus` (string, required)
    The internal status of the document.
    Example: "NEW|OK|FAILED"

  - `items.externalStatus` (object, required)
    Response returned by the fiscalization service.

  - `items.externalStatus.responseId` (string, required)
    Identifier of the response received from the fiscalization service.
    Example: "resp-879812"

  - `items.externalStatus.requestId` (string, required)
    Identifier of the fiscalization request sent.
    Example: "req-123456"

  - `items.externalStatus.responseDateTime` (string, required)
    Timestamp from the fiscalization response.
    Example: "2025-07-21T10:15:30Z"

  - `items.externalStatus.successful` (boolean, required)
    Indicates if the fiscalization was successful.
    Example: true

  - `items.externalStatus.errorCode` (string)
    Error code returned if the fiscalization failed.
    Example: "ERR_FIS_1001"

  - `items.externalStatus.errorMessage` (string)
    Error message returned if the fiscalization failed.
    Example: "Invalid taxpayer ID."

  - `items.externalStatus.invalidRecordNumber` (integer)
    Index of the invalid record in the request.
    Example: 3

  - `items.externalStatus.retryRecommended` (boolean, required)
    Indicates whether a retry is recommended.