Enkash APIs
HomePayment GatewayPayoutsCreate Account
HomePayment GatewayPayoutsCreate Account
Login
  1. Vendor Management
  • EnKash Developer Portal Overview
  • Payment Gateway
    • Payment Gateway Overview
    • Payment Gateway Sign Up
    • Payment Methods
    • Supported Integrations
    • Payment Gateway APIs
    • Web Integration
    • Server to Server Integration
    • Test Card Details
    • Authorization
      • About Authorization
      • Get Authorization Token
    • Orders
      • About Order
      • Create Order
      • Get Order Status
      • Get Order By Merchant Order Id
      • Get BNPL Payment Modes
      • Get Dynamic QR Code
      • UPI Intent Links
    • Payments
      • About Payment
      • Submit Payment Detail
      • Get Transaction Status
      • Validate OTP
      • Resend OTP
      • Payment Notify Request
      • Get UPI Transaction Status
      • Verify VPA
    • Refunds
      • About Refund
      • Refund
    • Settlements
      • About Settlement
      • Settlement Reporting
      • Get Settlement Payout By ID
      • Search Settlement Payouts
    • Split Settlements
      • About Split Settlements
      • Create Split Settlement Account
      • Update Split Settlement Account
      • Get All Split Settlement Account
      • Deactivate Split Settlement Account
      • Activate Split Settlement Account
      • Submit Payment with Split Details
      • Edit/Deferred Split Settlement
    • E-Commerce Plugins
    • Payment Links
    • Payment Button
    • Qr Code
      • Create Qr Code
      • Get QR Code
      • Search QR Code
      • createCustomer
      • searchCustomer
      • Cancel QR Code
    • UPI Mandate
      • Create UPI Mandate
      • Update UPI Mandate
      • Revoke UPI Mandate
      • Get UPI Mandate
      • UPI mandate create callback
      • Mandate Pre-debit Notification
      • Execute mandate debit
      • Mandate Debit callback
  • Payment Links
    • Payment Links Overview
    • Payment Link APIs
    • Payment Link
      • Create Payment Link
      • Get Payment Link Details
      • Delete Payment Link
    • Payment Link Webhook
      • Payment Link Webhook Request
  • Bharat Connect (BBPS)
    • About Bharat Connect
    • B2B Invoicing
      • Invoice
        • Create Invoice
        • Confirm Invoice
        • Status Change Invoice
        • Edit Invoice
      • Payment
        • Pay Invoices
        • Payment Confirmation
      • Financing
        • Request Financing
        • Share Bid
        • Respond Bid
      • Onboarding
        • Register Check Entity
        • Search Entity
        • Register Entity
        • Registration Id
      • cdNote
        • Send CdNote Request
        • Confirm CdNote Request
        • Status Change CdNote Request
      • Purchase Order
        • Send Purchase Order Request
        • Confirm Purchase Order Request
        • Edit Purchase Order Request
        • Status Change Purchase Order Request
      • webhook-invoice
        • Webhook Create Invoice Request
        • Webhook Create Invoice Response
        • Webhook Confirm Invoice Request
        • Webhook Confirm Invoice Response
        • Webhook Status Change Invoice Request
        • Webhook Status Change Invoice Response
        • Webhook Edit Invoice Request
        • Webhook Edit Invoice Response
      • webhook-payments
        • Webhook Payment Request
        • Webhook Payment Confirmation Request
        • Webhook Payment Response
        • Webhook Payment Confirmation Response
      • webhook-business-onboarding
        • Webhook Check Entity Response
        • Webhook Register Entity Response
        • Webhook Search Entity Response
        • Webhook Registration Id Response
      • webhook-financing
        • Webhook Financing Response
        • Webhook Respond Bid Response
        • Webhook Share Bid Request
      • webhook-cdNote
        • Webhook Send CdNote Request
        • Webhook Send CdNote Response
        • Webhook Confirm CdNote Request
        • Webhook Confirm CdNote Response
        • Webhook Status Change CdNote Request
        • Webhook Status Change CdNote Response
      • Webhook Purchase Order
        • Webhook Send Purchase Order Request
        • Webhook Send Purchase Order Response
        • Webhook Confirm Purchase Order Request
        • Webhook Confirm Purchase Order Response
        • Webhook Edit Purchase Order Request
        • Webhook Edit Purchase Order Response
        • Webhook Status Change Purchase Order Request
        • Webhook Status Change Purchase Order Response
    • Bill Payments
      • Bill Payments Overview
      • Get Authentication Token
      • Get BillerTypes
      • Get Billers
      • Fetch Bill
      • Create Bill API
      • Create Bill Without Bill Fetch
      • Bill Payment
      • Utility Bill Approval API
      • Get Utility Bill Status
      • Get Utility Bill by Reference Id
      • Get Utility Bills Detail
      • Bill Payment Webhook
  • Payouts
    • Payouts Overview
    • Payouts Sign Up
    • Payout Methods
    • Payout API Response Codes
    • Payouts Integration Steps
    • Encrypting and Decrypting Payload
    • Payouts Status Codes
    • Get Authentication Token
      • Get Authentication Token
    • Beneficiary Apis
      • Create Beneficiary
      • Search Beneficiary
      • Delete Beneficiary
    • Transfer Apis
      • Create Payout
      • Search Payouts
      • Create Batch Payout
    • Payout Account Apis
      • Get Balance
      • Get Source Bank Account Details
      • Add Source Bank Account
      • Fetch Bank Statement
    • Webhook Data Apis
      • Get Webhook Data
      • Create Webhook Data
  • Accounts Payable Management Tool
    • About AP Management Tool
    • Vendor Management
      • Create Vendor
        POST
      • Create Bulk Vendors
        POST
      • Update Bulk Vendors
        PUT
      • Get Beneficiaries (V1)
        POST
      • Get Beneficiaries
        POST
      • Change Vendor Status
        PATCH
      • Get Beneficiary
        GET
    • Invoice Management
      • Payout Apis
        • validateInvoices
        • initiate
        • Search Payouts V1
        • bulkCreatePayout
        • Create Payout
        • Update Payouts
        • Search Payouts
        • createBulkPayoutForPartnerIntegration
        • Update Bulk Payouts
        • Update Approval Status
        • Get Invoice Data
        • Delete Payout
    • Bharat Connect 2.0 AP
      • Confirm Invoice Request
      • Payment Request
    • Update Beneficiary
      PUT
  • Account Receivable
    • Accounts Receivable Overview
    • Get Authentication Token Copy
      • Get Authentication Token
    • Customer Management
      • Customer Apis
        • Activate customer
        • createBulkCustomer
        • bulkUpdate
        • Deactivate customer
        • deleteCustomerByCustomerId
        • updateCustomer
    • Customer Contacts Management
      • Customer Apis
        • getCustomerContactDetails
    • Invoice Management
      • invoice-controller
        • createInvoice
        • invoiceBulkUpload
        • Dispatch Invoice Collection
        • Delete Invoice Collection
        • searchCollectionInvoices
        • getInvoice
        • updateInvoice
    • Payment Reminders
      • customer-reminder-controller
        • createCustomerReminder
        • getCustomerReminders
        • getCustomerReminder
        • deleteReminder
        • updateCustomerReminder
    • Bharat Connect 2.0 AR
      • Payment Confirmation Request
      • Change Invoice Status Request
      • Bulk Create Invoice
  • Expense Management
    • Expense Management Overview
    • Sign Up - Expense Management
    • Token Api
      • About Authorization
      • Token API
    • Expenses
    • Advance
  • Loyalty
    • Overview
    • Sign Up
    • Employee R&R
      • API Integration Guide
      • Common Fields passed in API requests
      • Token Api
        • Client Authentication
        • SSO LOGIN (Single Sign On)
      • Create And Allocate point
      • Bulk Create And Allocate Points
      • Get Card Account Details
      • Get Transaction details
      • List Users Details
      • Get User Card Details
    • Channel Incentives
      • Incentive Create And Allocate point
      • Reward Get Transaction details
      • Incentive Get User Details
    • Points Redemption
      • User Authentication
      • Get Cart for User
      • Search Catalog
      • Get Product Catalog Details
      • Get Product Configs (Denominations)
      • Add to cart
      • Update Cart
      • Create Order
      • Order Search
      • create order
      • Fetch Order Info by Partner order Reference id
    • Point Management APIs
      • Overview
      • Create Event
      • Get Event
      • Update Event
      • Allocate Coins
      • Get Balance
  • Card Management
    • EnKash Card Management Systems Overview
    • Cards We Issue
    • API Reference
    • VKYC
    • Developer Guide
    • Cards Integration Steps
    • Encryption / Decryption of API requests / Response
    • Encryption & Decryption Guide
    • Token Api
      • Partner auth Token
    • Gift Card
      • Create
      • Request Physical
      • Block
      • Replace
      • Get User Details
      • Get Transaction Details
      • Get All Transaction details
    • Meal Cards
      • Create
      • Load Balance
      • Replace
      • Block
      • Request Physical
      • Get User Card Details
      • Get Transaction Details
      • Get All Transaction details
    • Prepaid Cards
      • Create
      • Load Balance
      • Replace
      • Block
      • Request Physical
      • Get User Card Details
      • Get Transaction Details
      • Get All Transaction details
    • Fuel_cards
      • Create
      • Load Balance
      • Replace
      • Block
      • Physical
      • Get User Card Details
      • Get Transaction Details
      • Get All Transaction details
    • Advance Card Feature
      • Create Card Account
      • Set Pin
      • Get Card Account Details
      • Generate Otp Card
      • View Card
      • Update Card Velocity Rules
      • Get Card Velocity Rules
  • Verification Suite
    • Verification Suite Overview
    • Bank Account Verification
      • Bank Account Verification PennyLess/PennyDrop
    • GSTN Verification
      • Gstin Verification
    • PAN Verification
      • Pan Verification
    • UPI(VPA) Verification
      • Vpa Verification
  1. Vendor Management

