---
title: "Retrieves the lines containined in the specified bulk file"
method: POST
path: "/mntfee-services/v1/maintenancefee/bulk/list"
tags: ["maintenanceFeeResource"]
---

# Retrieves the lines containined in the specified bulk file

`POST /mntfee-services/v1/maintenancefee/bulk/list`

## Request

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

## Request body

- MaintenanceFeeBulkPageModel
  - `version` integer
  - `pageSize` integer
  - `pageIndex` integer
  - `totalElements` integer
  - `sortInfo` SortInfo[]
    - `version` integer
    - `sortParameter` string, required
    - `sortOrder` string, required
  - `fileId` integer
  - `filter` 'ALL' | 'INVALID' | 'VALID', required
  - `criteria` string, required
  - `results` MaintenanceFeeBulkLineModel[]
    - `version` integer
    - `patentNumber` string, required
    - `applicationNumber` string, required
    - `attorneyDocketNumber` string, required
    - `feeCode` string, required
    - `feeAmount` string, required
    - `errors` MaintenanceFeeBulkLineErrorModel[]
      - `version` integer
      - `errorCode` integer
      - `messageText` 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/v1/maintenancefee/bulk/list/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)