# Approval Policy Endpoints {#approval-policy-endpoints}


Manage approval policies for time-off requests, expense reports, and equipment sharing.


## Base Path {#base-path}


```
/api/approval-policy
```


## Endpoints {#endpoints}



### List Approval Policies {#list-approval-policies}


```
GET /api/approval-policy
Authorization: Bearer {token}
```

**Query Parameters:**

| Parameter | Type   | Description    |
| --------- | ------ | -------------- |
| `page`    | number | Page number    |
| `limit`   | number | Items per page |


### Get Policy by ID {#get-policy-by-id}


```
GET /api/approval-policy/:id
Authorization: Bearer {token}
```


### Create Approval Policy {#create-approval-policy}


```
POST /api/approval-policy
Authorization: Bearer {token}
```

**Request Body:**

```json
{
  "name": "Time Off Approval",
  "description": "Policy for time-off requests",
  "approvalAlgorithm": "SEQUENTIAL",
  "approverGroups": [
    {
      "approverIds": ["employee-uuid-1", "employee-uuid-2"],
      "approvalMinCount": 1
    }
  ]
}
```


### Update Policy {#update-policy}


```
PUT /api/approval-policy/:id
Authorization: Bearer {token}
```


### Delete Policy {#delete-policy}


```
DELETE /api/approval-policy/:id
Authorization: Bearer {token}
```


## Approval Algorithms {#approval-algorithms}


| Algorithm    | Description                            |
| ------------ | -------------------------------------- |
| `SEQUENTIAL` | Approvers must approve in order        |
| `PARALLEL`   | Any approver can approve independently |


## Permissions {#permissions}


| Action | Required Permission    |
| ------ | ---------------------- |
| View   | `APPROVAL_POLICY_VIEW` |
| Edit   | `APPROVAL_POLICY_EDIT` |


## Related Pages {#related-pages}


- [Time Off Management](https://sourcey-gauzy.pages.dev/features/time-off-management/index.md) — time-off approvals
- [Equipment Sharing](https://sourcey-gauzy.pages.dev/features/equipment-sharing/index.md) — equipment approvals
- [Approval Workflows](https://sourcey-gauzy.pages.dev/features/approval-workflows/index.md) — workflow features