Get Beneficiaries (V1)

POST
/api/v1/beneficiary/search
Beneficiary Apis

Request

Body Params application/json
companyIds
array[string]
optional
parentIds
array[integer <int64>]
optional
offset
integer <int32>
optional
limit
integer <int32>
optional
<= 5000
panOrGstin
string 
optional
companyBranchCodeIds
array[integer <int64>]
optional
panStatus
enum<string> 
optional
Allowed values:
UNVERIFIEDVERIFIEDNEFT_CALL_MADEFAILEDIMPS_CALL_MADEIN_PROCESSPARSING_FAILINVALIDAWAITING_WEBHOOK
gstinStatus
enum<string> 
optional
Allowed values:
UNVERIFIEDVERIFIEDNEFT_CALL_MADEFAILEDIMPS_CALL_MADEIN_PROCESSPARSING_FAILINVALIDAWAITING_WEBHOOK
cinStatus
enum<string> 
optional
Allowed values:
UNVERIFIEDVERIFIEDNEFT_CALL_MADEFAILEDIMPS_CALL_MADEIN_PROCESSPARSING_FAILINVALIDAWAITING_WEBHOOK
businessTypes
array[string]
optional
Allowed values:
ENTERPRISECREDIT_PROVIDERVENDORSOCIETYAGENCY
bankVerifiedStatus
enum<string> 
optional
Allowed values:
UNVERIFIEDVERIFIEDNEFT_CALL_MADEFAILEDIMPS_CALL_MADEIN_PROCESSPARSING_FAILINVALIDAWAITING_WEBHOOK
companyOnBoardType
enum<string> 
optional
Allowed values:
CUSTOMERBENEFICIARY
branchCodes
array[string]
optional
branchNames
array[string]
optional
costCentres
array[string]
optional
branchCities
array[string]
optional
branchStates
array[string]
optional
utmSource
string 
optional
userGroupIds
array[string]
optional
isMsme
boolean 
optional
companyIdOrLegalName
string 
optional
direction
enum<string> 
optional
Allowed values:
ASCDESC
bankApproval
enum<string> 
optional
Allowed values:
KOTAK_APPROVEDICICI_BANK_APPROVEDENKASH_D2I_APPROVEDAMEX_D2I_APPROVEDKOTAK_REJECTEDICICI_BANK_REJECTEDENKASH_D2I_REJECTEDAMEX_D2I_REJECTED
bankApprovalStatus
enum<string> 
optional
Allowed values:
APPROVEDPENDINGREJECTED
kycFailureReason
enum<string> 
optional
Allowed values:
PAN_GSTIN_BANK_MISSINGPAN_GSTIN_MISSINGBANK_MISSINGPAN_GSTIN_BANK_NOT_VERIFIEDPAN_GSTIN_NOT_VERIFIEDBANK_NOT_VERIFIEDPAN_GSTIN_BANK_NOT_MATCHKYC_NOT_APPROVEDNAME_MATCHING_FAILEDAPPROVED
companyParentChildRelationIds
array[string]
optional
company_id
string 
optional
parent_id
string 
optional
child_id
string 
optional
business_type
enum<string> 
optional
Allowed values:
ENTERPRISECREDIT_PROVIDERVENDORSOCIETYAGENCY
company_type
string 
optional
tax_id_1
string 
optional
tax_id_2
string 
optional
cin
string 
optional
din
string 
optional
external_ref_no
string 
optional
risk_approval_status
enum<string> 
optional
Allowed values:
APPROVEDPENDINGIN_PROGRESSBULK_UPLOADNEW
status
enum<string> 
optional
Allowed values:
ACTIVEINACTIVEBLOCKEDLOCKED
created_date_from
string <date-time>
optional
created_date_to
string <date-time>
optional
date_approved
string <date-time>
optional
email
string 
optional
legal_name
string 
optional
branch_code
string 
optional
order_by
string 
optional
Example
{
  "companyIds": [
    "string"
  ],
  "parentIds": [
    0
  ],
  "offset": 0,
  "limit": 5000,
  "panOrGstin": "string",
  "companyBranchCodeIds": [
    0
  ],
  "panStatus": "UNVERIFIED",
  "gstinStatus": "UNVERIFIED",
  "cinStatus": "UNVERIFIED",
  "businessTypes": [
    "ENTERPRISE"
  ],
  "bankVerifiedStatus": "UNVERIFIED",
  "companyOnBoardType": "CUSTOMER",
  "branchCodes": [
    "string"
  ],
  "branchNames": [
    "string"
  ],
  "costCentres": [
    "string"
  ],
  "branchCities": [
    "string"
  ],
  "branchStates": [
    "string"
  ],
  "utmSource": "string",
  "userGroupIds": [
    "string"
  ],
  "isMsme": true,
  "companyIdOrLegalName": "string",
  "direction": "ASC",
  "bankApproval": "KOTAK_APPROVED",
  "bankApprovalStatus": "APPROVED",
  "kycFailureReason": "PAN_GSTIN_BANK_MISSING",
  "companyParentChildRelationIds": [
    "string"
  ],
  "company_id": "string",
  "parent_id": "string",
  "child_id": "string",
  "business_type": "ENTERPRISE",
  "company_type": "string",
  "tax_id_1": "string",
  "tax_id_2": "string",
  "cin": "string",
  "din": "string",
  "external_ref_no": "string",
  "risk_approval_status": "APPROVED",
  "status": "ACTIVE",
  "created_date_from": "2019-08-24T14:15:22Z",
  "created_date_to": "2019-08-24T14:15:22Z",
  "date_approved": "2019-08-24T14:15:22Z",
  "email": "string",
  "legal_name": "string",
  "branch_code": "string",
  "order_by": "string"
}

