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

# Get Showing

> Retrieves a single showing event with all its details.
You can search by either the showing UUID or the unique_showing_key.




## OpenAPI

````yaml GET /v1/showings/{showingId}
openapi: 3.1.0
info:
  title: North Reports API
  description: >
    The North Reports API allows you to programmatically access and manage your
    North reports.


    Use this API to:

    - Create and update property reports

    - Manage comparable properties

    - Track showings and open houses

    - Import social media engagement data

    - Generate AI-powered summaries


    Perfect for integrations with Zapier, n8n, Make.com, or custom applications.
  version: 1.0.1
  contact:
    name: North Support
    url: https://northreports.com/support
  termsOfService: https://northreports.com/terms
servers:
  - url: https://api.northreports.com
    description: Production API
security:
  - BearerAuth: []
tags:
  - name: Users
    description: User and team information
  - name: Reports
    description: Create and manage North reports
  - name: Comparables
    description: Manage comparable properties
  - name: Showings
    description: Track showings and open houses
  - name: Social Media
    description: Import and track social media engagement
  - name: Webhooks
    description: Subscribe to real-time events
paths:
  /v1/showings/{showingId}:
    get:
      tags:
        - Showings
      summary: Get a specific showing
      description: |
        Retrieves a single showing event with all its details.
        You can search by either the showing UUID or the unique_showing_key.
      operationId: getShowing
      parameters:
        - name: showingId
          in: path
          required: true
          description: |
            The showing identifier. Can be either:
            - A UUID (e.g., `550e8400-e29b-41d4-a716-446655440000`)
            - A unique showing key (e.g., `ext_12345`)
          schema:
            type: string
      responses:
        '200':
          description: Successfully retrieved showing
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/Showing'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimitExceeded'
components:
  schemas:
    Showing:
      type: object
      properties:
        id:
          type: string
          format: uuid
        north_id:
          type: string
          format: uuid
          description: The report ID this showing belongs to
        showing_date:
          type: string
          format: date-time
          description: Date and time of the showing
        scheduled_date:
          type: string
          format: date-time
          description: Scheduled date and time of the showing
        attendee_name:
          type: string
          nullable: true
        attendee_email:
          type: string
          nullable: true
        attendee_phone:
          type: string
          nullable: true
        agent_name:
          type: string
          nullable: true
        feedback:
          type: string
          nullable: true
        rating:
          type: integer
          nullable: true
          minimum: 1
          maximum: 5
        interested:
          type: boolean
          nullable: true
        event_type:
          type: string
          enum:
            - showing
            - open_house
          default: showing
        title:
          type: string
          nullable: true
        attendees_count:
          type: integer
          default: 0
        unique_showing_key:
          type: string
          nullable: true
          description: >-
            Unique identifier for the showing event from external systems. Used
            for deduplication and integration purposes.
        showing_time_start:
          type: string
          format: date-time
          nullable: true
          description: >-
            Start time of the showing event. Used for API entries to specify
            exact start time.
        showing_time_end:
          type: string
          format: date-time
          nullable: true
          description: >-
            End time of the showing event. Used for API entries to specify exact
            end time.
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
          nullable: true
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            message:
              type: string
            status:
              type: integer
  responses:
    Unauthorized:
      description: Invalid or missing API key
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              message: Invalid API key
              status: 401
    Forbidden:
      description: API key lacks required permission
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              message: 'Permission denied: reports:create'
              status: 403
    NotFound:
      description: Resource not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              message: Report not found
              status: 404
    RateLimitExceeded:
      description: Too many requests
      headers:
        X-RateLimit-Limit:
          schema:
            type: integer
          description: Request limit per hour
        X-RateLimit-Remaining:
          schema:
            type: integer
          description: Remaining requests in current window
        X-RateLimit-Reset:
          schema:
            type: integer
          description: Unix timestamp when the rate limit resets
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              message: Rate limit exceeded. Please try again later.
              status: 429
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: >
        API key authentication. Include your API key in the Authorization
        header:

        ```

        Authorization: Bearer north_sk_live_xxxxxxxxxxxx

        ```

````