Get Grievance

Get a grievance by its ID

GET /grievances/{grievance_id}

Try it

cURL

cURL

curl --request GET \
  --url https://grm-api.vercel.app/grievances/{grievance_id} \
  --header 'Authorization: Bearer <token>'

200

{
  "status": "<string>",
  "grievance": {
    "title": "<string>",
    "category": "<string>",
    "description": "<string>",
    "id": "<string>",
    "user_id": "<string>",
    "status": "Pending",
    "created_at": "2023-11-07T05:31:56Z",
    "priority": "medium",
    "cpgrams_category": "<string>",
    "updated_at": "2023-11-07T05:31:56Z",
    "resolution_notes": "<string>",
    "grievance_received_date": "2023-11-07T05:31:56Z",
    "grievance_closing_date": "2023-11-07T05:31:56Z",
    "organisation_closing_date": "2023-11-07T05:31:56Z",
    "org_status_date": "2023-11-07T05:31:56Z",
    "reported_as_covid19_case_date": "2023-11-07T05:31:56Z",
    "covid19_category": "<string>",
    "reformed_flag": false,
    "reformed_top_level_category": "<string>",
    "reformed_last_level_category": "<string>",
    "forwarded_to_subordinate": false,
    "forwarded_to_subordinate_details": "<string>",
    "rating": 123,
    "feedback": "<string>",
    "satisfaction_level": "<string>",
    "final_reply": "<string>",
    "appeal_no": "<string>",
    "appeal_date": "2023-11-07T05:31:56Z",
    "appeal_reason": "<string>",
    "appeal_closing_date": "2023-11-07T05:31:56Z",
    "appeal_closing_remarks": "<string>",
    "organisation_grievance_receive_date": "2023-11-07T05:31:56Z",
    "organisation_grievance_close_date": "2023-11-07T05:31:56Z",
    "officers_forwarding_grievance": "<string>",
    "date_of_receiving": "2023-11-07T05:31:56Z",
    "officer_closed_by": "<string>",
    "final_status": "<string>",
    "classified_category": "<string>",
    "formatted_fields": "<string>",
    "follow_up_questions": [
      "<string>"
    ],
    "missing_information": true,
    "is_correct_category": true,
    "category_data": {}
  }
}

Retrieves a grievance by its unique identifier. This endpoint returns the complete grievance details including all fields such as title, description, category, status, timestamps, and any additional metadata related to the grievance processing.

If the grievance is not found, a 404 error is returned. The response includes a status field and the complete grievance object with all its properties.

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

grievance_id · string · required

ID of grievance to fetch

Response

200

application/json

Grievance response

status · string

Status of the operation

grievance · object

Show child attributes

grievance. title · string · required

Title of the grievance

grievance. category · string · required

Category of the grievance

grievance. description · string · required

Detailed description of the grievance

grievance. id · string · required

Unique identifier for the grievance

grievance. user_id · string · required

ID of the user who submitted the grievance

grievance. status · enum<string> · default: Pending · required

Current status of the grievance

Available options: Active, Pending, Closed with resolution, Closed without resolution, Tender Issued

grievance. created_at · string<date-time> · required

Timestamp when the grievance was created

grievance. priority · string · default: medium

Priority level: low, medium, high, critical

grievance. cpgrams_category · string

CPGRAMS category of the grievance

grievance. updated_at · string<date-time>

Timestamp when the grievance was last updated

grievance. resolution_notes · string

Notes on the resolution of the grievance

grievance. grievance_received_date · string<date-time>

Date when the grievance was received

grievance. grievance_closing_date · string<date-time>

Date when the grievance was closed

grievance. organisation_closing_date · string<date-time>

Date when the organisation closed the grievance

grievance. org_status_date · string<date-time>

Date of the last status update by the organisation

grievance. reported_as_covid19_case_date · string<date-time>

Date when the grievance was reported as a COVID-19 case

grievance. covid19_category · string

COVID-19 related category if applicable

grievance. reformed_flag · boolean · default: false

Flag indicating if the grievance is part of reformed process

grievance. reformed_top_level_category · string

Top level category in the reformed classification

grievance. reformed_last_level_category · string

Last level category in the reformed classification

grievance. forwarded_to_subordinate · boolean · default: false

Flag indicating if the grievance was forwarded to a subordinate

grievance. forwarded_to_subordinate_details · string

Details about forwarding to subordinate

grievance. rating · integer

User rating of the grievance resolution

grievance. feedback · string

User feedback on the grievance resolution

grievance. satisfaction_level · string

User satisfaction level with the resolution

grievance. final_reply · string

Final reply to the grievance

grievance. appeal_no · string

Appeal number if the grievance was appealed

grievance. appeal_date · string<date-time>

Date when the appeal was filed

grievance. appeal_reason · string

Reason for the appeal

grievance. appeal_closing_date · string<date-time>

Date when the appeal was closed

grievance. appeal_closing_remarks · string

Remarks on the closing of the appeal

grievance. organisation_grievance_receive_date · string<date-time>

Date when the organisation received the grievance

grievance. organisation_grievance_close_date · string<date-time>

Date when the organisation closed the grievance

grievance. officers_forwarding_grievance · string

Officers who forwarded the grievance

grievance. date_of_receiving · string<date-time>

Date when the grievance was received

grievance. officer_closed_by · string

Officer who closed the grievance

grievance. final_status · string

Final status of the grievance

grievance. classified_category · string

Classified category of the grievance

grievance. formatted_fields · string

Formatted fields for the grievance

grievance. follow_up_questions · string[]

Follow-up questions for the grievance

grievance. missing_information · boolean

Flag indicating if there is missing information

grievance. is_correct_category · boolean

Flag indicating if the category is correct

grievance. category_data · object

Additional category data