# List guests

> Source: /api-reference/partner/explorer/guests/list
> Guests derived from reservations at the venues the credential can reach. This is a reservation-derived roster, not identity resolution: the same person staying at two venues may appear once per venue.
> Full spec: https://docs.journey.com/openapi/partner.v1.json

## `GET /v1/partner/guests`

```json
{
  "description": "Guests derived from reservations at the venues the credential can reach. This is a reservation-derived roster, not identity resolution: the same person staying at two venues may appear once per venue.",
  "operationId": "guestsPartner_list",
  "parameters": [
    {
      "in": "query",
      "name": "bookingStatus",
      "required": false,
      "schema": {
        "enum": [
          "confirmed",
          "canceled",
          "inquiry",
          "other"
        ],
        "type": "string"
      }
    },
    {
      "in": "query",
      "name": "checkInFrom",
      "required": false,
      "schema": {
        "type": "string"
      }
    },
    {
      "in": "query",
      "name": "checkInTo",
      "required": false,
      "schema": {
        "type": "string"
      }
    },
    {
      "in": "query",
      "name": "limit",
      "required": false,
      "schema": {
        "maximum": 100,
        "minimum": 1,
        "type": "number"
      }
    },
    {
      "description": "'true' = members only, 'false' = non-members only.",
      "in": "query",
      "name": "memberLinked",
      "required": false,
      "schema": {
        "type": "string"
      }
    },
    {
      "in": "query",
      "name": "offset",
      "required": false,
      "schema": {
        "minimum": 0,
        "type": "number"
      }
    },
    {
      "in": "query",
      "name": "organizationId",
      "required": false,
      "schema": {
        "type": "string"
      }
    },
    {
      "in": "query",
      "name": "propertyId",
      "required": false,
      "schema": {
        "type": "string"
      }
    },
    {
      "in": "query",
      "name": "q",
      "required": false,
      "schema": {
        "type": "string"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "A page of guests, newest reservation first."
    },
    "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."
    }
  },
  "security": [
    {
      "partnerBearer": []
    },
    {
      "partnerApiKey": []
    }
  ],
  "summary": "List guests",
  "tags": [
    "partner/guests"
  ],
  "x-required-scopes": [
    [
      "partner:guests:read"
    ]
  ]
}
```