---
title: "Generates an Excel spreadsheet containing the user's bulk file submission history"
method: POST
path: "/mntfee-services/v2/maintenancefee/bulk/history/admin"
tags: ["maintenanceFeeResource"]
---

# Generates an Excel spreadsheet containing the user's bulk file submission history

`POST /mntfee-services/v2/maintenancefee/bulk/history/admin`

## Request

- Base URL: `https://fees.uspto.gov`
- URL: `https://fees.uspto.gov/mntfee-services/v2/maintenancefee/bulk/history/admin`
- Auth: none declared
- TypeScript: <https://skmtc.dev/uspto/apis/maintenance-fee-rest-api/docs/mntfee-services/v2/maintenancefee/bulk/history/admin/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- MaintenanceFeeBulkPaymentHistoryModel
  - `version` integer
  - `pageSize` integer
  - `pageIndex` integer
  - `totalElements` integer
  - `sortInfo` SortInfo[]
    - `version` integer
    - `sortParameter` string, required
    - `sortOrder` string, required
  - `userId` string, required
  - `depositAccountNumber` string, required
  - `paymentMethod` string, required
  - `fromDate` string, date-time, required
  - `toDate` string, date-time, required
  - `minPaymentAmount` number, required
  - `maxPaymentAmount` number, required
  - `status` 'UPLOADED' | 'FORMAT_VALIDATED' | 'CANCELED' | 'SUBMITTED' | 'ACQUIRED_FOR_PROCESSING' | 'DATA_VALIDATED' | 'PROCESSING_PAYMENT' | 'GENERATING_RECEIPT' | 'GENERATING_STATEMENT' | 'COMPLETED' | 'PENDING_RETRY' | 'FAILED', required
  - `originalFilename` string, required
  - `results` MaintenanceFeeBulkPaymentModel[]
    - `version` integer
    - `fileId` integer
    - `status` 'UPLOADED' | 'FORMAT_VALIDATED' | 'CANCELED' | 'SUBMITTED' | 'ACQUIRED_FOR_PROCESSING' | 'DATA_VALIDATED' | 'PROCESSING_PAYMENT' | 'GENERATING_RECEIPT' | 'GENERATING_STATEMENT' | 'COMPLETED' | 'PENDING_RETRY' | 'FAILED', required
    - `date` string, date-time, required
    - `depositAccountNumber` string, required
    - `paymentMethod` string, required
    - `originalFilename` string, required
    - `originalFileId` string, required
    - `receiptFileId` string, required
    - `statementFileId` string, required
    - `paidCount` integer
    - `notPaidCount` integer
    - `totalAmountPaid` number, required
    - `userId` string, required
    - `statementStatus` string, required

## Response `200`

OK

- MaintenanceFeeResponse
  - `success` boolean
  - `errorMessageText` string[]
  - `infoMessageText` string[]
  - `warnMessageText` string[]
  - `model` BaseModel[]
    - `version` integer
  - `errorCode` integer

## Changes

- **2026-11-07** `e9c1637ae9b0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/uspto/apis/maintenance-fee-rest-api/changes/mntfee-services/v2/maintenancefee/bulk/history/admin/post.md)

---

[API](https://skmtc.dev/uspto/apis/maintenance-fee-rest-api.md) - [All operations](https://skmtc.dev/uspto/apis/maintenance-fee-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/uspto/apis/maintenance-fee-rest-api/revisions/e9c1637ae9b0?raw)