Expense Claims API

Summary

| Method | Path | Purpose | Successful result |

Audience

API consumers, backend and frontend developers, QA, architects, implementation partners, and support.

Reference Content

Method	Path	Purpose	Successful result
GET	/expense/claims	List tenant-scoped claims with optional status and employee-reference filters	Claim collection
GET	/expense/claims/{claimId}	Retrieve one claim including receipt references	Claim representation
POST	/expense/claims	Create a claim immediately in Pending	Created claim
DELETE	/expense/claims/{claimId}	Delete a Pending claim under the implemented ownership rule	Confirmation

Create accepts claimant references, category, positive amount, optional date, bill reference, and description. Currency uses the domain creation default. Lists are recent-first and capped; general pagination is not confirmed. There is no edit, Draft, submit, cancel, or resubmit endpoint.

Source References

• microservices/src/expense-service/Api/ExpenseEndpoints.cs
• microservices/src/expense-service/Application/Dtos.cs

Related Articles

• Expense technical documentation
• Expense business documentation

See Also

• Expense module

Keywords

• Expense API
• Expense Claims

Revision Information

• Status: Draft
• Last reviewed: 2026-07-16
• Review cycle: Quarterly