---
title: "Export Expenses"
method: POST
path: "/v1/web/expense/export"
tags: ["Expense"]
---

# Export Expenses

`POST /v1/web/expense/export`

This is a streaming endpoint. BFFs should pipe the stream response back to user's browser.

## Request body

- union
  - object
    - `format` 'csv', required
    - `fields` union[] — columns to include; defaults to all
      - union
        - 'merchantName'
        - 'transactionDate'
        - 'clearedDate'
        - 'amount'
        - 'currency'
        - 'transactionStage'
        - 'mcc'
        - 'cardHolderName'
        - 'status'
        - 'spendCategory'
        - 'memo'
        - 'description'
        - 'accountingDate'
        - 'referenceNumber'
        - 'billable'
        - 'transactionId'
        - 'expenseId'
    - `accountIds` string[]
    - `cardIds` string[]
    - `userIds` string[]
    - `transactionIds` string[]
    - `transactionStages` union[] — defaults to settled
      - union
        - 'authorization'
        - 'settled'
    - `statuses` union[]
      - union
        - 'draft'
        - 'submitted'
        - 'approved'
        - 'returned'
        - 'deleted'
    - `spendCategoryIds` string[]
    - `hasPolicyViolations` boolean
    - `merchantNameLike` string
    - `cardHolderNameLike` string
    - `transactionDateStart` string, date-time
    - `transactionDateEnd` string, date-time
    - `amountMin` string
    - `amountMax` string
  - object
    - `format` 'ofxV1', required
    - `accountIds` string[]
    - `cardIds` string[]
    - `userIds` string[]
    - `transactionIds` string[]
    - `transactionStages` union[] — defaults to settled
      - union
        - 'authorization'
        - 'settled'
    - `statuses` union[]
      - union
        - 'draft'
        - 'submitted'
        - 'approved'
        - 'returned'
        - 'deleted'
    - `spendCategoryIds` string[]
    - `hasPolicyViolations` boolean
    - `merchantNameLike` string
    - `cardHolderNameLike` string
    - `transactionDateStart` string, date-time
    - `transactionDateEnd` string, date-time
    - `amountMin` string
    - `amountMax` string

## Response `200`

text/csv for format=csv; application/x-ofx for format=ofxV1

- string — text/csv for format=csv; application/x-ofx for format=ofxV1

## Other responses

- `400` — Default Response
- `401` — The access to this resource has been denied
- `403` — The access to this resource is forbidden
- `default` — Catch-all error response for any unexpected internal errors

---

[API](https://skmtc.net/funneldash/apis/surface-web-api.md) · [All operations](https://skmtc.net/funneldash/apis/surface-web-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/funneldash/surface-web-api/revisions/ac700d65f443/schema)