Request 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 POST 'https://test.your-api-server.com/api/v1/beneficiary/search' \
--header 'Content-Type: application/json' \
--data-raw '{
    "companyIds": [
        "string"
    ],
    "parentIds": [
        0
    ],
    "offset": 0,
    "limit": 5000,
    "panOrGstin": "string",
    "companyBranchCodeIds": [
        0
    ],
    "panStatus": "UNVERIFIED",
    "gstinStatus": "UNVERIFIED",
    "cinStatus": "UNVERIFIED",
    "businessTypes": [
        "ENTERPRISE"
    ],
    "bankVerifiedStatus": "UNVERIFIED",
    "companyOnBoardType": "CUSTOMER",
    "branchCodes": [
        "string"
    ],
    "branchNames": [
        "string"
    ],
    "costCentres": [
        "string"
    ],
    "branchCities": [
        "string"
    ],
    "branchStates": [
        "string"
    ],
    "utmSource": "string",
    "userGroupIds": [
        "string"
    ],
    "isMsme": true,
    "companyIdOrLegalName": "string",
    "direction": "ASC",
    "bankApproval": "KOTAK_APPROVED",
    "bankApprovalStatus": "APPROVED",
    "kycFailureReason": "PAN_GSTIN_BANK_MISSING",
    "companyParentChildRelationIds": [
        "string"
    ],
    "company_id": "string",
    "parent_id": "string",
    "child_id": "string",
    "business_type": "ENTERPRISE",
    "company_type": "string",
    "tax_id_1": "string",
    "tax_id_2": "string",
    "cin": "string",
    "din": "string",
    "external_ref_no": "string",
    "risk_approval_status": "APPROVED",
    "status": "ACTIVE",
    "created_date_from": "2019-08-24T14:15:22Z",
    "created_date_to": "2019-08-24T14:15:22Z",
    "date_approved": "2019-08-24T14:15:22Z",
    "email": "string",
    "legal_name": "string",
    "branch_code": "string",
    "order_by": "string"
}'

