Skip to content

Expenses API (0.1)

The Expenses API allows you to manage accounting and expenses information.

Download OpenAPI description
Languages
Servers
Production
https://api.brex.com
Staging (Note: This is not a sandbox. It will not work with customer tokens.)
https://api-staging.brex.com

View and manage card expenses data.

Operations

Upload receipt and match automatically.

Operations
Operations
Operations

Request

The uri will be a pre-signed S3 URL allowing you to upload the receipt securely. This URL can only be used for a PUT operation and expires 30 minutes after its creation. Once your upload is complete, we will try to match the receipt with existing expenses.

Refer to these docs on how to upload to this pre-signed S3 URL. We highly recommend using one of AWS SDKs if they're available for your language to upload these files.

Security
OAuth2
Path
expense_idstringrequired
Bodyapplication/jsonrequired
receipt_namestringrequired

The name of the receipt (with the file extension).

curl -i -X POST \
  'https://api.brex.com/v1/expenses/card/{expense_id}/receipt_upload' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "receipt_name": "string"
  }'

Responses

Upload a new receipt response.

Bodyapplication/json
idstringrequired

The unique identifier for the request.

uristringrequired

The pre-signed S3 link that should be used to upload the file. The maximum size accepted for this document is 50 MB.

Response
application/json
{ "id": "string", "uri": "string" }