Upwork icon

Upwork

Interact with Upwork API to manage job posts and proposals

Actions3

Proposal → Get Many

AI-generated

Summary

Retrieve multiple proposals submitted for a specified Upwork job posting, optionally filtered by proposal status and limited in count.

Inputs

  • Job Posting ID (required) — The ID of the job posting whose proposals you want to retrieve.
  • Return All — Whether to return all matching proposals or limit the number returned.
  • Limit — Maximum number of proposals to return when 'Return All' is false (between 1 and 100).
  • Filters — Optional filters to narrow proposals by their status (e.g., Active, Hired, Declined).

Output shape

a list of proposal objects each containing details like proposal ID, proposing user, cover letter, terms, status, creation date, and audit info

If 'Return All' is true, all matching proposals are returned with pagination handled internally; otherwise, up to the specified limit are returned. Errors during API requests are propagated unless 'Continue On Fail' is enabled, in which case error details are included per item.

Discussion