Ready to get started with Slash? Get Started →
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>"
}
}
}Submit a new expense report for reimbursement.
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>"
}
}
}Authentication from public API requests
The legal entity ID. Required if authenticating with access to multiple legal entities.
The user ID of the employee submitting the expense report.
The expense amount in cents.
The date of the transaction being reimbursed.
The user's bank account ID for payout.
Merchant reference for the expense.
Show child attributes
ISO currency code (e.g., 'USD').
Description or notes for the expense.
IDs of uploaded receipt documents to attach.
FX rate from expense currency to USD at submission time. Required for non-USD currencies.
When the FX rate was captured.
Reason for not having a receipt. Required when no documentIds are provided.
OK
An expense report with enriched metadata, stripped for public API consumption
Show child attributes