> ## Documentation Index > Fetch the complete documentation index at: https://www.vollna.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Get proposal by ID > Returns a single proposal by its numeric ID ## OpenAPI ````yaml get /proposals/{id} openapi: 3.0.4 info: title: Vollna API description: API for managing Upwork profiles, proposals, results, and filters version: 1.0.0 servers: - url: https://api.vollna.com/v1 security: [] tags: - name: Profiles description: Manage Upwork profiles - name: Proposals description: Access and manage Upwork proposals - name: Results description: View monitoring results and projects - name: Filters description: Manage monitoring filters - name: Auto Bidding description: Manage auto bidding jobs and setups paths: /proposals/{id}: get: tags: - Proposals summary: Get proposal by ID description: Returns a single proposal by its numeric ID parameters: - name: id in: path description: Proposal ID required: true schema: type: integer responses: '200': description: Successful operation content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/Proposal' '403': description: Access denied content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: Resource not found content: application/json: schema: $ref: '#/components/schemas/Error' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/Error' security: - apiToken: [] components: schemas: Proposal: type: object properties: id: type: integer description: Proposal ID example: 1 applicationUid: type: string description: Application UID example: '1234567890123456789' submittedAt: type: string format: date-time description: Submission date and time coverLetter: type: string description: Cover letter answers: type: array items: type: object properties: question: type: string description: Client's question answer: type: string description: Your answer jobDetails: type: object properties: title: type: string description: Job title postedAt: type: string format: date-time description: Job posted date and time freelancer: type: object properties: id: type: integer description: Member ID example: 1 fullName: type: string description: Member full name example: John Doe businessManager: type: object properties: id: type: integer description: Member ID example: 2 fullName: type: string description: Member full name example: Jane Doe upworkProfile: type: object description: Upwork profile details properties: id: type: integer description: Upwork profile ID example: 1 label: type: string description: Upwork profile name example: ACME, Inc. type: type: string enum: - freelancer - agency description: Upwork profile type example: agency upworkOrganization: type: object deprecated: true description: Deprecated, use `upworkProfile` instead properties: id: type: integer description: Organization ID example: 1 label: type: string description: Organization label example: ACME, Inc. type: type: string enum: - freelancer - agency description: Organization type example: agency connects: type: integer description: Connects spent example: 16 boost: type: integer description: Boost example: 8 terms: type: object properties: fixedPrice: type: number format: float description: Fixed price example: 1000 hourlyRate: type: number format: float description: Hourly rate example: 100 increasePercent: type: integer description: Increase percent example: 10 increaseFrequency: type: integer description: Increase frequency in months example: 3 isViewed: type: boolean isInterviewed: type: boolean isHired: type: boolean isWithdrawn: type: boolean isInvitation: type: boolean isArchived: type: boolean occupationUid: type: string occupationTitle: type: string submissionPosition: type: integer description: Submission position example: 3 boostOutbid: type: boolean coverLetterVariant: type: string biddingTemplate: type: object properties: id: type: integer name: type: string project: $ref: '#/components/schemas/Project' nullable: true description: Linked project from Vollna database (if found via Elasticsearch) Error: type: object properties: error: type: string Project: type: object properties: title: type: string description: Project title description: type: string description: Project description skills: type: string description: Required skills, comma-separated url: type: string format: uri description: Project URL publishedAt: type: string format: date-time description: When the project was published clientQuestions: type: array items: type: string nullable: true description: Questions from the client categories: type: array items: type: string description: Project categories site: type: string description: Source site (e.g. Upwork.com) budget: type: object properties: type: type: string enum: - Fixed price - Hourly rate description: Budget type amount: type: string description: Budget amount with currency symbol clientDetails: type: object properties: paymentMethodVerified: type: boolean description: Whether client's payment method is verified country: type: string description: Client's country totalSpent: type: number format: float description: Total amount spent by client example: 103580 totalHires: type: integer description: Total number of hires by client example: 100 hireRate: type: number format: float description: Client's hire rate example: 0.5 rating: type: number format: float description: Client's rating example: 4.5 reviews: type: integer description: Number of client reviews example: 78 clientWorkHistory: type: array nullable: true description: Client's work history with previous freelancers items: type: object properties: job_info: type: object properties: uid: type: string nullable: true description: Job UID title: type: string nullable: true description: Job title type: type: string nullable: true description: Job type status: type: string nullable: true description: Job status (e.g., 'ACTIVE' for jobs in progress) start_date: type: string nullable: true description: Job start date end_date: type: string nullable: true description: Job end date total_hours: type: number format: float nullable: true description: Total hours worked total_charge: type: number format: float nullable: true description: Total amount charged feedback: type: object nullable: true description: Feedback from client to freelancer properties: score: type: number format: float nullable: true description: Rating score comment: type: string nullable: true description: Feedback comment feedback_to_client: type: object nullable: true description: Feedback from freelancer to client properties: score: type: number format: float nullable: true description: Rating score comment: type: string nullable: true description: Feedback comment rate: type: object nullable: true description: Rate information properties: amount: type: number format: float nullable: true description: Rate amount securitySchemes: apiToken: type: apiKey name: X-API-TOKEN in: header description: API token for authentication ````