Skip to main content
GET
/
proposals
List proposals
curl --request GET \
  --url https://api.vollna.com/v1/proposals \
  --header 'X-API-TOKEN: <api-key>'
{
  "data": [
    {
      "id": 1,
      "applicationUid": "1234567890123456789",
      "submittedAt": "2023-11-07T05:31:56Z",
      "coverLetter": "<string>",
      "answers": [
        {
          "question": "<string>",
          "answer": "<string>"
        }
      ],
      "jobDetails": {
        "title": "<string>",
        "postedAt": "2023-11-07T05:31:56Z"
      },
      "freelancer": {
        "id": 1,
        "fullName": "John Doe"
      },
      "businessManager": {
        "id": 2,
        "fullName": "Jane Doe"
      },
      "upworkProfile": {
        "id": 1,
        "label": "ACME, Inc.",
        "type": "agency"
      },
      "upworkOrganization": {
        "id": 1,
        "label": "ACME, Inc.",
        "type": "agency"
      },
      "connects": 16,
      "boost": 8,
      "terms": {
        "fixedPrice": 1000,
        "hourlyRate": 100,
        "increasePercent": 10,
        "increaseFrequency": 3
      },
      "isViewed": true,
      "isInterviewed": true,
      "isHired": true,
      "isWithdrawn": true,
      "isInvitation": true,
      "isArchived": true,
      "occupationUid": "<string>",
      "occupationTitle": "<string>",
      "submissionPosition": 3,
      "boostOutbid": true,
      "coverLetterVariant": "<string>",
      "biddingTemplate": {
        "id": 123,
        "name": "<string>"
      },
      "project": {
        "title": "<string>",
        "description": "<string>",
        "skills": "<string>",
        "url": "<string>",
        "publishedAt": "2023-11-07T05:31:56Z",
        "clientQuestions": [
          "<string>"
        ],
        "categories": [
          "<string>"
        ],
        "site": "<string>",
        "budget": {
          "type": "Fixed price",
          "amount": "<string>"
        },
        "clientDetails": {
          "paymentMethodVerified": true,
          "country": "<string>",
          "totalSpent": 103580,
          "totalHires": 100,
          "hireRate": 0.5,
          "rating": 4.5,
          "reviews": 78
        },
        "clientWorkHistory": [
          {
            "job_info": {
              "uid": "<string>",
              "title": "<string>",
              "type": "<string>"
            },
            "status": "<string>",
            "start_date": "<string>",
            "end_date": "<string>",
            "total_hours": 123,
            "total_charge": 123,
            "feedback": {
              "score": 123,
              "comment": "<string>"
            },
            "feedback_to_client": {
              "score": 123,
              "comment": "<string>"
            },
            "rate": {
              "amount": 123
            }
          }
        ]
      }
    }
  ],
  "pagination": {
    "total": 100,
    "page": 1,
    "limit": 20,
    "pages": 5
  }
}

Authorizations

X-API-TOKEN
string
header
required

API token for authentication

Query Parameters

profileId
integer
required

Upwork profile ID (from /profiles API endpoint)

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

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

Sort field

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

Sort order

Available options:
ASC,
DESC

Response

Successful operation

data
object[]
pagination
object