---
title: "Get list of bills pending approval"
method: GET
path: "/v3/bill-approvals/pending-user-approvals"
tags: ["bill-approvals"]
---

# Get list of bills pending approval

`GET /v3/bill-approvals/pending-user-approvals`

## Request

- Base URL: `https://gateway.stage.bill.com/connect`
- URL: `https://gateway.stage.bill.com/connect/v3/bill-approvals/pending-user-approvals`
- Auth: none declared

Get a list of bills that are pending approval by a user. In the response, you get the list of bills that are pending approval for the currently signed-in user.

## Headers

- `sessionId` string, nullable: API session ID generated with `/v3/login`
- `devKey` string, nullable: Developer key generated with your BILL developer account

## Response `200`

Get list of bills pending approval response

- ListBillUserApprovalsResponseDto: List Bill User Approvals Response Dto.
  - `bills` BillUserApprovalsResponseDto[]: List of bills pending approval
    - `billId` string, required: BILL-generated ID of the bill. The value begins with `00n`.
    - `vendorId` string, required: BILL-generated ID of the vendor. The value begins with `009`.
    - `amount` number: Bill amount. This value is in USD.
    - `dueDate` string, date: Bill due date. The value is in the `yyyy-MM-dd` format.

## Other responses

- `4XX`: List of errors.
- `5XX`: List of errors.

---

[API](https://skmtc.dev/bill/apis/bill-v3-api.md) - [All operations](https://skmtc.dev/bill/apis/bill-v3-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bill/apis/bill-v3-api/revisions/54edddceb0a5?raw)