Skip to main content
PATCH
/
expense-report
/
{expenseReportId}
cURL
curl --request PATCH \
  --url https://api.slash.com/expense-report/{expenseReportId} \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "updatedByUserId": "<string>",
  "amountCents": 123,
  "currency": "<string>",
  "transactionDate": "2023-11-07T05:31:56Z",
  "memo": "<string>",
  "destinationId": "<string>",
  "documentIds": [
    "<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",
    "timestamp": "2023-11-07T05:31:56Z",
    "merchant": {
      "merchantV2": {
        "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": {
          "id": "<string>",
          "accountId": "<string>",
          "startDate": "<string>",
          "endDate": "<string>",
          "accessLevel": "<string>",
          "timestamp": "<string>",
          "filename": "<string>",
          "error": "<string>",
          "checksum": "<string>",
          "tags": [
            "<string>"
          ],
          "fileMetadata": {
            "size": 123,
            "type": "<string>"
          }
        },
        "url": "<string>"
      }
    ],
    "aggregatedTransaction": {
      "id": "<string>",
      "date": "<string>",
      "amount": {
        "amount_cents": 123
      }
    },
    "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>",
      "reviewedByUserId": "<string>",
      "reviewedAt": "2023-11-07T05:31:56Z",
      "timestamp": "2023-11-07T05:31:56Z",
      "rejectionReason": "<string>"
    }
  }
}

Authorizations

X-API-Key
string
header
required

API key authentication for public API requests.

Keys come in two flavors:

  • Legal-entity-scoped keys are pinned to a single legal entity. Minted via the dashboard under a specific entity; every request acts on that entity.
  • User-scoped keys are pinned to a user and span every legal entity that user has access to. Every request made with a user-scoped key (except GET /legal-entity, which lists the legal entities the user can access) must include an x-legal-entity header naming the legal entity the request is operating on. Requests without the header are rejected with 400. The authenticated user must have an active permission role on the supplied legal entity, otherwise the request is rejected with 403.

Path Parameters

expenseReportId
string
required

Body

application/json
updatedByUserId
string
required

The user ID of the person performing the update.

amountCents
integer

The expense amount in cents.

currency
string

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

transactionDate
string<date-time>

The date of the transaction being reimbursed.

memo
string | null

Description or notes for the expense.

destinationId
string

The user's bank account ID for payout.

documentIds
string[]

IDs of uploaded receipt documents to attach.

merchant
object

Merchant reference for the expense.

status
enum<string>

Set to cancelled to cancel the expense report.

Available options:
cancelled

Response

OK

expenseReport
PublicExpenseReportWithMetadata · object
required

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