# Equipment Sharing Endpoints {#equipment-sharing-endpoints}


Manage equipment sharing requests and policies between employees.


## Base Path {#base-path}


```
/api/equipment-sharing
```


## Endpoints {#endpoints}



### List Sharing Requests {#list-sharing-requests}


```
GET /api/equipment-sharing
Authorization: Bearer {token}
```


### Get by Employee {#get-by-employee}


```
GET /api/equipment-sharing/employee/:id
Authorization: Bearer {token}
```


### Get by Organization {#get-by-organization}


```
GET /api/equipment-sharing/organization
Authorization: Bearer {token}
```


### Create Sharing Request {#create-sharing-request}


```
POST /api/equipment-sharing
Authorization: Bearer {token}
```

**Request Body:**

```json
{
  "name": "MacBook Pro Sharing",
  "equipmentId": "equipment-uuid",
  "shareRequestDay": "2025-01-15",
  "shareStartDay": "2025-01-20",
  "shareEndDay": "2025-02-20",
  "status": "REQUESTED",
  "employees": ["employee-uuid-1"]
}
```


### Update Request {#update-request}


```
PUT /api/equipment-sharing/:id
Authorization: Bearer {token}
```


### Delete Request {#delete-request}


```
DELETE /api/equipment-sharing/:id
Authorization: Bearer {token}
```


## Sharing Statuses {#sharing-statuses}


| Status      | Description                |
| ----------- | -------------------------- |
| `REQUESTED` | Request submitted          |
| `APPROVED`  | Request approved           |
| `REJECTED`  | Request rejected           |
| `ACTIVE`    | Equipment currently shared |
| `RETURNED`  | Equipment returned         |


## Permissions {#permissions}


| Action | Required Permission          |
| ------ | ---------------------------- |
| View   | `ORG_EQUIPMENT_SHARING_VIEW` |
| Edit   | `ORG_EQUIPMENT_SHARING_EDIT` |


## Related Pages {#related-pages}


- [Equipment Endpoints](https://sourcey-gauzy.pages.dev/api/equipment-endpoints/index.md) — equipment management
- [Approval Policy Endpoints](https://sourcey-gauzy.pages.dev/api/approval-policy-endpoints/index.md) — approval workflows
- [Equipment Management](https://sourcey-gauzy.pages.dev/features/equipment-management/index.md) — feature guide