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
      • 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
  • 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
    • AttachReceiptSuccessResponse
    • ErrorResponse
    • ExpenseSearchRequest
    • PartnerUser
    • ExpenseSearchItem
    • PartnerUserSuccessResponse
    • ExpenseSearchResponse
    • PartnerUserRequest
    • PartnerUserListResponse
    • PartnerDepartmentCreateRequest
    • PartnerDepartment
    • PartnerDepartmentSuccessResponse
    • PartnerDepartmentListResponse
    • PartnerGradeCreateRequest
    • PartnerCodeName
    • PartnerGrade
    • PartnerGradeSuccessResponse
    • PartnerGradeListResponse
    • PartnerDesignationCreateRequest
    • PartnerDesignation
    • PartnerDesignationSuccessResponse
    • PartnerDesignationListResponse
    • PartnerCategoryCreateRequest
    • PartnerCategory
    • PartnerCategorySuccessResponse
    • PartnerCategoryListResponse
    • PartnerPolicyCreateRequest
    • PartnerPolicy
    • PartnerPolicySuccessResponse
    • 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

Create expense policy

POST
/api/v0/partner/policy
Adds the approval rules for expenses. Create the department, grade, designation, and category first, then create the policy.
The person calling this API must already be an employee in the company.

Request

Header Params

Body Params application/jsonRequired

Example
{
    "policyName": "string",
    "category": "string",
    "status": "DRAFTED",
    "departmentCodes": [
        "string"
    ],
    "employeeGradeFrom": "string",
    "employeeGradeTo": "string",
    "policyFrequency": "PER_EXPENSE",
    "perExpenseAmount": 0,
    "perMonthAmount": 0,
    "perMonthCount": 0,
    "submissionPolicyDays": 0,
    "fromDate": "2019-08-24",
    "toDate": "2019-08-24",
    "allowedForFuelRequest": true
}

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 'https://ekpayout-uat.enkash.in/api/v0/partner/policy' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data '{
    "policyName": "string",
    "category": "string",
    "status": "DRAFTED",
    "departmentCodes": [
        "string"
    ],
    "employeeGradeFrom": "string",
    "employeeGradeTo": "string",
    "policyFrequency": "PER_EXPENSE",
    "perExpenseAmount": 0,
    "perMonthAmount": 0,
    "perMonthCount": 0,
    "submissionPolicyDays": 0,
    "fromDate": "2019-08-24",
    "toDate": "2019-08-24",
    "allowedForFuelRequest": true
}'

Responses

🟢200
application/json
Policy created.
Bodyapplication/json

Example
{
    "response_code": 0,
    "response_message": "string",
    "payload": {
        "policyId": "string",
        "policyName": "string",
        "status": "string",
        "categoryId": "string",
        "categoryName": "string",
        "departmentCodes": [
            "string"
        ],
        "employeeGradeFrom": "string",
        "employeeGradeTo": "string",
        "policyFrequency": "string",
        "perExpenseAmount": 0,
        "perMonthAmount": 0,
        "perMonthCount": 0,
        "submissionPolicyDays": 0,
        "fromDate": "2019-08-24",
        "toDate": "2019-08-24",
        "allowedForFuelRequest": true
    }
}
Modified at 2026-11-02 19:48:55
Previous
Get category
Next
List policies
Built with