---
title: "Get list of exported BILL records"
method: GET
path: "/v3/exports"
tags: ["exports"]
---

# Get list of exported BILL records

`GET /v3/exports`

Get a list of exported BILL records available for you to download. By default, you get 20 results on one page of results. Set `max` in your request to get up to 100 results on one page.

From the response, use `exportId` to get the download URL for an exported record file with `GET /v3/exports/{exportId}/download-link`.

You can export records, such as vendors, customers, bills, and invoices. In addition, you can export AP payments and AR payments. The **Import and export** section in the BILL web app (**Settings > Import & export > Custom File Integration**) provides the complete list of entities that you can export.

See [Export BILL records](https://developer.bill.com/docs/export-bill-records) in the Guides section for more information, sample requests, and responses.

## Query parameters

- `max` integer, nullable — Maximum number of results
- `filters` string, nullable — Field name, operator, and value. Both simple and compound filtering is available. The format is `filters={field_01}:{op}:{value},{field_02}:{op}:{value}`.
- `page` string, nullable — Next page of results. When a list has multiple pages, the `nextPage` and `prevPage` values in the response enable you to navigate between the pages of results. Set `page` as the `nextPage` or `prevPage` value for navigation.

## 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 exported BILL records response

- ListExportResponseDto — Response from a list API request with paging references.
  - `nextPage` string
  - `prevPage` string
  - `results` ExportResponseDto[]
    - `entity` 'BILL' | 'CUSTOMER' | 'CHART_OF_ACCOUNT' | 'DEPARTMENT' | 'INVOICE' | 'ITEM' | 'JOB' | 'VENDOR' | 'PAYMENT' | 'LOCATION' | 'EMPLOYEE' | 'ACCOUNTING_CLASS' | 'FUND_TRANSFER' | 'PAYMENT_RECEIVED' | 'VENDOR_CREDIT' | 'CREDIT_MEMO' | 'PAYMENT_TERM' | 'BILL_LINE_ITEM' | 'USER' | 'CUSTOMER_CREDIT_LINE_ITEM' | 'ACH_PAYMENT_HISTORY' | 'INVOICE_LINE_ITEM' | 'RECEIVABLE_CUSTOM_FIELD' | 'BILL_PAYMENT' | 'INVOICE_PAYMENT' | 'VENDOR_CREDIT_LINE_ITEM' | 'AMORTIZATION_SCHEDULE' | 'JOURNAL_ENTRY' | 'INTEGRATION_STATUS' | 'CARD_TRANSACTION' | 'REIMBURSEMENT' | 'PURCHASE_ORDER' | 'PURCHASE_ORDER_LINE_ITEM' | 'PAYMENT_FEES' | 'UNDEFINED' — Exported record entity name.
    - `name` string — Exported record template name. In the BILL web app, if you create a template for exported records (**Settings > Import & export > Custom File Integration > Teamplates**), `name` is set as the template name. If a template is not created, `name` is set as a BILL-generated value.
    - `processedTime` string, date-time — Export operation processed date and time
    - `status` 'CREATED' | 'QUEUED' | 'IN_PROGRESS' | 'DATA_REQUESTED' | 'DATA_GENERATION_IN_PROGRESS' | 'FILE_READY_FOR_TRANSFER' | 'FILE_TRANSFER_IN_PROGRESS' | 'FILE_TRANSFERRED' | 'FILE_TRANSFER_FAILED' | 'SUCCESS' | 'PARTIAL_SUCCESS' | 'FAILED' | 'CANCELLED' | 'EXPIRED' | 'UNDEFINED' — Export operation status.
    - `fileName` string — Exported record file name
    - `exportId` string — BILL-generated ID of the exported record file. Use this value to get the download URL for the exported record file with `GET /v3/exports/{exportId}/download-link`.

## Other responses

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

---

[API](https://skmtc.net/bill/apis/bill-v3-api.md) · [All operations](https://skmtc.net/bill/apis/bill-v3-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bill/bill-v3-api/revisions/0483350c434e/schema)