# Get marketing listings

Retrieve marketing listings for a specific account. This endpoint is designed for embedding listings on external websites and marketing platforms.

Endpoint: GET /marketing/listings/{accountId}
Version: 1.1.1
Security: BearerAuth

## Path parameters:

  - `accountId` (string, required)
    The account ID to retrieve listings for
    Example: "4b88ff32-8ba0-4bbf-8e60-c789909ac176"

## Query parameters:

  - `utm_source` (string)
    UTM source parameter for tracking
    Example: "website_widget"

  - `limit` (integer)
    Maximum number of items to return per page (default 50, max 100)
    Example: 25

  - `page_number` (integer)
    Page number for pagination (0-indexed, default 0)
    Example: 1

## Response 200 fields (application/json):

  - `id` (string, required)
    Unique identifier for the listing
    Example: "12345"

  - `email` (string)
    Contact email for the listing
    Example: "leasing@example.com"

  - `phone` (string)
    Contact phone number (digits only)
    Example: "5551234567"

  - `propertyType` (string, required)
    Type of property
    Enum: "Single Family", "Duplex", "Apartment Unit", "Condo Unit", "Townhouse", "ADU", "Room", "Commercial Office", "Commercial Retail", "Commercial Industrial"

  - `companyName` (string)
    Name of the property management company
    Example: "ABC Property Management"

  - `address` (string, required)
    Formatted address
    Example: "123 Main St #2"

  - `city` (string, required)
    City name
    Example: "San Francisco"

  - `state` (string, required)
    Full state name
    Example: "California"

  - `zip` (string, required)
    ZIP code
    Example: "94111"

  - `title` (string)
    Marketing title for the listing
    Example: "Beautiful 3BR Home in Prime Location"

  - `description` (string)
    Marketing description of the property
    Example: "Spacious 3 bedroom home with modern amenities..."

  - `beds` (string, required)
    Number of bedrooms
    Example: "3"

  - `baths` (string, required)
    Number of bathrooms
    Example: "2"

  - `dateAvailable` (string)
    Date the property is available for move-in
    Example: "1/15/2024"

  - `rentAmount` (string, required)
    Monthly rent amount in dollars
    Example: "2500.23"

  - `depositAmount` (string)
    Security deposit amount in dollars
    Example: "2500.23"

  - `squareFootage` (string)
    Square footage of the property
    Example: "1500"

  - `latitude` (number,null)
    Latitude coordinate
    Example: 37.7749

  - `longitude` (number,null)
    Longitude coordinate
    Example: -122.4194

  - `applicationFee` (string)
    Application fee amount in dollars
    Example: "50"

  - `leaseProcessingFee` (string)
    Total lease processing/move-in fees in dollars
    Example: "150.00"

  - `isFurnished` (boolean)
    Whether the property is furnished

  - `dogs` (boolean)
    Whether dogs are allowed
    Example: true

  - `cats` (boolean)
    Whether cats are allowed
    Example: true

  - `applyUrl` (string)
    URL to apply for the listing
    Example: "https://rentengine.io/listings/12345"

  - `btnUrl` (string)
    URL for the schedule showing button
    Example: "https://app.rentengine.io/ss/12345"

  - `btnText` (string)
    Text for the call-to-action button
    Example: "Schedule a Showing"

  - `waitlistIcon` (string)
    Icon identifier for waitlist status
    Example: "snooze"

  - `waitlistLabel` (string)
    Label for waitlist status
    Example: "Wait List"

  - `waitlistTurnOffDate` (string)
    Date when waitlist status ends
    Example: "2024-02-01"

  - `virtualTour` (string,null)
    URL for virtual tour video
    Example: "https://www.youtube.com/watch?v=abc123"

  - `pmName` (string)
    Property manager name
    Example: "ABC Property Management"

  - `pmEmail` (string)
    Property manager email
    Example: "pm@example.com"

  - `pmPhone` (string)
    Property manager phone (digits only)
    Example: "5551234567"

  - `externalId` (string)
    External system identifier
    Example: "EXT-12345"

  - `propertyGroup` (string,null)
    Property group identifier

  - `leaseDescription` (string)
    Description of lease terms
    Example: "12 months"

  - `moveInFees` (array)
    One-time fees required at move-in
    Example: [{"name":"Admin Fee","amount":150,"type":"dollar"}]

  - `moveInFees.name` (string)
    Name of the fee
    Example: "Admin Fee"

  - `moveInFees.amount` (number)
    Fee amount (dollar value or percentage based on type)
    Example: 150

  - `moveInFees.type` (string)
    Whether the amount is a fixed dollar value or percentage of rent
    Enum: "percent", "dollar"

  - `monthlyFees` (array)
    Recurring monthly fees in addition to rent
    Example: [{"name":"Pet Fee","amount":50,"type":"dollar"}]

  - `specials` (array)
    Move-in specials and promotional offers. Combines specials from the unit, floorplan, and multifamily property (if applicable). Expired specials are filtered out.
    Example: [{"description":"First month free!","start_date":"2024-01-01","end_date":"2024-03-31"},{"description":"$500 off move-in costs","start_date":"2024-01-15","end_date":"2024-02-28"}]

  - `specials.description` (string)
    Description of the special offer
    Example: "First month free!"

  - `specials.start_date` (string)
    Start date of the special offer (YYYY-MM-DD)
    Example: "2024-01-01"

  - `specials.end_date` (string)
    End date of the special offer (YYYY-MM-DD)
    Example: "2024-03-31"

  - `photos` (array, required)
    Array of photo URLs
    Example: ["https://storage.example.com/images/photo1.jpg","https://storage.example.com/images/photo2.jpg"]

## Response 404 fields (application/problem+json):

  - `error` (string, required)
    Error message
    Example: "Invalid request parameters"

  - `details` (array)
    Detailed error information
    Example: [{"keyword":"required","dataPath":"","schemaPath":"#/required","params":{"missingProperty":"account_id"},"message":"should have required property 'account_id'"}]

## Response 500 fields (application/json):

  - `error` (string, required)
    Error message
    Example: "Invalid request parameters"

  - `details` (array)
    Detailed error information
    Example: [{"keyword":"required","dataPath":"","schemaPath":"#/required","params":{"missingProperty":"account_id"},"message":"should have required property 'account_id'"}]