> ## Documentation Index > Fetch the complete documentation index at: https://docs.getmany.com/llms.txt > Use this file to discover all available pages before exploring further. # List Agency Proposals > Retrieves agency proposals. Supports optional `status` filter and cursor pagination. ## OpenAPI ````yaml GET /v1/agency/proposals openapi: 3.1.0 info: title: Getmany Service API description: This is the reference documentation and schemas for the Getmany Service API. version: 1.0.0 servers: - url: https://api.getmany.io/service description: Production security: - bearerAuth: [] tags: - name: Agency description: >- Agency information tied to the workspace, including agency profile details, seat-holders in an agency, and aggregated proposal performance stats - name: Job Searches description: Saved search configurations that scan the Upwork market - name: Jobs Feed description: >- Endpoints related to retrieving the jobs list matching with a job search configuration - name: Bid Intents description: List and manage bidding intents - name: Miscellaneous description: Various general purpose endpoints - name: Master Inbox description: Chat room management and messaging endpoints paths: /v1/agency/proposals: get: tags: - Agency summary: List agency proposals description: >- Retrieves agency proposals. Supports optional `status` filter and cursor pagination. operationId: getV1AgencyProposals parameters: - in: query name: pageCursor schema: type: string - in: query name: pageSize schema: type: string - in: query name: status schema: type: string enum: - active - submitted - archived responses: '200': description: Proposals list content: application/json: schema: type: object properties: data: type: array items: type: object properties: proposal: type: object properties: uid: type: string description: Unique identifier of the proposal example: '1955676881223622657' createdAt: type: string format: date-time description: >- ISO-8601 timestamp (UTC) when the proposal was created/sent. example: '2025-08-13T17:04:38.077Z' status: type: string enum: - SUBMITTED - ACTIVE - ARCHIVED description: >- Current lifecycle state of the proposal: `SUBMITTED` = sent to the client, `ACTIVE` = client has opened it, `ARCHIVED` = proposal is no longer active. results: type: array items: type: object properties: timeStamp: type: string format: date-time description: >- ISO-8601 timestamp (UTC) when the event occurred. type: type: string description: >- Event type (e.g. SENT, VIEWED_BY_CLIENT, CLIENT_REPLIED, HIRED, CLOSED, DECLINED_BY_CLIENT, WITHDRAWN). example: VIEWED_BY_CLIENT required: - timeStamp - type description: >- Chronological list of lifecycle events recorded for the proposal. isBoosted: type: boolean description: >- Whether the proposal was submitted with a Boost (paid promotion). example: false isBoostOutbid: type: boolean description: >- Whether the proposal’s Boost has been outbid by another freelancer. example: false boostedConnects: type: - number - 'null' description: >- Number of Connects used for boosting the proposal. Null if the proposal was not boosted. example: 10 coverLetter: type: string description: Text of the cover letter sent with the proposal. connectsSpent: type: number description: >- Number of Upwork Connects spent on this proposal. example: 20 questions: type: array items: type: object properties: question: type: string description: >- Text of the screening question from the client. answer: type: string description: >- Text of the answer provided by the freelancer. required: - question - answer description: >- List of screening questions and answers included in the proposal. applicationTimeSeconds: type: - number - 'null' description: >- Time in seconds between the job being published and the proposal being sent. Null if the job publish time is unknown. example: 312.5 attachments: type: array items: type: string description: >- List of attachment URLs submitted with the proposal. example: [] bidDecisionResult: type: - object - 'null' properties: shouldApply: type: boolean description: >- Whether the AI bidder decided to apply to the job. example: true reasons: type: array items: type: string description: Reasons behind the AI bid decision. prompt: type: string description: >- Prompt used by the AI bidder for the decision. required: - shouldApply - reasons - prompt description: >- Result of the AI bid decision for this proposal. Null when not applicable. hubspot: type: - object - 'null' properties: contactId: type: - string - 'null' description: HubSpot contact ID linked to the proposal. dealId: type: - string - 'null' description: HubSpot deal ID linked to the proposal. leadId: type: - string - 'null' description: HubSpot lead ID linked to the proposal. required: - contactId - dealId - leadId description: >- HubSpot CRM entities linked to the proposal. Null if no HubSpot integration data exists. pipedrive: type: - object - 'null' properties: contactId: type: - number - 'null' description: Pipedrive contact ID linked to the proposal. leadId: type: - string - 'null' description: Pipedrive lead ID linked to the proposal. dealId: type: - number - 'null' description: Pipedrive deal ID linked to the proposal. required: - contactId - leadId - dealId description: >- Pipedrive CRM entities linked to the proposal. Null if no Pipedrive integration data exists. chatRoomId: type: string description: >- Upwork chat room ID associated with the proposal, if a conversation exists. description: Proposal payload and related metadata. freelancer: type: object properties: uid: type: string description: Stable unique identifier of the freelancer. example: '669484786717323264' name: type: string description: Display name of the freelancer. example: John Doe description: Freelancer who authored the proposal. manager: type: object properties: uid: type: string description: >- Stable unique identifier of the agency member who sent it. example: '1747622284724662272' name: type: string description: Display name of the agency member (manager). example: Jane Doe description: Agency member associated with the proposal. job: type: object properties: uid: type: string description: Unique identifier of the job posting on Upwork. example: '1955676437925687781' title: type: string description: Job title as shown on Upwork. example: >- AWS Lambda Function for Integration with SQS and Bubble.io description: type: string description: Full job description text. url: type: string format: uri description: Canonical URL of the job posting. example: >- https://www.upwork.com/jobs/~021955676437925687781 cipherText: type: string description: >- Upwork cipher text identifier of the job posting. example: ~021955676437925687781 duration: type: string description: Client-stated expected duration. example: Up to 1 month price: type: number description: Budget amount for fixed-price jobs. example: 1000 minHourlyRate: type: - number - 'null' description: >- Minimum hourly rate if the job is hourly; null for fixed-price jobs. example: null maxHourlyRate: type: - number - 'null' description: >- Maximum hourly rate if the job is hourly; null for fixed-price jobs. example: null hireType: type: string description: >- Hiring arrangement value as provided by the source system. example: ANY budgetType: type: string description: >- Budget type value as provided by the source system. example: FIXED prefEnglishSkills: type: string description: Client’s preferred English proficiency level. example: ANY projectType: type: string description: Project type label. example: One-time project skills: type: array items: type: string description: List of required or relevant skills for the job. example: - API - AWS Lambda - Python - API Integration - Amazon Web Services vendorExpLevel: type: string description: Requested experience level. example: EXPERT vendorCountries: type: - array - 'null' items: type: string description: >- Country codes the client wants the vendor to be located in. Null if unrestricted. example: - US - GB category: type: string description: Top-level job category. example: Web Development createdAt: type: string format: date-time description: >- ISO-8601 timestamp (UTC) when the job was created. example: '2025-08-13T17:02:52.446Z' publishedAt: type: string format: date-time description: >- ISO-8601 timestamp (UTC) when the job was published. example: '2025-08-13T17:02:52.446Z' isFeatured: type: boolean description: Whether the job is featured. example: false jobScore: type: number description: Getmany internal job score. example: 4 description: Job posting details. client: type: object properties: uid: type: - string - 'null' description: Unique identifier of the client company. example: '1234567890' country: type: string description: >- Client country code (as provided by the source system). example: US city: type: - string - 'null' description: Client city. Null if unknown. example: San Francisco companySize: type: - number - 'null' description: Client company size. Null if unknown. example: 50 avgHourlyRate: type: number description: Client’s historical average hourly rate paid. example: 15.001127904353712 totalSpent: type: number description: >- Total lifetime spend by the client on the platform. example: 4717.25 industry: type: string description: Client’s industry segment. example: Art & Design timezone: type: string description: Client’s IANA time zone. example: America/Sao_Paulo connectedAt: type: string format: date-time description: >- ISO-8601 timestamp (UTC) when the client account was connected/created. example: '2020-10-17T00:00:00.000Z' totalHires: type: number description: Total number of hires made by the client. example: 3 feedbackCount: type: number description: >- Number of feedback entries associated with the client. example: 6 feedbackScore: type: number description: >- Average feedback score associated with the client. example: 5 hireRate: type: number description: Client hire rate (percentage value). example: 60 isEnterprise: type: boolean description: >- Whether the client is flagged as an enterprise account. example: false isPaymentMethodVerified: type: boolean description: Whether the client’s payment method is verified. example: true isPhoneNumberVerified: type: boolean description: Whether the client’s phone number is verified. example: false description: Client/account metadata for the job. jobSearch: type: - object - 'null' properties: id: type: string description: ID of the job search entry in Getmany. example: 689b6e81d6d44dcb40b9a9cf url: type: string format: uri description: Deep link to the job search entry in Getmany. example: >- https://app.getmany.io/jse/689b6e81d6d44dcb40b9a9cf name: type: string description: Name of the job search in Getmany. example: My Upwork Search description: >- Metadata of related resources in Getmany. Null when the proposal was not sent via Getmany. invitation: type: - object - 'null' properties: createdAt: type: string format: date-time description: >- ISO-8601 timestamp (UTC) when the client invitation for the same job was received by the agency. example: '2025-08-13T17:04:38.077Z' required: - createdAt description: >- Client invitation associated with this proposal, matched by job and agency. Null when the proposal was not sent in response to an invitation. meta: type: object properties: pageSize: type: number description: Number of proposals requested per page. example: 10 nextCursor: type: - string - 'null' description: >- Cursor to pass as `pageCursor` to fetch the next page. Null when there are no more results. example: 66b2f1c4e2a1b30012a4d9f1 total: type: number description: Total number of proposals matching the query. example: 124 description: Pagination metadata. components: securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ````