Sign in
latestOpenAPI 3.0.1Proprietary2026-08-1844131294.9 KB

59cd6443fdbf

expenses

Retrieve detailed expense information

Get comprehensive details about a specific expense claim by its unique identifier.

This endpoint provides complete expense information including:

  • All expense line items with receipts
  • Approval status and workflow information
  • Available actions based on current state
  • Complete audit trail with timestamps

Use this endpoint when you need full details about an expense, including receipt links and approval information that are not included in the list endpoint.

get/v1/expenses/{expenseId}

Path parameters

expenseIdstring uuid required

Unique identifier of the expense

Response

Expense details retrieved successfully

expenseIdstring uuid required

Unique identifier for the expense

titlestring required

Expense title or description

status'DRAFT' | 'REVOKED' | 'APPROVAL_IN_PROGRESS' | 'APPROVED' | 'REJECTED' | 'PROCESSING' | 'PAID' | 'TO_BE_PAID' | 'ON_HOLD' | 'UNKNOWN' required

Current status of the expense

totalAmountnumber float required

Total expense amount

currencystring required

Currency code (ISO 4217)

submittedAtstring date-time

When the expense was submitted for approval

createdOnstring date-time

When the expense was created

updatedOnstring date-time

When the expense was last updated

employeeIdstring uuid

Employee unique identifier. Use GET /v1/employees/{employeeId} for full employee details

Example response

{
  "expenseId": "550e8400-e29b-41d4-a716-446655440000",
  "title": "Business Travel - Singapore",
  "status": "APPROVED",
  "totalAmount": 1250.5,
  "currency": "USD",
  "submittedAt": "2025-10-15T10:30:00Z",
  "createdOn": "2025-10-14T08:00:00Z",
  "updatedOn": "2025-10-16T14:20:00Z",
  "employeeId": "123e4567-e89b-12d3-a456-426614174000",
  "items": [
    {
      "itemId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "title": "Flight Ticket",
      "amount": 850,
      "date": "2025-10-10T00:00:00Z",
      "category": {
        "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
        "name": "Travel"
      },
      "description": "Round trip flight to Singapore",
      "receipts": [
        {
          "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
          "name": "flight-ticket.pdf",
          "link": "https://storage.example.com/receipts/flight-ticket.pdf"
        }
      ]
    }
  ]
}