---
title: "Update bill fields (admin)"
method: PATCH
path: "/v1/admin/customer/{customerId}/bill/{billId}"
tags: ["Bill"]
---

# Update bill fields (admin)

`PATCH /v1/admin/customer/{customerId}/bill/{billId}`

## Path parameters

- `customerId` string, required
- `billId` string, required

## Request body

- object
  - `status` union
    - 'returned'
    - 'paymentInProgress'
    - 'paid'
    - 'paymentFailed'
  - `vendorId` string
  - `invoiceId` string
  - `invoiceDate` string
  - `paymentDueDate` string
  - `totalAmount` string
  - `currencyCode` string
  - `description` string

## Response `200`

Default Response

- object
  - `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
  - `lineItems` object[], required
    - `id` string, required
    - `description` string, nullable, required
    - `amount` string, required
    - `spendCategoryId` string, nullable, required
  - `documents` object[], required
    - `id` string, required
    - `fileName` string, required
    - `type` union, required
      - 'invoice'
      - 'supporting'
    - `status` union, required
      - 'uploading'
      - 'uploaded'
      - 'parsed'
    - `parsedData` object
      - `invoiceId` string, nullable
      - `vendorName` string, nullable
      - `currencyCode` string, nullable
      - `invoiceDate` string, nullable
      - `dueDate` string, nullable
      - `totalAmount` string, nullable
      - `description` string, nullable
      - `achAccountName` string, nullable
      - `achRoutingNumber` string, nullable
      - `achAccountNumber` string, nullable
      - `lineItems` object[]
        - `description` string, nullable
        - `amount` string, nullable
    - `createdAt` string, date-time, required
  - `canSubmitErrors` object[], required
    - `code` string, required
    - `message` string, required

## Other responses

- `400` — Default Response
- `401` — The access to this resource has been denied
- `403` — The access to this resource is forbidden
- `404` — The resource was not found
- `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)