# List invites across your reach

> Source: /api-reference/partner/explorer/vguests/list-all
> Every invitation for the brands and venues the credential can reach. Filters narrow that reach and can never widen it: ids outside your reach are dropped, and a filter that leaves nothing returns an empty list. Requires both `partner:guests:read` (declared on the controller) and `partner:guests:pii:read` (on the handler) — the guard ANDs them.
> Full spec: https://docs.journey.com/openapi/partner.v1.json

## `GET /v1/partner/vguests/guest-invites/all`

```json
{
  "description": "Every invitation for the brands and venues the credential can reach. Filters narrow that reach and can never widen it: ids outside your reach are dropped, and a filter that leaves nothing returns an empty list. Requires both `partner:guests:read` (declared on the controller) and `partner:guests:pii:read` (on the handler) — the guard ANDs them.",
  "operationId": "guestInvitesPartner_listAll",
  "parameters": [
    {
      "description": "Comma-separated internal numeric brand ids to narrow to. Ids outside your reach are ignored.",
      "in": "query",
      "name": "brandIds",
      "required": false,
      "schema": {
        "items": {
          "type": "string"
        },
        "type": "array"
      }
    },
    {
      "description": "Comma-separated internal numeric venue (property) ids to narrow to. Ids outside your reach are ignored.",
      "in": "query",
      "name": "venueIds",
      "required": false,
      "schema": {
        "items": {
          "type": "string"
        },
        "type": "array"
      }
    }
  ],
  "responses": {
    "200": {
      "content": {
        "application/json": {
          "schema": {
            "items": {
              "$ref": "#/components/schemas/GuestInviteDto"
            },
            "type": "array"
          }
        }
      },
      "description": "Invitations within reach."
    },
    "400": {
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/PartnerErrorResponse"
          }
        }
      },
      "description": "Request validation failed. `errors` lists the offending fields."
    },
    "401": {
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/PartnerErrorResponse"
          }
        }
      },
      "description": "No usable credential. Send `Authorization: Bearer <jwt>` or `X-API-Key: jny_...`."
    },
    "403": {
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/PartnerErrorResponse"
          }
        }
      },
      "description": "The credential authenticated but lacks the scopes in `x-required-scopes`, or the resource belongs to another organization."
    },
    "404": {
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/PartnerErrorResponse"
          }
        }
      },
      "description": "No such resource, or it is outside the organization the credential resolves to."
    }
  },
  "security": [
    {
      "partnerBearer": []
    },
    {
      "partnerApiKey": []
    }
  ],
  "summary": "List invites across your reach",
  "tags": [
    "partner/vguests"
  ],
  "x-required-scopes": [
    [
      "partner:guests:read"
    ],
    [
      "partner:guests:pii:read"
    ]
  ]
}
```