# Income Endpoints {#income-endpoints}


Manage income records for employees and organizations.


## Base Path {#base-path}


```
/api/income
```


## Endpoints {#endpoints}



### List Income {#list-income}


```
GET /api/income
Authorization: Bearer {token}
```

**Query Parameters:**

| Parameter    | Type   | Description        |
| ------------ | ------ | ------------------ |
| `employeeId` | UUID   | Filter by employee |
| `startDate`  | Date   | From date          |
| `endDate`    | Date   | To date            |
| `page`       | number | Page number        |
| `limit`      | number | Items per page     |


### Get Income by ID {#get-income-by-id}


```
GET /api/income/:id
Authorization: Bearer {token}
```


### Create Income Record {#create-income-record}


```
POST /api/income
Authorization: Bearer {token}
```

**Request Body:**

```json
{
  "amount": 5000,
  "currency": "USD",
  "valueDate": "2025-01-31",
  "notes": "Project milestone payment",
  "isBonus": false,
  "clientId": "contact-uuid",
  "employeeId": "employee-uuid"
}
```


### Update Income {#update-income}


```
PUT /api/income/:id
Authorization: Bearer {token}
```


### Delete Income {#delete-income}


```
DELETE /api/income/:id
Authorization: Bearer {token}
```


## Permissions {#permissions}


| Action | Required Permission |
| ------ | ------------------- |
| View   | `ORG_INCOMES_VIEW`  |
| Edit   | `ORG_INCOMES_EDIT`  |


## Related Pages {#related-pages}


- [Expense Endpoints](https://sourcey-gauzy.pages.dev/api/expense-endpoints/index.md) — expenses
- [Income Management](https://sourcey-gauzy.pages.dev/features/income-management/index.md) — feature guide