EnKash Developer Portal
Home
Home
Login
  1. APIs - Expense
  • Explore Our Product Suite
  • Payment Gateway
    • Set Up Payment Gateway
    • Payment Options
    • Easy API Setup
    • APIs - Payment Gateway
  • Payouts
    • Set Up Payouts
    • APIs - Payout
  • Prepaid Cards
    • Key Capabilities
    • Set Up Prepaid Cards
    • KYC Status Handling Guide
    • T&C Acceptance Flow
    • Card Design & Branding Compliance Guide
    • APIs - Prepaid Card
  • Wallet
    • APIs - Wallet
  • Bharat Connect (BBPS)
    • APIs - BBPS
  • Accounts Payable
    • APIs - Accounts Payable
  • Account Receivable
    • Accounts Receivable Overview
    • APIs - Account Receivable
  • Expense ERP Integration
    • About Authorization
    • APIs - Expense
    • Partner Integration
    • APIs - Expense
      • Update user
        PATCH
      • Create user
        POST
      • List employees
        GET
      • Get employee
        GET
      • Create department
        POST
      • List departments
        GET
      • Get department
        GET
      • Update department
        PATCH
      • Create grade
        POST
      • List grades
        GET
      • Get grade
        GET
      • Create designation
        POST
      • List designations
        GET
      • Get designation
        GET
      • List designations in a department
        GET
      • List categories
        GET
      • Get category
        GET
      • Create expense policy
        POST
      • List policies
        GET
      • Get policy
        GET
      • Create expense
        POST
      • Update expense fare, tax, invoice, or receipt
        PATCH
      • Cancel an expense and keep the record
        POST
      • Get expense
        GET
      • Approve, reject, or hold expense
        POST
      • Receipt OCR
        POST
      • Update grade
        PATCH
      • Update grade status
        PATCH
      • Update designation status
        PATCH
      • Update designation
        PATCH
      • Update department status
        PATCH
      • Update policy status
        PATCH
      • Update policy
        PATCH
  • Rewards & Incentives
    • About Rewards
    • Getting Started
    • Encryption & Decryption Guide
    • Reward Allocation
    • Incentive Allocation
    • APIs - Reward
  • Petty Cash
    • Request Encryption Using AES
    • API - Petty Cash
  • Verification Suite
    • Verification Suite Overview
    • APIs - Verification Suite
    • Create expense category
  • Schemas
    • CardExpenseSuccessResponse
    • OcrDataSuccessResponse
    • PartnerDesignationUpdateRequest
    • AttachReceiptSuccessResponse
    • PartnerGradeUpdateRequest
    • PartnerPolicy
    • PartnerUserUpdateRequest
    • PartnerPolicySuccessResponse
    • ExpenseSearchRequest
    • PartnerUser
    • PartnerDesignation
    • ExpenseSearchItem
    • PartnerPolicyUpdateRequest
    • PartnerGrade
    • ExpenseSearchResponse
    • PartnerUserRequest
    • PartnerUserListResponse
    • PartnerDepartmentCreateRequest
    • PartnerDesignationSuccessResponse
    • PartnerDepartment
    • PartnerGradeSuccessResponse
    • PartnerUserSuccessResponse
    • PartnerDepartmentSuccessResponse
    • PartnerDepartmentListResponse
    • EmptySuccessResponse
    • ErrorResponse
    • PartnerGradeCreateRequest
    • PartnerCodeName
    • PartnerGradeListResponse
    • PartnerDesignationCreateRequest
    • PartnerDesignationListResponse
    • PartnerCategoryCreateRequest
    • PartnerCategory
    • PartnerCategorySuccessResponse
    • PartnerCategoryListResponse
    • PartnerPolicyCreateRequest
    • PartnerPolicyListResponse
    • PartnerExpenseCreateRequest
    • PartnerExpense
    • PartnerExpenseUpdateRequest
    • PartnerExpenseCancelRequest
    • PartnerExpenseSuccessResponse
    • PartnerExpenseStatusRequest
    • PartnerExpenseStatusItem
    • PartnerExpenseStatusResponse
    • ExpenseHistoryItem
    • ExpensePaymentMode
    • ExpensePayload
    • AccountType
    • TripRequestSuccessResponse
    • TripRequestCreateRequest
    • TripRequestPayload
    • FlightEntries
    • FlightSegment
    • BusAndTrainEntry
    • CarRentalEntry
    • HotelEntry
    • AdvanceCreateRequest
    • TripRequestHistoryItem
    • TripType
    • RequestFormStatus
  1. APIs - Expense

Update policy

PATCH
/api/v0/partner/policy/{policyId}
Updates an expense policy in your company. Send only the fields to change. Fields that are left out or null keep their current value.
category is a category id in your company. departmentCodes, employeeGradeFrom and employeeGradeTo are codes in your company.
departmentCodes, when sent, replaces the policy's current departments. category, when sent, replaces the policy's current categories.
Other policy settings that cannot be sent through this API are kept unchanged.
An EXPIRED policy cannot be updated. The name must be unique in your company and is saved in upper case.
When the resulting policy has status=CREATED, it must have a policyFrequency, the amount for that frequency, at least one department, a grade range, and either both fromDate and toDate or neither.

Request

Path Params

Header Params

Body Params application/jsonRequired

Example
{
    "perMonthAmount": 9000,
    "submissionPolicyDays": 30
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PATCH 'https://ekpayout-uat.enkash.in/api/v0/partner/policy/' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data '{
    "perMonthAmount": 9000,
    "submissionPolicyDays": 30
}'

Responses

🟢200
application/json
Policy updated.
Bodyapplication/json

Example
{
    "response_code": 0,
    "response_message": "SUCCESS",
    "payload": {
        "policyId": "POL001",
        "policyName": "FOOD LIMIT",
        "status": "CREATED",
        "categoryId": "CAT001",
        "categoryName": "Food",
        "departmentCodes": [
            "DEPT001"
        ],
        "employeeGradeFrom": "GRADE001",
        "employeeGradeTo": "GRADE003",
        "policyFrequency": "PER_EXPENSE",
        "perExpenseAmount": 1500,
        "perMonthAmount": null,
        "perMonthCount": null,
        "submissionPolicyDays": 30,
        "fromDate": null,
        "toDate": null,
        "allowedForFuelRequest": false
    }
}
đźź 400
đźź 401
đź”´500
Modified at 2026-11-16 07:19:19
Previous
Update policy status
Next
About Rewards
Built with