Expenses

get_expenses

Get list of expenses for the authenticated user's organization

get_expenses

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_expenses",
    "arguments": {
        "page": 1,
        "limit": 10,
        "search": "string",
        "relations": [
          "string"
        ],
        "employeeId": "550e8400-e29b-41d4-a716-446655440000",
        "categoryId": "550e8400-e29b-41d4-a716-446655440000",
        "projectId": "550e8400-e29b-41d4-a716-446655440000",
        "status": "string",
        "startDate": "string",
        "endDate": "string",
        "currency": "USD"
      }
  }
}

const result = await client.callTool({
  "name": "get_expenses",
  "arguments": {
    "page": 1,
    "limit": 10,
    "search": "string",
    "relations": [
      "string"
    ],
    "employeeId": "550e8400-e29b-41d4-a716-446655440000",
    "categoryId": "550e8400-e29b-41d4-a716-446655440000",
    "projectId": "550e8400-e29b-41d4-a716-446655440000",
    "status": "string",
    "startDate": "string",
    "endDate": "string",
    "currency": "USD"
  }
});

result = await session.call_tool("get_expenses", arguments={
  "page": 1,
  "limit": 10,
  "search": "string",
  "relations": [
    "string"
  ],
  "employeeId": "550e8400-e29b-41d4-a716-446655440000",
  "categoryId": "550e8400-e29b-41d4-a716-446655440000",
  "projectId": "550e8400-e29b-41d4-a716-446655440000",
  "status": "string",
  "startDate": "string",
  "endDate": "string",
  "currency": "USD"
})

Parameters

pagenumber1

Page number for pagination

limitnumber10

Number of items per page

searchstring

Search term for expense notes or purpose

relationsArray<string>

Relations to include (e.g., ["employee", "category", "project", "tags"])

employeeIdstring<uuid>

Filter by employee ID

categoryIdstring<uuid>

Filter by expense category ID

projectIdstring<uuid>

Filter by project ID

statusstring

Filter by expense status

startDatestring

Filter expenses from this date (ISO format)

endDatestring

Filter expenses until this date (ISO format)

currencystringUSDEURGBPJPYCADAUDCHFCNY

Filter by currency

get_expense_count

Get expense count in the authenticated user's organization

get_expense_count

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_expense_count",
    "arguments": {
        "employeeId": "550e8400-e29b-41d4-a716-446655440000",
        "categoryId": "550e8400-e29b-41d4-a716-446655440000",
        "status": "string",
        "startDate": "string",
        "endDate": "string"
      }
  }
}

const result = await client.callTool({
  "name": "get_expense_count",
  "arguments": {
    "employeeId": "550e8400-e29b-41d4-a716-446655440000",
    "categoryId": "550e8400-e29b-41d4-a716-446655440000",
    "status": "string",
    "startDate": "string",
    "endDate": "string"
  }
});

result = await session.call_tool("get_expense_count", arguments={
  "employeeId": "550e8400-e29b-41d4-a716-446655440000",
  "categoryId": "550e8400-e29b-41d4-a716-446655440000",
  "status": "string",
  "startDate": "string",
  "endDate": "string"
})

Parameters

employeeIdstring<uuid>

Filter by employee ID

categoryIdstring<uuid>

Filter by expense category ID

statusstring

Filter by expense status

startDatestring

Filter expenses from this date (ISO format)

endDatestring

Filter expenses until this date (ISO format)

get_expense

Get a specific expense by ID

get_expense

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_expense",
    "arguments": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "relations": [
          "string"
        ]
      }
  }
}

const result = await client.callTool({
  "name": "get_expense",
  "arguments": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "relations": [
      "string"
    ]
  }
});

result = await session.call_tool("get_expense", arguments={
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "relations": [
    "string"
  ]
})

Parameters

idstring<uuid>required

The expense ID

relationsArray<string>

Relations to include (e.g., ["employee", "category", "project", "tags"])

create_expense

Create a new expense in the authenticated user's organization

create_expense

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "create_expense",
    "arguments": {
        "expense_data": {
          "amount": 0,
          "currency": "string"
        }
      }
  }
}

const result = await client.callTool({
  "name": "create_expense",
  "arguments": {
    "expense_data": {
      "amount": 0,
      "currency": "string"
    }
  }
});

