Export BILL records

With GET /v3/exports, you can get a list of exported BILL records available for you to download. See /v3/exports 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.

{
  "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 '{downloadLink}' --output {file_name}

See the /v3/exports API for the complete list of available operations.