Skip to main content
GET
List proposals

Authorizations

X-API-TOKEN
string
header
required

API token for authentication

Query Parameters

profileId
integer

Upwork profile ID (from /profiles API endpoint). Required unless groupId is sent

organizationId
integer

Organization ID (from /organizations API endpoint)

page
integer
default:1

Page number

Required range: x >= 1
limit
integer
default:20

Items per page. 10 to 100 in the list, 1 to 50 in the search

Required range: x <= 100
sort
enum<string>
default:submittedAt

Sort field

Available options:
submittedAt
order
enum<string>
default:DESC

Sort order

Available options:
ASC,
DESC
groupId
integer

Search: a profile group. Send it without organizationId and profileId

Required range: x >= 1
dateRange
string
default:last_30_days

A preset: today, yesterday, last_7_days, last_week, last_4_weeks, last_30_days, last_month, last_3_months, last_90_days, last_12_months, month_to_date, quarter_to_date, year_to_date or all_time. Or a custom range as YYYY-MM-DD_YYYY-MM-DD. Read in the team owner's time zone

status
enum<string>

Search only: one outcome. It does not switch to the search on its own

Available options:
sent,
viewed,
replied,
hired,
invitation
templateId
integer

Search: proposals sent with this proposal template

Required range: x >= 1
variant
enum<string>

Search: one A/B variant

Available options:
A,
B
autoBiddingSetupId
integer

Search: proposals sent by this auto-bidding setup

Required range: x >= 1
cursor
string

Search: nextCursor of the previous page

Response

Successful operation

data
object[]
pagination
object