Responses

🟢200OK
application/json
Body
response_code
integer <int32>
optional
response_message
string 
optional
payload
object (GenericPaginationResponseCompanySearchResponse) 
optional
recordsCount
integer <int64>
optional
data
array[object (CompanySearchResponse) {26}] 
optional
Example
{
  "response_code": 0,
  "response_message": "string",
  "payload": {
    "recordsCount": 0,
    "data": [
      {
        "parentCompanyId": "string",
        "category": "A",
        "status": "ACTIVE",
        "emails": [
          "string"
        ],
        "phone": "string",
        "kycDetailsSubmitted": true,
        "beneficiaryPan": "string",
        "beneficiaryGst": "string",
        "bankDetailApproved": true,
        "panStatus": "UNVERIFIED",
        "gstinStatus": "UNVERIFIED",
        "selfApproved": true,
        "companyParentChildRelationId": "string",
        "bankApprovalDetails": [
          {
            "bankApproval": "KOTAK_APPROVED",
            "approvedOn": "2019-08-24T14:15:22Z",
            "approvedBy": "string"
          }
        ],
        "bankApprovalStatus": "APPROVED",
        "parent_legal_name": "string",
        "company_id": "string",
        "legal_name": "string",
        "business_type": "ENTERPRISE",
        "risk_approval_status": "APPROVED",
        "created_date": "2019-08-24T14:15:22Z",
        "tax_id_one": "string",
        "tax_id_two": "string",
        "bank_account_number": "string",
        "ifsc": "string",
        "date_modified": "2019-08-24T14:15:22Z"
      }
    ]
  }
}
Modified at 2025-03-05 05:40:09
Previous
Update Bulk Vendors
Next
Get Beneficiaries
Built with