Get Expense

GET/users/{user_id}/expenses/{expense_id}

Retrieves a single expense with full detail including adjudication, enrichment, merchant, and origin data.

Path Parameters

user_idstringrequired

The Sail user id.

expense_idstringrequired

The Sail expense id.

Response

Expense details.

idstring

The Sail expense id.

connection_idstring

The connection this expense was sourced from.

external_transaction_idstring

Echo of the customer-supplied id for expenses ingested through an external connection; null for Sail-sourced expenses. Join key back to the customer’s own transaction store.

namestring

The expense’s display name.

descriptionstring

Human-readable description of the expense.

datestring<date>

The transaction date.

amountnumber<float>

USD.

status"eligible" | "needs_review" | "ineligible" | "reimbursed" | "archived"

The expense’s current workflow status.

source_type"card" | "store" | "receipt_upload" | "external"

How this expense entered Sail; pairs with the source_type list filter.

originobject

What the expense was derived from.

Show origin properties

type"transaction" | "product"

transaction — derived from a bank/credit-card transaction (one expense per transaction, split via parent_expense_id after itemization). product — derived from an individual product line (store order data or an itemized receipt).

detailstring

The raw descriptor (transactions) or product title (products) the expense was derived from.

merchantobject

The merchant this expense was incurred at, as resolved by enrichment. supported_merchant_id references the /merchants directory only when the merchant is one Sail can connect to for store data; it is null for the long tail of merchants that are recognized but not scrape-supported.

Show merchant properties

namestring

The merchant’s display name.

logo_urlstring

URL of the merchant’s logo. Null if unavailable.

supported_merchant_idstring

The /merchants directory id, when Sail can connect to this merchant for store data. Null otherwise.

enrichmentobject

General transaction enrichment, independent of Section 213(d) adjudication.

Show enrichment properties

categorystring

General spend category.

subcategorystring

More granular spend subcategory, when available.

mccstring

Merchant category code, when derived from a card transaction or supplied at ingest.

parent_expense_idstring

Set when this expense is a line item split from another expense (e.g. itemization of a mixed-basket transaction after receipt review); null for top-level expenses.

section_213d_classificationobject

Section 213(d) eligibility adjudication. The review states pair with origin.type: lmn_required applies to product-origin expenses (a dual-purpose item that becomes eligible with a Letter of Medical Necessity); itemization_required applies to transaction-origin expenses (a mixed basket that needs an itemized receipt before line items can be adjudicated). Both surface as needs_review in the top-level workflow status.

Show section_213d_classification properties

status"eligible" | "lmn_required" | "itemization_required" | "ineligible"

The Section 213(d) review outcome.

categorystring

Section 213(d) category.

reasoningstring

Human-readable explanation for the classification. Null if not available.

created_atstring<date-time>

When the expense was created.

updated_atstring<date-time>

When the expense was last updated.

Standard error envelope covering 400, 401, 403, 404, 429, and 500.

errorobject

The error detail.

Show error properties

codestring

Machine-readable code, e.g. not_found, token_scope_mismatch, product_not_enabled, insufficient_key_scope, insufficient_token_scope, user_token_required, user_token_expired, invalid_user_token, invalid_key_configuration, connection_not_reconnectable, rate_limited.

messagestring

Human-readable error message. May change, so match on error.code instead.

paramstring

The request field that caused the error, when applicable. Null otherwise.

const response = await fetch(`https://live.savewithsail.com/api/v1/users/${user_id}/expenses/${expense_id}`, { method: 'GET', headers: { 'Authorization': 'Bearer <token>' } }); const data = await response.json();

import requests response = requests.request( "GET", "https://live.savewithsail.com/api/v1/users/{user_id}/expenses/{expense_id}", headers={ "Authorization": "Bearer <token>" }, ) data = response.json()

<?php $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, "https://live.savewithsail.com/api/v1/users/<user_id>/expenses/<expense_id>"); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET"); curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer <token>"]); $response = curl_exec($ch); curl_close($ch);

package main import ( "fmt" "io" "net/http" ) func main() { req, _ := http.NewRequest("GET", "https://live.savewithsail.com/api/v1/users/<user_id>/expenses/<expense_id>", nil) req.Header.Set("Authorization", "Bearer <token>") resp, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer resp.Body.Close() data, _ := io.ReadAll(resp.Body) fmt.Println(string(data)) }

HttpClient client = HttpClient.newHttpClient(); HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://live.savewithsail.com/api/v1/users/<user_id>/expenses/<expense_id>")) .header("Authorization", "Bearer <token>") .method("GET", HttpRequest.BodyPublishers.noBody()) .build(); HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body());

require "net/http" require "uri" uri = URI("https://live.savewithsail.com/api/v1/users/<user_id>/expenses/<expense_id>") http = Net::HTTP.new(uri.host, uri.port) http.use_ssl = uri.scheme == "https" request = Net::HTTP::Get.new(uri) request["Authorization"] = "Bearer <token>" response = http.request(request) puts response.body

{ "id": "string", "connection_id": "string", "external_transaction_id": "string", "name": "string", "description": "string", "date": "2024-01-01", "amount": 0, "status": "eligible", "source_type": "card", "origin": { "type": "transaction", "detail": "string" }, "merchant": { "name": "Costco", "logo_url": "string", "supported_merchant_id": "mer_costco" }, "enrichment": { "category": "Pharmacies", "subcategory": "Drug Stores", "mcc": "string" }, "parent_expense_id": "string", "section_213d_classification": { "status": "eligible", "category": "Health Monitoring Devices", "reasoning": "string" }, "created_at": "1970-01-01T00:00:00.000Z", "updated_at": "1970-01-01T00:00:00.000Z" }