> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bookingshake.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get the current venue

> Returns the identity, legal information and integration-relevant configuration of the venue the API key belongs to. The natural first call of any integration ("whoami"). Legal fields use the same names as the `seller` block of invoice payloads.



## OpenAPI

````yaml /api-reference/bookingshake-openapi.json get /venues/me
openapi: 3.0.3
info:
  title: BookingShake API
  description: >-
    The BookingShake API allows you to programmatically create and manage
    events, bookings, and related resources. Integrate BookingShake with your
    applications to automate event creation, retrieve booking sources, spaces,
    statuses, and custom fields.


    **Rate Limiting:** All endpoints are rate limited per API key. POST
    /events/create allows 10 requests per minute, while GET endpoints allow 60
    requests per minute. Rate limit information is provided in response headers
    (X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset).
  version: 1.0.0
  contact:
    name: BookingShake Support
    email: support@bookingshake.com
    url: https://bookingshake.com
servers:
  - url: https://api.bookingshake.io/api
    description: Production server
security:
  - bearerAuth: []
tags:
  - name: Events
    description: Create and manage events and bookings
  - name: Resources
    description: Retrieve booking sources, spaces, and statuses
  - name: Fields
    description: Retrieve available custom and default fields
  - name: Invoices
    description: Retrieve issued invoices
  - name: Payments
    description: Retrieve payments
  - name: Contacts
    description: Retrieve contacts (people)
  - name: Products
    description: Retrieve the venue product catalog
  - name: Payment Methods
    description: Retrieve the venue payment method catalog
paths:
  /venues/me:
    get:
      tags:
        - Venue
      summary: Get the current venue
      description: >-
        Returns the identity, legal information and integration-relevant
        configuration of the venue the API key belongs to. The natural first
        call of any integration ("whoami"). Legal fields use the same names as
        the `seller` block of invoice payloads.
      operationId: getVenueMe
      responses:
        '200':
          description: The venue
          headers:
            X-RateLimit-Limit:
              schema:
                type: integer
              description: Maximum requests allowed per minute
            X-RateLimit-Remaining:
              schema:
                type: integer
              description: Requests remaining in the current window
            X-RateLimit-Reset:
              schema:
                type: integer
              description: Unix timestamp when the rate limit resets
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: success
                  data:
                    $ref: '#/components/schemas/VenueResource'
        '400':
          description: Missing or invalid token
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RateLimitResponse'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - bearerAuth: []
components:
  schemas:
    VenueResource:
      type: object
      description: Identity of the venue the API key belongs to.
      properties:
        id:
          type: string
          description: Venue ID
        name:
          type: string
          nullable: true
          example: Le Grand Pavillon
        email:
          type: string
          nullable: true
        phone_number:
          type: string
          nullable: true
        default_lang:
          type: string
          nullable: true
          example: fr
        timezone:
          type: string
          example: Europe/Paris
        currency:
          type: string
          nullable: true
          example: EUR
        prefix:
          type: string
          nullable: true
          description: Prefix used in quote/invoice numbering
        address_line_1:
          type: string
          nullable: true
        address_line_2:
          type: string
          nullable: true
        postal_code:
          type: string
          nullable: true
        city:
          type: string
          nullable: true
        country:
          type: string
          nullable: true
          description: Country as configured (verbatim)
        country_code:
          type: string
          nullable: true
          description: ISO 3166-1 alpha-2 when resolvable
          example: FR
        legal_name:
          type: string
          nullable: true
        company_type:
          type: string
          nullable: true
          example: SAS
        company_registration_id:
          type: string
          nullable: true
          description: SIREN for French companies
        vat_number:
          type: string
          nullable: true
        share_capital:
          type: string
          nullable: true
        venues_group_id:
          type: string
          nullable: true
          description: Venues group the venue belongs to, null otherwise
        created_at:
          type: integer
          nullable: true
          description: Unix milliseconds
    ErrorResponse:
      type: object
      properties:
        message:
          type: string
          description: Error message describing what went wrong
          example: invalid token
    RateLimitResponse:
      type: object
      properties:
        message:
          type: string
          description: Error message
          example: Rate limit exceeded
        data:
          type: object
          properties:
            limit:
              type: integer
              description: Maximum requests allowed per window
              example: 10
            window:
              type: string
              description: Time window duration
              example: 60 seconds
            remaining:
              type: integer
              description: Requests remaining (always 0 on rate limit error)
              example: 0
            resetAt:
              type: string
              format: date-time
              description: ISO 8601 timestamp when the limit resets
              example: '2025-11-17T14:30:00.000Z'
            retryAfter:
              type: integer
              description: Seconds to wait before retrying
              example: 45
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: >-
        Bearer authentication using your BookingShake API key. Retrieve your API
        key from Settings > Integrations in your BookingShake dashboard.

````