Create expense

POST

/api/v0/partner/expense

Creates an expense for an employee. Send Acting-User-Id, or ekUserId in the body, for that employee.
paymentMode COMPANY_ISSUED_CARD means the company already paid, so the employee is not reimbursed.
paymentMode CASH or PERSONAL_CARD means the employee is reimbursed. Send reimbursementRequired to override that.
paymentIdentifier is your booking id or PNR. Send the same value again and you get the original expense back.
Send invoiceNumber and the GST amounts when you have the invoice.
Call the expense status API to approve it.
At most 5 creates per minute from the same IP.

Request

Header Params

Body Params application/jsonRequired

Example

{
    "ekUserId": "string",
    "expenseDate": "2026-09-15 10:30:00",
    "amount": 0.01,
    "currencyCode": "INR",
    "merchantName": "string",
    "invoiceNumber": "string",
    "paymentIdentifier": "string",
    "reimbursementRequired": true,
    "gstNumber": "string",
    "preTaxAmount": 0,
    "cgstAmount": 0,
    "sgstAmount": 0,
    "igstAmount": 0,
    "hsnCode": "string",
    "category": "string",
    "paymentMode": "FREEDOM_CARD",
    "receiptUrls": [
        "string"
    ],
    "remarks": "string",
    "branchCode": "string",
    "projectId": "string",
    "rosterProjectId": "string",
    "isDraft": true
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://ekpayout-uat.enkash.in/api/v0/partner/expense' \
--header 'Authorization;' \
--header 'Acting-User-Id;' \
--header 'Content-Type: application/json' \
--data '{
    "ekUserId": "string",
    "expenseDate": "2026-09-15 10:30:00",
    "amount": 0.01,
    "currencyCode": "INR",
    "merchantName": "string",
    "invoiceNumber": "string",
    "paymentIdentifier": "string",
    "reimbursementRequired": true,
    "gstNumber": "string",
    "preTaxAmount": 0,
    "cgstAmount": 0,
    "sgstAmount": 0,
    "igstAmount": 0,
    "hsnCode": "string",
    "category": "string",
    "paymentMode": "FREEDOM_CARD",
    "receiptUrls": [
        "string"
    ],
    "remarks": "string",
    "branchCode": "string",
    "projectId": "string",
    "rosterProjectId": "string",
    "isDraft": true
}'

Responses

🟢200

application/json

Expense created.

Bodyapplication/json

Example

{
    "response_code": 0,
    "response_message": "Expense has been successfully created.",
    "payload": {
        "expenseId": "string",
        "expenseDate": "string",
        "amount": 0,
        "merchantName": "string",
        "category": "string",
        "paymentMode": "string",
        "managerApprovalStatus": "PENDING",
        "financeApprovalStatus": "PENDING",
        "settlementStatus": "string",
        "receiptUrls": [
            "string"
        ],
        "remarks": "string",
        "branchCode": "string",
        "employeeId": "string",
        "paymentIdentifier": "string",
        "invoiceNumber": "string",
        "reimbursementRequired": true,
        "policyDeviation": true
    }
}

🟠400

🟠429

Modified at 2026-11-02 19:48:55

Get policy

Update expense fare, tax, invoice, or receipt