> ## Documentation Index
> Fetch the complete documentation index at: https://help.trykarat.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cancel an invoice

> Cancels an open or overdue invoice. Other statuses, including an already cancelled invoice, return 400. No request body is required.



## OpenAPI

````yaml /api-reference/openapi.json put /invoices/{id}/cancel
openapi: 3.1.0
info:
  title: Karat Payout API
  description: >-
    Your gateway to seamless, automated, and scalable payment solutions. The
    Karat Payout API lets you create recipients, send payouts, track payment
    status, manage tax documents and invoices, record external payments, and
    subscribe to webhook events.
  version: 1.0.0
servers:
  - url: https://payouts.api.trykarat.com
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Account
    description: Retrieve payout source accounts, balances, and payout totals.
  - name: Payments
    description: Create and manage outgoing payouts to recipients.
  - name: Recipients
    description: Manage the payees you send payouts to.
  - name: Tax
    description: Retrieve recipient tax forms (W-9) and download links.
  - name: External Payments
    description: Record and manage payments made outside of Karat.
  - name: Webhooks
    description: Subscribe to event notifications for payout activity.
  - name: Invoices
    description: >-
      Create, list, retrieve, cancel, and send reminders for invoices; retrieve
      temporary PDF links.
paths:
  /invoices/{id}/cancel:
    put:
      tags:
        - Invoices
      summary: Cancel an invoice
      description: >-
        Cancels an open or overdue invoice. Other statuses, including an already
        cancelled invoice, return 400. No request body is required.
      operationId: cancelInvoice
      parameters:
        - name: id
          in: path
          required: true
          description: Invoice UUID belonging to your organization.
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Cancel an invoice.
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                properties:
                  data:
                    type: object
                    required:
                      - id
                      - status
                    properties:
                      id:
                        type: string
                        format: uuid
                      status:
                        type: string
                        enum:
                          - cancelled
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          description: Invoice not found in your organization.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  responses:
    BadRequest:
      description: The request was invalid.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              message: 'amount: amount must be positive'
    Unauthorized:
      description: Missing or invalid API key.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              message: Invalid api key
  schemas:
    Error:
      type: object
      description: Standard error envelope returned for all non-2xx responses.
      properties:
        error:
          type: object
          properties:
            message:
              type: string
            code:
              type: string
          required:
            - message
      required:
        - error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'Pass your API key as a bearer token: `Authorization: Bearer <API_KEY>`.'

````