Get Approval History

curl --request GET \
  --url https://api.example.com/approval-history

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/approval-history",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/approval-history"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/approval-history")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": [
    {
      "id": "aaa14567-e89b-12d3-a456-426614174000",
      "entityType": "leave_request",
      "entityId": "123e4567-e89b-12d3-a456-426614174000",
      "stepNumber": 1,
      "approverId": "789e4567-e89b-12d3-a456-426614174000",
      "action": "approved",
      "comments": "Approved for the requested dates",
      "createdAt": "2026-03-03T09:15:00Z"
    },
    {
      "id": "bbb14567-e89b-12d3-a456-426614174000",
      "entityType": "leave_request",
      "entityId": "123e4567-e89b-12d3-a456-426614174000",
      "stepNumber": 2,
      "approverId": "999e4567-e89b-12d3-a456-426614174000",
      "action": "approved",
      "comments": "Final approval granted",
      "createdAt": "2026-03-03T11:30:00Z"
    }
  ]
}

GET

approval-history

Get Approval History

curl --request GET \
  --url https://api.example.com/approval-history

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/approval-history",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/approval-history"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/approval-history")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": [
    {
      "id": "aaa14567-e89b-12d3-a456-426614174000",
      "entityType": "leave_request",
      "entityId": "123e4567-e89b-12d3-a456-426614174000",
      "stepNumber": 1,
      "approverId": "789e4567-e89b-12d3-a456-426614174000",
      "action": "approved",
      "comments": "Approved for the requested dates",
      "createdAt": "2026-03-03T09:15:00Z"
    },
    {
      "id": "bbb14567-e89b-12d3-a456-426614174000",
      "entityType": "leave_request",
      "entityId": "123e4567-e89b-12d3-a456-426614174000",
      "stepNumber": 2,
      "approverId": "999e4567-e89b-12d3-a456-426614174000",
      "action": "approved",
      "comments": "Final approval granted",
      "createdAt": "2026-03-03T11:30:00Z"
    }
  ]
}

Overview

Retrieve the complete approval history for a specific entity (leave request or memo). This shows all approval actions taken, including who approved/rejected, when, and any comments provided.

Accessible to users with Super Admin, HR Manager, Manager, or Employee roles.

Query Parameters

string

required

Type of entity to get approval history for. Must be one of:

leave_request - For leave request approvals
memo - For memo approvals

uuid

required

The unique identifier of the entity (leave request ID or memo ID)

Response

boolean

Indicates if the request was successful

array

Array of approval history entries, ordered chronologically

Show ApprovalHistory properties

uuid

Unique identifier for this history entry

string

Type of entity: leave_request or memo

uuid

ID of the entity this approval is for

integer

The workflow step number (1, 2, 3, etc.)

uuid

ID of the employee who took the action

string

Action taken by the approver:

approved - Approved and moved to next step
rejected - Rejected the request
requested_changes - Requested changes from submitter

string

Optional comments provided by the approver

timestamp

When the action was taken

Example Requests

Get approval history for a leave request

curl -X GET "https://api.companyflow.com/approval-history?entityType=leave_request&entityId=123e4567-e89b-12d3-a456-426614174000" \
  -H "Authorization: Bearer YOUR_TOKEN"

Get approval history for a memo

curl -X GET "https://api.companyflow.com/approval-history?entityType=memo&entityId=456e4567-e89b-12d3-a456-426614174000" \
  -H "Authorization: Bearer YOUR_TOKEN"

{
  "success": true,
  "data": [
    {
      "id": "aaa14567-e89b-12d3-a456-426614174000",
      "entityType": "leave_request",
      "entityId": "123e4567-e89b-12d3-a456-426614174000",
      "stepNumber": 1,
      "approverId": "789e4567-e89b-12d3-a456-426614174000",
      "action": "approved",
      "comments": "Approved for the requested dates",
      "createdAt": "2026-03-03T09:15:00Z"
    },
    {
      "id": "bbb14567-e89b-12d3-a456-426614174000",
      "entityType": "leave_request",
      "entityId": "123e4567-e89b-12d3-a456-426614174000",
      "stepNumber": 2,
      "approverId": "999e4567-e89b-12d3-a456-426614174000",
      "action": "approved",
      "comments": "Final approval granted",
      "createdAt": "2026-03-03T11:30:00Z"
    }
  ]
}

Understanding Approval Actions

Approved

The approver accepted the request and advanced it to the next step in the workflow. If this was the final step, the request is fully approved.

Rejected

The approver denied the request. This typically ends the approval process and the request status becomes “rejected”.

Requested Changes

The approver asked for modifications before they can approve. The submitter needs to update the request.

Workflow Step Tracking

The stepNumber field corresponds to the steps defined in the approval workflow:

Step 1

First approver in the workflow (e.g., direct manager)

Step 2

Second approver if multi-step workflow (e.g., department head)

Step 3+

Additional steps as defined in the workflow (e.g., HR manager, finance)

The approval history shows all actions taken, even if a request was rejected at step 1. This provides a complete audit trail of the approval process.

Use Cases

Audit Trail

Use approval history to maintain compliance records showing who approved what and when. The comments field provides context for each decision.

Status Tracking

Display approval progress to employees by showing which steps have been completed and who is the current pending approver.

Analytics

Analyze approval patterns, average approval times per step, and which approvers tend to reject or request changes most frequently.

Error Responses

Missing required parameters (entityType or entityId), or invalid entityId format

Missing or invalid authentication token

Server error while retrieving approval history

Authentication

Companies

Employees

Departments

Designations

Levels

Roles & Permissions

Leave Types

Leave Requests

Leave Balances

Memos

Approvals

Get Approval History

Overview

Query Parameters

Response

Example Requests

Get approval history for a leave request

Get approval history for a memo

Understanding Approval Actions

Approved

Rejected

Requested Changes

Workflow Step Tracking

Use Cases

Error Responses

​Overview

​Query Parameters

​Response

​Example Requests

​Get approval history for a leave request

​Get approval history for a memo

​Understanding Approval Actions

Approved

Rejected

Requested Changes

​Workflow Step Tracking

​Use Cases

​Error Responses

Overview

Query Parameters

Response

Example Requests

Get approval history for a leave request

Get approval history for a memo

Understanding Approval Actions

Workflow Step Tracking

Use Cases

Error Responses