result = await session.call_tool("create_expense", arguments={
  "expense_data": {
    "amount": 0,
    "currency": "string"
  }
})

Request Body

{
  "expense_data": {
    "amount": 0,
    "currency": "string"
  }
}

Body

application/json

expense_dataobjectrequired

The data for creating the expense

Show child attributes

amountnumberrequired

The amount (required)

currencystringrequired

The currency (required)

[key: string]any

update_expense

Update an existing expense

update_expense

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "update_expense",
    "arguments": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "expense_data": {}
      }
  }
}

const result = await client.callTool({
  "name": "update_expense",
  "arguments": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "expense_data": {}
  }
});

result = await session.call_tool("update_expense", arguments={
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "expense_data": {}
})

Parameters

idstring<uuid>required

The expense ID

expense_dataobjectrequired

The data for updating the expense

delete_expense

Delete an expense

delete_expense

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "delete_expense",
    "arguments": {
        "id": "550e8400-e29b-41d4-a716-446655440000"
      }
  }
}

const result = await client.callTool({
  "name": "delete_expense",
  "arguments": {
    "id": "550e8400-e29b-41d4-a716-446655440000"
  }
});

result = await session.call_tool("delete_expense", arguments={
  "id": "550e8400-e29b-41d4-a716-446655440000"
})

Parameters

idstring<uuid>required

The expense ID

get_expense_categories

Get list of expense categories for the authenticated user's organization

get_expense_categories

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_expense_categories",
    "arguments": {
        "page": 1,
        "limit": 10,
        "search": "string"
      }
  }
}

const result = await client.callTool({
  "name": "get_expense_categories",
  "arguments": {
    "page": 1,
    "limit": 10,
    "search": "string"
  }
});

result = await session.call_tool("get_expense_categories", arguments={
  "page": 1,
  "limit": 10,
  "search": "string"
})

Parameters

pagenumber1

Page number for pagination

limitnumber10

Number of items per page

searchstring

Search term for category name

get_expenses_by_employee

Get expenses for a specific employee

get_expenses_by_employee

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_expenses_by_employee",
    "arguments": {
        "employeeId": "550e8400-e29b-41d4-a716-446655440000",
        "page": 1,
        "limit": 10,
        "status": "string",
        "startDate": "string",
        "endDate": "string"
      }
  }
}

const result = await client.callTool({
  "name": "get_expenses_by_employee",
  "arguments": {
    "employeeId": "550e8400-e29b-41d4-a716-446655440000",
    "page": 1,
    "limit": 10,
    "status": "string",
    "startDate": "string",
    "endDate": "string"
  }
});

result = await session.call_tool("get_expenses_by_employee", arguments={
  "employeeId": "550e8400-e29b-41d4-a716-446655440000",
  "page": 1,
  "limit": 10,
  "status": "string",
  "startDate": "string",
  "endDate": "string"
})

Parameters

employeeIdstring<uuid>required

The employee ID

pagenumber1

Page number for pagination

limitnumber10

Number of items per page

statusstring

Filter by expense status

startDatestring

Filter expenses from this date (ISO format)

endDatestring

Filter expenses until this date (ISO format)

get_my_expenses

Get expenses for the current authenticated user

get_my_expenses

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_my_expenses",
    "arguments": {
        "page": 1,
        "limit": 10,
        "status": "string",
        "categoryId": "550e8400-e29b-41d4-a716-446655440000",
        "startDate": "string",
        "endDate": "string"
      }
  }
}

const result = await client.callTool({
  "name": "get_my_expenses",
  "arguments": {
    "page": 1,
    "limit": 10,
    "status": "string",
    "categoryId": "550e8400-e29b-41d4-a716-446655440000",
    "startDate": "string",
    "endDate": "string"
  }
});

result = await session.call_tool("get_my_expenses", arguments={
  "page": 1,
  "limit": 10,
  "status": "string",
  "categoryId": "550e8400-e29b-41d4-a716-446655440000",
  "startDate": "string",
  "endDate": "string"
})

Parameters

pagenumber1

Page number for pagination

limitnumber10

Number of items per page

statusstring

Filter by expense status

categoryIdstring<uuid>

Filter by expense category ID

startDatestring

Filter expenses from this date (ISO format)

endDatestring

Filter expenses until this date (ISO format)

Stack Overflow Website Demo