---
title: "Reject a received invoice's approval"
method: POST
path: "/api/received-invoices/{aggregate_id}/reject-approval"
tags: ["Received invoices"]
---

# Reject a received invoice's approval

`POST /api/received-invoices/{aggregate_id}/reject-approval`

## Request

- Base URL: `https://api.typless.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.typless.com/api/received-invoices/{aggregate_id}/reject-approval`
- Auth: none declared

## Path parameters

- `aggregate_id` string, uuid, required

## Request body

- RejectDocumentApprovalRequest
  - `note` string, required

## Response `200`

Successful Response

- DocumentDTO
  - `aggregate_id` string, uuid, required
  - `tenant_id` string, uuid, required
  - `business_unit_id` string, uuid, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `modified_by` string, required
  - `pdf_s3_location` S3Location, required
    - `bucket` string, required
    - `object` string, required
    - `original_file_name` string
  - `source` Source, required
    - `type` 'EMAIL' | 'MINIMAX' | 'UPLOAD', required
    - `created_at` string, date-time, required
    - `original_file_extension` string
  - `status` 'CREATED' | 'EXTRACTION_IN_PROGRESS' | 'EXTRACTION_FINISHED' | 'EXTRACTION_FAILED' | 'WAITING_REVIEW' | 'IN_REVIEW' | 'CONFIRMED' | 'WAITING_EXPORT' | 'IN_EXPORT' | 'REJECTED' | 'EXPORTED' | 'EXPORT_ERROR' | 'MERGED', required
  - `approval_status` 'NOT_REQUIRED' | 'PENDING_EVALUATION' | 'WAITING_APPROVAL' | 'APPROVED' | 'REJECTED', required: The approval axis, orthogonal to ``DocumentStatus``.
  - `xml_s3_location` S3Location, required
    - `bucket` string, required
    - `object` string, required
    - `original_file_name` string
  - `adjusted_s3_location` S3Location, required
    - `bucket` string, required
    - `object` string, required
    - `original_file_name` string
  - `details` DocumentDetails, required
    - `fields` ExtractedField[]
      - `name` string, required
      - `data_type` 'AUTHOR' | 'STRING' | 'VAT_ID' | 'CURRENCY' | 'DATE' | 'NUMBER' | 'BOOLEAN' | 'SELECT' | 'CONSTANT' | 'MULTISELECT' | 'DATETIME' | 'UUID' | 'TAG', required
      - `values` ExtractedValue[], required
        - `x` integer
        - `y` integer
        - `width` integer
        - `height` integer
        - `page_number` integer
        - `value` string, nullable
        - `confidence_score` number
      - `multiple_values` boolean
    - `vat_rates` array[]
      - ExtractedField[]
        - `name` string, required
        - `data_type` 'AUTHOR' | 'STRING' | 'VAT_ID' | 'CURRENCY' | 'DATE' | 'NUMBER' | 'BOOLEAN' | 'SELECT' | 'CONSTANT' | 'MULTISELECT' | 'DATETIME' | 'UUID' | 'TAG', required
        - `values` ExtractedValue[], required
          - `x` integer
          - `y` integer
          - `width` integer
          - `height` integer
          - `page_number` integer
          - `value` string, nullable
          - `confidence_score` number
        - `multiple_values` boolean
    - `line_items` array[]
      - ExtractedField[]
        - `name` string, required
        - `data_type` 'AUTHOR' | 'STRING' | 'VAT_ID' | 'CURRENCY' | 'DATE' | 'NUMBER' | 'BOOLEAN' | 'SELECT' | 'CONSTANT' | 'MULTISELECT' | 'DATETIME' | 'UUID' | 'TAG', required
        - `values` ExtractedValue[], required
          - `x` integer
          - `y` integer
          - `width` integer
          - `height` integer
          - `page_number` integer
          - `value` string, nullable
          - `confidence_score` number
        - `multiple_values` boolean
  - `received_details` DocumentDetails, required
    - `fields` ExtractedField[]
      - `name` string, required
      - `data_type` 'AUTHOR' | 'STRING' | 'VAT_ID' | 'CURRENCY' | 'DATE' | 'NUMBER' | 'BOOLEAN' | 'SELECT' | 'CONSTANT' | 'MULTISELECT' | 'DATETIME' | 'UUID' | 'TAG', required
      - `values` ExtractedValue[], required
        - `x` integer
        - `y` integer
        - `width` integer
        - `height` integer
        - `page_number` integer
        - `value` string, nullable
        - `confidence_score` number
      - `multiple_values` boolean
    - `vat_rates` array[]
      - ExtractedField[]
        - `name` string, required
        - `data_type` 'AUTHOR' | 'STRING' | 'VAT_ID' | 'CURRENCY' | 'DATE' | 'NUMBER' | 'BOOLEAN' | 'SELECT' | 'CONSTANT' | 'MULTISELECT' | 'DATETIME' | 'UUID' | 'TAG', required
        - `values` ExtractedValue[], required
          - `x` integer
          - `y` integer
          - `width` integer
          - `height` integer
          - `page_number` integer
          - `value` string, nullable
          - `confidence_score` number
        - `multiple_values` boolean
    - `line_items` array[]
      - ExtractedField[]
        - `name` string, required
        - `data_type` 'AUTHOR' | 'STRING' | 'VAT_ID' | 'CURRENCY' | 'DATE' | 'NUMBER' | 'BOOLEAN' | 'SELECT' | 'CONSTANT' | 'MULTISELECT' | 'DATETIME' | 'UUID' | 'TAG', required
        - `values` ExtractedValue[], required
          - `x` integer
          - `y` integer
          - `width` integer
          - `height` integer
          - `page_number` integer
          - `value` string, nullable
          - `confidence_score` number
        - `multiple_values` boolean
  - `text_blocks_s3_location` S3Location, required
    - `bucket` string, required
    - `object` string, required
    - `original_file_name` string
  - `typless_object_id` string, nullable, required
  - `is_proforma` boolean, nullable, required
  - `merged_with_aggregate_id` string, uuid, nullable, required
  - `extraction_id` string, nullable, required
  - `recognition_type` string, nullable, required
  - `document_type_name` string, nullable, required
  - `document_type_id` string, uuid, nullable, required
  - `processed_by` string, nullable, required
  - `extraction_failed` boolean, required
  - `file_name` string, required
  - `notes` string, nullable, required
  - `locked_by` string, uuid, nullable, required
  - `locked_until` string, date-time, nullable, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/typless/apis/typless-api.md) · [All operations](https://skmtc.dev/typless/apis/typless-api/llms.txt) · [OpenAPI document](https://skmtc.dev/typless/apis/typless-api/revisions/d614787a47ef?raw)