GETGet User's Services

Check the activation status of every service for one of your agents.

GET/user/account/services

Returns the list of services for the given user_code with each service's status (ACTIVATED / PENDING), verification status, and timestamps.

Query parameters

Field	Type	Required	Description
`initiator_id`	string	required	Registered mobile number of the API user (see Platform Credentials).e.g. 9962981729
`user_code`	string	required	User code of the retailer/agent the service is run for.e.g. 20810200

initiator_idstringRequired

Registered mobile number of the API user (see Platform Credentials).

example: 9962981729

user_codestringRequired

User code of the retailer/agent the service is run for.

example: 20810200

Headers

Field	Type	Required	Description
`developer_key`	string	required	Static API key issued to your account after KYC.
`secret-key`	string	required	Dynamic per-request signature: base64(HMAC-SHA256(timestamp, base64(access_key))).
`secret-key-timestamp`	string	required	Current time in milliseconds since UNIX epoch, used to compute secret-key. Must match server time.
`content-type`	string	required	application/jsone.g. application/json

developer_keystringRequired

Static API key issued to your account after KYC.

secret-keystringRequired

Dynamic per-request signature: base64(HMAC-SHA256(timestamp, base64(access_key))).

secret-key-timestampstringRequired

Current time in milliseconds since UNIX epoch, used to compute secret-key. Must match server time.

content-typestringRequired

application/json

example: application/json

Responses

statusnumber
Primary success indicator (0 = success).
messagestring
Human-readable response / error message.
response_status_idnumber
Granular status id; see the shared error-codes table.
response_type_idnumber
A unique id for every possible response shape (success or error) — useful for client logic branching and analytics.
dataobject
API-specific response payload.
- service_status_listarray
  Per-service status for the user.
  - service_codestring
    Service code.
  - status_descstring
    Human-readable status (ACTIVATED / PENDING).
  - statusnumber
    Numeric status (1 = active, 2 = pending).
  - verification_statusnumber
    Verification state of the service.
  - createdAtstring
    When the service was created.

import { EpsClient } from "@ekoindia/eps-sdk";

const client = new EpsClient({

developerKey: process.env.EPS_DEVELOPER_KEY,

accessKey: process.env.EPS_ACCESS_KEY,

initiatorId: "9962981729",

userCode: "20810200",

environment: "sandbox",

});

const result = await client.call("get-user-services");

console.log(result);

{

"response_status_id": -1,

"data": {

"user_code": "20110341",

"initiator_id": "9962981729",

"service_status_list": [

{

"comments": null,

"status_desc": "ACTIVATED",

"city": null,

"user_name": null,

"mobile": null,

"service_provider": null,

"verification_status": 3,

"createdAt": "2019-11-11 13:21:25.0",

"user_code": null,

"service_code": "43",

"state": null,

"status": 1,

"updatedAt": "2019-11-11 13:21:25.0"

{

"comments": null,

"status_desc": "PENDING",

"city": null,

"user_name": null,

"mobile": null,

"service_provider": null,

"verification_status": 0,

"createdAt": "2019-11-11 13:22:44.0",

"user_code": null,

"service_code": "1",

"state": null,

"status": 2,

"updatedAt": ""

}

]

"response_type_id": 1299,

"message": "Status of services for this user",

"status": 0

}