# GET /api/proposals

> Proposals - List all Proposals

- **Endpoint:** `GET /api/proposals`
- **Group:** Proposals
- **Since:** v1.0.0
- **Defined in:** `RestApi/Controllers/ProposalsController.php`

## Headers

| Field | Type | Description |
| --- | --- | --- |
| `authtoken` | String | Authentication token, generated from admin area |

## Parameters

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `client_id` | Number | no | Optional filter by client ID |
| `status` | String | no | Optional filter by status (draft, sent, accepted, declined) |

## Request example

```bash
curl -X GET "https://yoursite.com/index.php/api/proposals" \
  -H "authtoken: YOUR_API_TOKEN"
```

## Responses

### Success - Success-Response:

```json
{
		"id": "1",
		"client_id": "2",
		"proposal_date": "2021-09-15",
		"valid_until": "2021-10-15",
		"status": "sent",
		"note": "Proposal for new project",
		"tax_id": "1",
		"project_id": "1",
		"discount_amount": "5",
		"discount_amount_type": "percentage"
}
```

---

Part of the [REST API for RISE CRM](https://risecrm.themesic.com/apiguide/) documentation.
Full page: https://risecrm.themesic.com/apiguide/proposals/get-proposals/