---
title: "Retrieve proposals"
method: GET
path: "/proposals"
tags: ["Proposals"]
---

# Retrieve proposals

`GET /proposals`

## Request

- Base URL: `https://sb2api.servicechannel.com/v3`
- URL: `https://sb2api.servicechannel.com/v3/proposals`
- Auth: OAuth 2
  - Authorization code: `https://sb2login.servicechannel.com/oauth/authorize`
  - Token URL: `https://sb2login.servicechannel.com/oauth/token`
- TypeScript: <https://skmtc.dev/servicechannel/apis/servicechannel-api-v-3/docs/proposals/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns proposals based on the specified input parameters for the current subscriber.

## Query parameters

- `statuses` string
- `assignedTo` integer
- `skip` integer
- `top` integer

## Response `200`

The requested proposals are in the response.

- ServiceChannelServicesMessagingProposalsProposalStatisticsResponse: Object of statistics on RFPs and proposals.
  - `DaysPeriod` integer: Time period set as the number of days prior to the current date for which statistics on RFPs and proposals are returned.
  - `RFPsWaitingForApproval` integer: The total number of RFPs awaiting response for the specified time period.
  - `OpenProposals` integer: The total number of proposals in the _Open_ status for the specified time period.
  - `ApprovedProposalsDaysPeriod` integer: Time period set as the number of days prior to the current date for which statistics on approved proposals are returned in `ApprovedProposals`.
  - `ApprovedProposals` integer: The total number of proposals in the _Approved_ status for the specified time period.
  - `WaitingReviewProposals` integer: The total number of proposals in the _On Hold_ and _Reviewed_ statuses for the specified time period.
  - `RejectedProposals` integer: The total number of proposals in the _Rejected_ status for the specified time period.

## Other responses

- `400`: The request is not accepted due to bad syntax, missing parameters, insufficient data, etc.
- `401`: The request is not authorized. <br/>Error codes: 504 — API call rejected by security permissions

---

[API](https://skmtc.dev/servicechannel/apis/servicechannel-api-v-3.md) - [All operations](https://skmtc.dev/servicechannel/apis/servicechannel-api-v-3/llms.txt) - [OpenAPI document](https://skmtc.dev/servicechannel/apis/servicechannel-api-v-3/revisions/d490d6596809?raw)