> ## 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 Invitations

> Retrieves agency invitations. Supports optional `status` filter and cursor pagination.



## OpenAPI

````yaml GET /v1/agency/invitations
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/invitations:
    get:
      tags:
        - Agency
      summary: List agency invitations
      description: >-
        Retrieves agency invitations. Supports optional `status` filter and
        cursor pagination.
      operationId: getV1AgencyInvitations
      parameters:
        - in: query
          name: pageCursor
          schema:
            type: string
        - in: query
          name: pageSize
          schema:
            type: string
        - in: query
          name: status
          schema:
            type: string
            enum:
              - accepted
              - pending
              - declined
      responses:
        '200':
          description: Invitations list
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        invite:
                          type: object
                          properties:
                            uid:
                              type: string
                              description: Unique identifier of the invitation
                              example: '1955676881223622657'
                            createdAt:
                              type: string
                              format: date-time
                              description: >-
                                ISO-8601 timestamp (UTC) when the invitation was
                                received.
                              example: '2025-08-13T17:04:38.077Z'
                            status:
                              type: string
                              enum:
                                - PENDING
                                - DECLINED
                                - ACCEPTED
                              description: >-
                                Current status of the invitation: `PENDING` =
                                awaiting response, `DECLINED` = freelancer
                                declined, `ACCEPTED` = freelancer accepted.
                            result:
                              type: string
                              enum:
                                - DECLINED
                                - CLOSED
                                - WITHDRAWN
                                - REMOVED
                                - PENDING
                                - EXPIRED
                              description: >-
                                Outcome of the invitation: `PENDING` = still
                                active, `DECLINED` = declined by freelancer,
                                `CLOSED` = job closed, `WITHDRAWN` = client
                                withdrew, `REMOVED` = job removed, `EXPIRED` =
                                invitation expired.
                            letter:
                              type: string
                              description: Invitation message from the client.
                            title:
                              type: string
                              description: Title of the invitation or job.
                              example: >-
                                AWS Lambda Function for Integration with SQS and
                                Bubble.io
                          description: Invitation 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
                            photoUrl:
                              type: string
                              format: uri
                              description: URL of the freelancer's profile photo.
                              example: >-
                                https://www.upwork.com/profile-portraits/c15X4ONdSkuDWnML5uiYN1ymYBayBtQDwy3t3BvL1P-4cHCYK37N9-JnoLk7L98ja1
                          description: Freelancer who received the invitation.
                        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
                          description: Job posting details.
                        client:
                          type: object
                          properties:
                            country:
                              type: string
                              description: >-
                                Client country code (as provided by the source
                                system).
                              example: US
                            totalSpent:
                              type: number
                              description: >-
                                Total lifetime spend by the client on the
                                platform.
                              example: 4717.25
                            timezone:
                              type: string
                              description: Client's IANA time zone.
                              example: America/Sao_Paulo
                          description: Client/account metadata for the job.
                      required:
                        - invite
                        - freelancer
                        - job
                        - client
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````