> ## Documentation Index > Fetch the complete documentation index at: https://cal.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Get an Event's locations > Returns the Event's locations, each with its `id`, in the same shape as `locations` on `GET /v2/events/{uuid}`. A location this API version can't represent is returned as `type: "unknown"`. The authenticated user must be its owner, one of its hosts, an accepted co-host, or a member of the owning team. PBAC permission for team events: `calEvent.read`. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the `EVENT_READ` scope is required. ## OpenAPI ````yaml /api-reference/v2/openapi.json get /v2/events/{uuid}/locations openapi: 3.0.0 info: title: Cal.com API v2 description: '' version: 1.0.0 contact: {} servers: [] security: [] tags: [] paths: /v2/events/{uuid}/locations: get: tags: - Events summary: Get an Event's locations description: >- Returns the Event's locations, each with its `id`, in the same shape as `locations` on `GET /v2/events/{uuid}`. A location this API version can't represent is returned as `type: "unknown"`. The authenticated user must be its owner, one of its hosts, an accepted co-host, or a member of the owning team. PBAC permission for team events: `calEvent.read`. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the `EVENT_READ` scope is required. operationId: EventLocationsController_list parameters: - name: uuid required: true in: path description: >- Event UUID. Accepts the canonical UUID (e.g. `018ff5cd-6dc4-7d57-bcbc-374702ca8b38`) or its short-uuid (Flickr Base58) form (e.g. `1cbZYoAFoJdwqN4tixezd5`). schema: type: string format: uuid - name: Authorization in: header description: >- value must be `Bearer ` where `` is api key prefixed with cal_, managed user access token, or OAuth access token required: true schema: type: string responses: '200': description: '' content: application/json: schema: $ref: '#/components/schemas/EventLocationsOutputResponseDto' '400': description: Invalid Event UUID '401': description: Unauthenticated '403': description: Insufficient permissions '404': description: Event not found components: schemas: EventLocationsOutputResponseDto: type: object properties: status: enum: - success - error type: string example: success data: type: array items: oneOf: - $ref: '#/components/schemas/EventAddressLocationOutput' title: Address - $ref: '#/components/schemas/EventLinkLocationOutput' title: Link - $ref: '#/components/schemas/EventIntegrationLocationOutput' title: Integration - $ref: '#/components/schemas/EventOrganizersDefaultAppLocationOutput' title: Organizer Default App - $ref: '#/components/schemas/EventUnknownLocationOutput' title: Unknown required: - status - data EventAddressLocationOutput: type: object properties: id: type: string description: >- Identifier of this location. Pass it to `PATCH` or `DELETE /v2/events/{uuid}/locations/{locationId}` to edit or remove this location. label: type: string description: Name shown for this location. maxLength: 100 price: type: number nullable: true example: 2500 description: >- Price a guest who picks this location pays, in the currency's smallest unit. null when the location is free. currency: type: string nullable: true example: usd description: Currency of price. null when the location is free. capacity: type: number description: Seats at this location. Absent when unlimited. minimum: 1 maximum: 100000 type: type: string example: address enum: - address address: type: string example: 123 Event Street required: - id - price - currency - type - address EventLinkLocationOutput: type: object properties: id: type: string description: >- Identifier of this location. Pass it to `PATCH` or `DELETE /v2/events/{uuid}/locations/{locationId}` to edit or remove this location. label: type: string description: Name shown for this location. maxLength: 100 price: type: number nullable: true example: 2500 description: >- Price a guest who picks this location pays, in the currency's smallest unit. null when the location is free. currency: type: string nullable: true example: usd description: Currency of price. null when the location is free. capacity: type: number description: Seats at this location. Absent when unlimited. minimum: 1 maximum: 100000 type: type: string example: link enum: - link link: type: string example: https://example.com/event required: - id - price - currency - type - link EventIntegrationLocationOutput: type: object properties: id: type: string description: >- Identifier of this location. Pass it to `PATCH` or `DELETE /v2/events/{uuid}/locations/{locationId}` to edit or remove this location. label: type: string description: Name shown for this location. maxLength: 100 price: type: number nullable: true example: 2500 description: >- Price a guest who picks this location pays, in the currency's smallest unit. null when the location is free. currency: type: string nullable: true example: usd description: Currency of price. null when the location is free. capacity: type: number description: Seats at this location. Absent when unlimited. minimum: 1 maximum: 100000 type: type: string example: integration enum: - integration integration: type: string description: >- The integration's API name, e.g. `zoom` or `google-meet`. An app without an API name is returned with its stored type, e.g. `integrations:dialpad_video`. example: zoom credentialId: type: number description: >- Identifies which connected account will host the Event when a host has multiple connected accounts. required: - id - price - currency - type - integration EventOrganizersDefaultAppLocationOutput: type: object properties: id: type: string description: >- Identifier of this location. Pass it to `PATCH` or `DELETE /v2/events/{uuid}/locations/{locationId}` to edit or remove this location. label: type: string description: Name shown for this location. maxLength: 100 price: type: number nullable: true example: 2500 description: >- Price a guest who picks this location pays, in the currency's smallest unit. null when the location is free. currency: type: string nullable: true example: usd description: Currency of price. null when the location is free. capacity: type: number description: Seats at this location. Absent when unlimited. minimum: 1 maximum: 100000 type: type: string example: organizersDefaultApp enum: - organizersDefaultApp required: - id - price - currency - type EventUnknownLocationOutput: type: object properties: id: type: string description: >- Identifier of this location. Pass it to `PATCH` or `DELETE /v2/events/{uuid}/locations/{locationId}` to edit or remove this location. label: type: string description: Name shown for this location. maxLength: 100 price: type: number nullable: true example: 2500 description: >- Price a guest who picks this location pays, in the currency's smallest unit. null when the location is free. currency: type: string nullable: true example: usd description: Currency of price. null when the location is free. capacity: type: number description: Seats at this location. Absent when unlimited. minimum: 1 maximum: 100000 type: type: string example: unknown enum: - unknown location: type: string description: >- The stored location as JSON, for a location this API version can't represent. Remove it with `DELETE /v2/events/{uuid}/locations/{locationId}`. required: - id - price - currency - type - location ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.