---
updatedAt: 2026-05-21T14:54:03.000Z
agentTools:
  projectIndex: https://developer.bill.com/llms.txt
---

# Export BILL records

With  `GET /v3/exports`, you can get a list of exported BILL records available for you to download. See <Anchor label="/v3/exports" target="_blank" href="https://developer.bill.com/reference/listexports">/v3/exports</Anchor> in the API reference for more information.

## What are exported BILL records?

You can export records for entities, such as vendors, customers, bills, and invoices. In addition, you can export records for transactions, such as 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 you can export. In this section, you can set up a schedule for BILL exports. For example, on a weekly schedule, you can have BILL export records for your choice of BILL entities.

Each exported record is in the CSV format. If you are using an accounting system that does not sync with BILL, you can use these CSV files to export records from BILL, and then import the data into your accounting system.

## Set up a schedule for BILL exports

In the BILL web app, you can set up a schedule for BILL exports. Based on the schedule, you get the download link to the generated export record with `GET /v3/exports`.

1. Sign in to the BILL web app in your sandbox environment.
2. Click **Settings** in your BILL account.
3. Click **Import & export > Custom File Integration**.
4. Under **Schedules**, click **Create Schedule** and set up your BILL exported records delivery schedule.
5. Set a **Schedule name**, **Record type**, and **Template** for the entity you want BILL to export.
6. Set **Frequency**, **Day of week**, **Time of day**, and **Start date - End date** for how often you want BILL to export records.
7. Set **File type** as **CSV**.
8. Set **Delimiter** as the delimiter type for each field in each record in the exported CSV.
9. Set **Delivery method** as **Download**.
10. Click **Save**.

When you set up a schedule for BILL exports, BILL starts generating an export record.

## Get a list of exported BILL records

### Sample response

With `GET /v3/exports`, you get a list of exported BILL records available for you to download.

In the response, `entity` is the exported record entity name (such as `BILL` or `VENDOR`), and `status` is the exported record status (such as `IN_PROGRESS` or `SUCCESS`). The `exportId` is the 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`.

```json
{
  "results": [
    {
      "entity": "PAYMENT",
      "name": "Export all available fields",
      "processedTime": "2026-12-30T23:01:41.013+00:00",
      "status": "SUCCESS",
      "fileName": "SENT_PAY-1769814103540.csv",
      "exportId": "{export_id}"
    },
    {
      "entity": "VENDOR",
      "name": "Export all available fields",
      "processedTime": "2026-12-01T23:02:53.091+00:00",
      "status": "SUCCESS",
      "fileName": "VENDOR-1764630180616.csv",
      "exportId": "{export_id}"
    },
    {
      "entity": "BILL",
      "name": "Export all available fields",
      "processedTime": "2026-11-30T21:55:15.377+00:00",
      "status": "SUCCESS",
      "fileName": "BILL-1761861317355.csv",
      "exportId": "{export_id}"
    }
  ]
}
```

## Get exported record download URL

With `GET /v3/exports/{exportId}/download-link`, you get the download URL for an exported record file. From the response, use `downloadLink` in a GET request to download the file.

```curl
curl '{downloadLink}' --output {file_name}
```

See the <Anchor label="/v3/exports" target="_blank" href="https://developer.bill.com/reference/listexports">/v3/exports</Anchor> API for the complete list of available operations.

<br />