Public Grievance Redressal Service API

Rainmaker-PGR Service Contract

PreviousPublic Grievance Redressal Data Model NextTrade License Service

Last updated 1 year ago

Was this helpful?

Get service requests

Gets the list of service requests for a particular ULB based on search criteria.

name: group in: query description: Attribute of service config, it indicate the "Department" for which service type is defined. required: false type: string format: varchar
name: serviceCode in: query description: Allows search for service type - comma separated list. type: array items: type: string format: varchar
name: startDate in: query description: Earliest epoch time to include in search - request created time | required: false type: integer format: int64
name: endDate in: query description: Latest epoch time to include in search - request created time | If search is on start date then end date is mandatory, if end date is null then server will take current date as end date. required: false type: integer format: int64
name: lastUpdatedSince in: query description: searches all requests that have been modified/created since last modified epoch time as provided here required: false type: integer format: int64

post

/requests/_search

Responses

*/*

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'https://egov-micro-dev.egovernments.org/rainmaker-pgr/v2/requests/_search'

200

400

{
  "ResponseInfo": {
    "apiId": "text",
    "ver": "text",
    "ts": 1,
    "resMsgId": "text",
    "msgId": "text",
    "status": "SUCCESSFUL"
  },
  "services": [
    {
      "citizen": {
        "tenantId": "text",
        "name": "text",
        "mobileNumber": "text"
      },
      "tenantId": "text",
      "serviceCode": "text",
      "serviceRequestId": "text",
      "description": "text",
      "lat": 1,
      "long": 1,
      "address": "text",
      "addressId": "text",
      "email": "text",
      "deviceId": "text",
      "accountId": "text",
      "firstName": "text",
      "lastName": "text",
      "phone": "text",
      "attributes": {},
      "expectedTime": 1,
      "feedback": "text",
      "rating": "text",
      "landmark": "text",
      "auditDetails": {
        "createdBy": "text",
        "lastModifiedBy": "text",
        "createdTime": 1,
        "lastModifiedTime": 1
      },
      "status": "New",
      "source": "sms"
    }
  ],
  "actionHistory": [
    {
      "actions": [
        {
          "tenantId": "text",
          "by": "text",
          "isInternal": "text",
          "when": 1,
          "businessKey": "text",
          "action": "text",
          "status": "text",
          "assignee": "text",
          "comment": "text",
          "media": [
            "text"
          ]
        }
      ]
    }
  ]
}

Successful response sorted by reverse chrnological order of creation

Create service requests

Create new service requests - supports batch - please note that in case of errors entire batch is rejected

post

/requests/_create

Body

RequestInfoobjectrequired

RequestInfo should be used to carry meta information about the requests to the server as described in the fields below. All eGov APIs will use requestinfo as a part of the request body to carry this meta information. Some of this information will be returned back from the server as part of the ResponseInfo in the response body to ensure correlation.

servicesobject[] · max: 100required

actionInfoobject[] · max: 100

Responses

*/*

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'https://egov-micro-dev.egovernments.org/rainmaker-pgr/v2/requests/_create' \
  --header 'Content-Type: application/json' \
  --data '{"RequestInfo":{"apiId":"text","ver":"text","ts":1,"action":"text","msgId":"text","userInfo":{"tenantId":"text","userName":"text","primaryrole":[{"name":"text"}],"additionalroles":[{"tenantId":"text","roles":[{"name":"text"}]}]}},"services":[{"citizen":{"tenantId":"text","name":"text","mobileNumber":"text"},"tenantId":"text","serviceCode":"text","phone":"text","attributes":{},"auditDetails":{"createdBy":"text","lastModifiedBy":"text","createdTime":1,"lastModifiedTime":1},"status":"New","source":"sms"}],"actionInfo":[{"media":[null]}]}'

200

400

{
  "ResponseInfo": {
    "apiId": "text",
    "ver": "text",
    "ts": 1,
    "resMsgId": "text",
    "msgId": "text",
    "status": "SUCCESSFUL"
  },
  "services": [
    {
      "citizen": {
        "tenantId": "text",
        "name": "text",
        "mobileNumber": "text"
      },
      "tenantId": "text",
      "serviceCode": "text",
      "serviceRequestId": "text",
      "description": "text",
      "lat": 1,
      "long": 1,
      "address": "text",
      "addressId": "text",
      "email": "text",
      "deviceId": "text",
      "accountId": "text",
      "firstName": "text",
      "lastName": "text",
      "phone": "text",
      "attributes": {},
      "expectedTime": 1,
      "feedback": "text",
      "rating": "text",
      "landmark": "text",
      "auditDetails": {
        "createdBy": "text",
        "lastModifiedBy": "text",
        "createdTime": 1,
        "lastModifiedTime": 1
      },
      "status": "New",
      "source": "sms"
    }
  ],
  "actionHistory": [
    {
      "actions": [
        {
          "tenantId": "text",
          "by": "text",
          "isInternal": "text",
          "when": 1,
          "businessKey": "text",
          "action": "text",
          "status": "text",
          "assignee": "text",
          "comment": "text",
          "media": [
            "text"
          ]
        }
      ]
    }
  ]
}

Service Request Created

Update service requests

Updates service request - supports batch - please note that in case of errors entire batch is rejected

post

/requests/_update

Body

RequestInfoobjectrequired

servicesobject[] · max: 100required

actionInfoobject[] · max: 100

Responses

*/*

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'https://egov-micro-dev.egovernments.org/rainmaker-pgr/v2/requests/_update' \
  --header 'Content-Type: application/json' \
  --data '{"RequestInfo":{"apiId":"text","ver":"text","ts":1,"action":"text","msgId":"text","userInfo":{"tenantId":"text","userName":"text","primaryrole":[{"name":"text"}],"additionalroles":[{"tenantId":"text","roles":[{"name":"text"}]}]}},"services":[{"citizen":{"tenantId":"text","name":"text","mobileNumber":"text"},"tenantId":"text","serviceCode":"text","phone":"text","attributes":{},"auditDetails":{"createdBy":"text","lastModifiedBy":"text","createdTime":1,"lastModifiedTime":1},"status":"New","source":"sms"}],"actionInfo":[{"media":[null]}]}'

200

400

{
  "ResponseInfo": {
    "apiId": "text",
    "ver": "text",
    "ts": 1,
    "resMsgId": "text",
    "msgId": "text",
    "status": "SUCCESSFUL"
  },
  "services": [
    {
      "citizen": {
        "tenantId": "text",
        "name": "text",
        "mobileNumber": "text"
      },
      "tenantId": "text",
      "serviceCode": "text",
      "serviceRequestId": "text",
      "description": "text",
      "lat": 1,
      "long": 1,
      "address": "text",
      "addressId": "text",
      "email": "text",
      "deviceId": "text",
      "accountId": "text",
      "firstName": "text",
      "lastName": "text",
      "phone": "text",
      "attributes": {},
      "expectedTime": 1,
      "feedback": "text",
      "rating": "text",
      "landmark": "text",
      "auditDetails": {
        "createdBy": "text",
        "lastModifiedBy": "text",
        "createdTime": 1,
        "lastModifiedTime": 1
      },
      "status": "New",
      "source": "sms"
    }
  ],
  "actionHistory": [
    {
      "actions": [
        {
          "tenantId": "text",
          "by": "text",
          "isInternal": "text",
          "when": 1,
          "businessKey": "text",
          "action": "text",
          "status": "text",
          "assignee": "text",
          "comment": "text",
          "media": [
            "text"
          ]
        }
      ]
    }
  ]
}

Service Request updated