---
title: "Get invoice approvals"
method: GET
path: "/v1/invoice-approval"
tags: ["v1 - Invoice Approvals"]
---

# Get invoice approvals

`GET /v1/invoice-approval`

## Request

- Base URL: `https://light.inc` (the document declares no server; this is the origin it was published from)
- URL: `https://light.inc/v1/invoice-approval`
- Auth: one of:
  - API key in header `Authorization`
  - HTTP bearer

Returns approval records for specified invoice payables

## Query parameters

- `invoicePayableId` string[]

## Request body

- LightPrincipal
  - `roles` string[]
  - `name` string

## Response `default`

default response

- ExternalInvoiceApprovalV1Model[]
  - `id` string, uuid
  - `companyId` string, uuid
  - `invoicePayableId` string, uuid
  - `invoiceDocumentKey` string
  - `invoiceNumber` string, nullable
  - `invoiceAmount` integer
  - `invoiceCurrency` string
  - `invoiceIssuedAt` string, date-time
  - `invoiceIssuedDate` string, date
  - `invoiceDueAt` string, date-time
  - `invoiceDueDate` string, date
  - `userApprovals` ExternalInvoiceUserApprovalV1Model[]
    - `id` string, uuid
    - `approvalId` string, uuid
    - `userId` string, uuid, nullable
    - `userGroupId` string, uuid, nullable
    - `priority` integer
    - `status` 'APPROVED' | 'CANCELLED' | 'DECLINED' | 'FAILED' | 'IN_REVIEW' | 'PENDING': ⚠️ This enum is not exhaustive; new values may be added in the future.
    - `note` string, nullable
    - `completedAt` string, date-time, nullable
    - `updatedAt` string, date-time
    - `createdAt` string, date-time
    - `notifiedAt` string, date-time, nullable
  - `note` string, nullable
  - `status` 'APPROVED' | 'DECLINED' | 'CANCELLED' | 'FAILED' | 'IN_PROGRESS': ⚠️ This enum is not exhaustive; new values may be added in the future.
  - `completedAt` string, date-time, nullable
  - `updatedAt` string, date-time
  - `createdAt` string, date-time

---

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