---
title: "List bills for a customer (admin)"
method: GET
path: "/v1/admin/customer/{customerId}/bill"
tags: ["Bill"]
---

# List bills for a customer (admin)

`GET /v1/admin/customer/{customerId}/bill`

## Path parameters

- `customerId` string, required

## Query parameters

- `status` union
  - 'draft'
  - 'submitted'
  - 'returned'
  - 'paymentPending'
  - 'paymentInProgress'
  - 'paid'
  - 'paymentFailed'
  - 'manuallyCompleted'
  - 'deleted'
- `vendorId` string
- `page` integer
- `pageSize` integer

## Response `200`

Default Response

- object
  - `items` object[], required
    - `id` string, required
    - `status` union, required
      - 'draft'
      - 'submitted'
      - 'returned'
      - 'paymentPending'
      - 'paymentInProgress'
      - 'paid'
      - 'paymentFailed'
      - 'manuallyCompleted'
      - 'deleted'
    - `vendorId` string, nullable, required
    - `creatorUserId` string, required
    - `externalId` string, nullable, required
    - `invoiceId` string, nullable, required
    - `invoiceDate` string, nullable, required
    - `paymentDueDate` string, nullable, required
    - `paymentScheduledDate` string, nullable, required
    - `totalAmount` string, nullable, required
    - `currencyCode` string, nullable, required
    - `description` string, nullable, required
    - `accountingPlatformId` string, nullable, required
    - `accountingRutterId` string, nullable, required
    - `accountingLastSyncedAt` string, date-time, nullable, required
    - `accountingErrorCode` string, nullable, required
    - `submittedAt` string, date-time, nullable, required
    - `completedAt` string, date-time, nullable, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
  - `hasNext` boolean, required
  - `totalCount` number, required

## Other responses

- `400` — Default Response
- `401` — The access to this resource has been denied
- `403` — The access to this resource is forbidden
- `default` — Catch-all error response for any unexpected internal errors

---

[API](https://skmtc.dev/funneldash/apis/surface-admin-api.md) · [All operations](https://skmtc.dev/funneldash/apis/surface-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/funneldash/surface-admin-api/revisions/0dc20381c4a7/schema)