Skip to main content
POST
/
expense-report
cURL
curl --request POST \
  --url https://api.slash.com/expense-report \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "submittedByUserId": "<string>",
  "amountCents": 123,
  "transactionDate": "2023-11-07T05:31:56Z",
  "destinationId": "<string>",
  "merchant": {
    "type": "merchantV2",
    "id": "<string>"
  },
  "currency": "USD",
  "memo": "<string>",
  "documentIds": [
    "<string>"
  ],
  "fxRateToUsd": "<string>",
  "fxRateUpdatedAt": "2023-11-07T05:31:56Z",
  "noReceiptReason": "<string>"
}
'
{
  "expenseReport": {
    "id": "<string>",
    "legalEntityId": "<string>",
    "submittedByUserId": "<string>",
    "amountCents": 123,
    "currency": "<string>",
    "transactionDate": "2023-11-07T05:31:56Z",
    "destinationId": "<string>",
    "submittedAt": "2023-11-07T05:31:56Z",
    "status": "pending_review",
    "timestamp": "2023-11-07T05:31:56Z",
    "merchant": {
      "type": "merchantV2",
      "merchantV2": {
        "$entity": "merchant_v2",
        "id": "<string>",
        "name": "<string>",
        "isLive": true,
        "isInstantCashback": true,
        "metadata": {
          "timestamp": "2023-11-07T05:31:56Z"
        },
        "heronId": "<string>",
        "iconUrl": "<string>",
        "logoUrl": "<string>",
        "url": "<string>",
        "merchantCategoryId": "<string>"
      }
    },
    "merchantV2Id": "<string>",
    "customMerchantId": "<string>",
    "memo": "<string>",
    "fxRateToUsd": "<string>",
    "fxRateUpdatedAt": "2023-11-07T05:31:56Z",
    "noReceiptReason": "<string>",
    "documents": [
      {
        "document": {
          "$entity": "document",
          "id": "<string>",
          "accountType": "legalEntity",
          "accountId": "<string>",
          "startDate": "<string>",
          "endDate": "<string>",
          "status": "uploaded",
          "accessLevel": "<string>",
          "documentType": "business_entity",
          "category": "document",
          "timestamp": "<string>",
          "filename": "<string>",
          "error": "<string>",
          "checksum": "<string>",
          "tags": [
            "<string>"
          ],
          "documentSource": "uploaded",
          "fileMetadata": {
            "size": 123,
            "type": "<string>"
          }
        },
        "url": "<string>"
      }
    ],
    "aggregatedTransaction": {
      "id": "<string>",
      "date": "<string>",
      "amount": {
        "amount_cents": 123,
        "currency": "USD"
      },
      "status": "pending"
    },
    "destination": {
      "id": "<string>",
      "accountName": "<string>",
      "institution": {
        "id": "<string>",
        "name": "<string>"
      },
      "mask": "<string>",
      "institutionLogo": "<string>"
    },
    "submittedByUser": {
      "id": "<string>",
      "name": {
        "first": "<string>",
        "last": "<string>",
        "full": "<string>"
      }
    },
    "reviewedByUser": {
      "id": "<string>",
      "name": {
        "first": "<string>",
        "last": "<string>",
        "full": "<string>"
      }
    },
    "review": {
      "id": "<string>",
      "expenseReportId": "<string>",
      "decision": "approved",
      "reviewedByUserId": "<string>",
      "reviewedAt": "2023-11-07T05:31:56Z",
      "timestamp": "2023-11-07T05:31:56Z",
      "rejectionReason": "<string>"
    }
  }
}

Authorizations

X-API-Key
string
header
required

Authentication from public API requests

Query Parameters

The legal entity ID. Required if authenticating with access to multiple legal entities.

Body

application/json
submittedByUserId
string
required

The user ID of the employee submitting the expense report.

amountCents
integer
required

The expense amount in cents.

transactionDate
string<date-time>
required

The date of the transaction being reimbursed.

destinationId
string
required

The user's bank account ID for payout.

merchant
object
required

Merchant reference for the expense.

currency
string
default:USD

ISO currency code (e.g., 'USD').

memo
string | null

Description or notes for the expense.

documentIds
string[]

IDs of uploaded receipt documents to attach.

fxRateToUsd
string | null

FX rate from expense currency to USD at submission time. Required for non-USD currencies.

fxRateUpdatedAt
string<date-time> | null

When the FX rate was captured.

noReceiptReason
string | null

Reason for not having a receipt. Required when no documentIds are provided.

Response

OK

expenseReport
PublicExpenseReportWithMetadata · object
required

An expense report with enriched metadata, stripped for public API consumption