List purchase invoices

Retrieves a paginated list of purchase invoices.

GET /api/purchase-invoices

Query parameters

All query parameters are identical to Sales Invoices - List:

• document_number (string, optional) - Filter by invoice document number

• billed_by_name (string, optional) - Filter by supplier name

• billed_to_name (string, optional) - Filter by customer name

• billed_to_vat (string, optional) - Filter by customer VAT number

• billed_by_vat (string, optional) - Filter by supplier VAT number

• status (string, optional) - Filter by invoice status

• document_date (string, optional) - Filter by invoice issue date (format: yyyy-MM-dd)

• page (integer, optional) - Page number (0-indexed, default: 0)

• size (integer, optional) - Number of items per page (default: 10)

Response

Status code: 200 OK

Response body:

Returns a paginated response containing an array of purchase invoice objects.

Error responses

400 Bad Request

Invalid request parameters or validation failed.

{
  "errors": {
    "message": "Invalid request parameters"
  }
}

For validation errors, the response includes field-specific errors:

{
  "errors": {
    "profile_execution_id": "Profile execution ID is mandatory",
    "issue_date": "Issue date is mandatory"
  }
}

401 Unauthorized

Authentication required or invalid token.

{
  "errors": {
    "message": "Authentication required or invalid token"
  }
}

500 Internal Server Error

An error occurred while processing the request.

{
  "errors": {
    "message": "An error occurred"
  }
}