Autohost

Autohost Listings API

The Listings API from Autohost — 4 operation(s) for listings.

GitHub OpenAPI

Operations 6

GET /listings/{id} Listing details #
PUT /listings/{id} Listing update #
POST /listings Listing create #
GET /listings/propertyTypes Listing property types #
POST /listings/{id}/superhog Listing manage SuperHog connection #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/autohost/openapi/autohost-listings-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/autohost/json-schema/autohost-reservation-create-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/autohost/json-schema/autohost-reservation-summary-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/autohost/json-schema/autohost-payment-event-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/autohost/json-schema/autohost-reservation-screens-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/autohost/json-schema/autohost-background-check-results-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/autohost/json-schema/autohost-reservation-payments-response-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/autohost:autohost-listings-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

autohost-listings-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Autohost Listings API
  version: '1'
  description: 'Operations tagged Listings across 2 of this provider''s published API definitions: autohost-openapi.json, developer.autohost.ai_openapi.json. Each path carries the servers of the definition it was published in.'
tags:
- name: Listings
paths:
  /listings/{id}:
    get:
      operationId: listings-detail
      summary: Listing details
      description: Get details object for a given listing.
      parameters:
      - name: id
        in: path
        description: Autohost listing ID
        required: true
        schema:
          type: string
      - name: pms
        in: query
        description: PMS integration name. If supplied, the API will perform a lookup using the PMS listing ID or the identifier supplied in `my_id`
        required: false
        allowEmptyValue: false
        schema:
          $ref: '#/components/schemas/QueryParamPMS'
      - name: x-api-key
        in: header
        description: API Authentication Key
        required: false
        schema:
          type: string
      responses:
        '200':
          description: A listing object
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListingDetailsResponse'
        '400':
          description: An error message
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      tags:
      - Listings
    put:
      operationId: listings-update
      summary: Listing update
      description: Update a given listing in your account.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ListingCreateRequest'
            examples:
              minimal:
                value:
                  status: ACTIVE
                  name: Beautiful Downtown View for Two
                  nickname: DT PH 100
                  property_type: Condominium
                  accommodates: 2
                  bedrooms: 1
                  bathrooms: 1
                  beds: 1
                  check_in_time: 15
                  check_out_time: 10
                  location:
                    street: 100 King West
                    city: Toronto
                    country: Canada
                    state: 'ON'
                    zipcode: xxxxx
              full:
                value:
                  my_id: INTERNAL1234
                  status: ACTIVE
                  name: Beautiful Downtown View for Two
                  nickname: DT PH 100
                  property_type: Condominium
                  accommodates: 2
                  bedrooms: 1
                  bathrooms: 1
                  beds: 1
                  check_in_time: 15
                  check_out_time: 10
                  location:
                    street: 100 King West
                    city: Toronto
                    country: Canada
                    state: 'ON'
                    zipcode: xxxxx
                    building: GROUP123
                  pictures:
                    large_url: https://www.example.com/large.jpg
                    regular_url: https://www.example.com/regular.jpg
                    thumbnail_url: https://www.example.com/thumbnail.jpg
        description: JSON object with listing details
      parameters:
      - name: id
        in: path
        description: Autohost listing ID
        required: true
        schema:
          type: string
      - name: callback
        in: query
        description: Webhook URL to POST the list object.
        required: false
        allowEmptyValue: false
        schema:
          $ref: '#/components/schemas/QueryParamCallback'
      - name: x-api-key
        in: header
        description: API Authentication Key
        required: false
        schema:
          type: string
      responses:
        '200':
          description: A listing object
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListingDetailsResponse'
        '400':
          description: An error message
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      tags:
      - Listings
  /listings:
    get:
      operationId: listings-search
      summary: Listing search
      description: Return paginated list of listings matching the search criteria.
      parameters:
      - name: status
        in: query
        description: Listing status
        required: false
        allowEmptyValue: false
        schema:
          $ref: '#/components/schemas/QueryParamListingStatus'
      - name: search
        in: query
        description: String search
        required: false
        allowEmptyValue: false
        schema:
          type: string
      - name: building
        in: query
        description: Building name
        required: false
        allowEmptyValue: false
        schema:
          type: string
      - name: x-api-key
        in: header
        description: API Authentication Key
        required: false
        schema:
          type: string
      responses:
        '200':
          description: A list of listing objects
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListingSearchResponse'
        '400':
          description: An error message
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      tags:
      - Listings
    post:
      operationId: listings-create
      summary: Listing create
      description: Create a new listing in your account.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ListingCreateRequest'
            examples:
              minimal:
                value:
                  status: ACTIVE
                  name: Beautiful Downtown View for Two
                  nickname: DT PH 100
                  property_type: Condominium
                  accommodates: 2
                  bedrooms: 1
                  bathrooms: 1
                  beds: 1
                  check_in_time: 15
                  check_out_time: 10
                  location:
                    street: 100 King West
                    city: Toronto
                    country: Canada
                    state: 'ON'
                    zipcode: xxxxx
              full:
                value:
                  my_id: INTERNAL1234
                  status: ACTIVE
                  name: Beautiful Downtown View for Two
                  nickname: DT PH 100
                  property_type: Condominium
                  accommodates: 2
                  bedrooms: 1
                  bathrooms: 1
                  beds: 1
                  check_in_time: 15
                  check_out_time: 10
                  location:
                    street: 100 King West
                    city: Toronto
                    country: Canada
                    state: 'ON'
                    zipcode: xxxxx
                    building: GROUP123
                  pictures:
                    large_url: https://www.example.com/large.jpg
                    regular_url: https://www.example.com/regular.jpg
                    thumbnail_url: https://www.example.com/thumbnail.jpg
        description: JSON object with listing details
      parameters:
      - name: callback
        in: query
        description: Webhook URL to POST the list object.
        required: false
        allowEmptyValue: false
        schema:
          $ref: '#/components/schemas/QueryParamCallback'
      - name: x-api-key
        in: header
        description: API Authentication Key
        required: false
        schema:
          type: string
      responses:
        '200':
          description: A listing object
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListingDetailsResponse'
        '400':
          description: An error message
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      tags:
      - Listings
  /listings/propertyTypes:
    get:
      operationId: listings-propertyTypes
      summary: Listing property types
      description: Return a static list of supported property types. This list is used to populate the `property_type` field when creating a new listing object.
      parameters:
      - name: x-api-key
        in: header
        description: API Authentication Key
        required: false
        schema:
          type: string
      responses:
        '200':
          description: A list of listing objects
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListingPropertyTypesResponse'
              examples:
                Full:
                  value:
                  - Apartment
                  - Cottage
                  - Condominium
                  - House
                  - Serviced Apartment
                  - Boat
                  - Camper/RV
                  - Chalet
                  - Bed&Breakfast
                  - Villa
                  - Tent
                  - Other
                  - Cabin
                  - Townhouse
                  - Bungalow
                  - Hut
                  - Dorm
                  - Plane
                  - Treehouse
                  - Yurt
                  - Tipi
                  - Igloo
                  - Earth House
                  - Island
                  - Cave
                  - Castle
                  - Studio
      tags:
      - Listings
  /listings/{id}/superhog:
    post:
      operationId: listings-superhog
      summary: Listing manage SuperHog connection
      description: Connect or disconnect your listings from SuperHog.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ListingSuperhogRequest'
            examples:
              connect:
                value:
                  action: connect
              disconnect:
                value:
                  action: disconnect
        description: JSON object with listing details
      parameters:
      - name: id
        in: path
        description: Autohost listing ID
        required: true
        schema:
          type: string
      - name: x-api-key
        in: header
        description: API Authentication Key
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Listing SuperHog connect or disconnect response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListingSuperhogResponse'
              examples:
                connected:
                  value:
                    autohost_id: xyxyxyxyxyxyx
                    superhog_id: abcd1234
                disconnected:
                  value:
                    autohost_id: xyxyxyxyxyxyx
                    superhog_id: null
        '400':
          description: An error message
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      tags:
      - Listings
components:
  schemas:
    QueryParamCallback:
      type: string
    QueryParamPMS:
      type: string
      enum:
      - api
      - apaleo
      - beds24
      - booking
      - cloudbeds
      - guesty
      - hostaway
      - hostfully
      - inforhms
      - impala
      - lavanda
      - myvr
      - opera
      - smartbnb
      - stayntouch
      - streamline
      - trackhs
    ErrorResponse:
      properties:
        error:
          type: string
    ListingSearchResponse:
      properties:
        total:
          type: number
        from:
          type: number
        size:
          type: number
        count:
          type: number
        items:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              status:
                type: string
    QueryParamListingStatus:
      type: string
      enum:
      - ACTIVE
      - INACTIVE
    ListingCreateRequest:
      required:
      - my_id
      - status
      - name
      - nickname
      - property_type
      - accommodates
      - location.street
      - location.city
      - location.country
      - location.state
      - location.zipcode
      properties:
        id:
          type: string
        my_id:
          type: string
        status:
          type: string
          enum:
          - ACTIVE
          - INACTIVE
        name:
          type: string
        nickname:
          type: string
        property_type:
          type: string
          enum:
          - Apartment
          - Cottage
          - Condominium
          - House
          - Serviced Apartment
          - Boat
          - Camper/RV
          - Chalet
          - Bed&Breakfast
          - Villa
          - Tent
          - Other
          - Cabin
          - Townhouse
          - Bungalow
          - Hut
          - Dorm
          - Plane
          - Treehouse
          - Yurt
          - Tipi
          - Igloo
          - Earth House
          - Island
          - Cave
          - Castle
          - Studio
        accommodates:
          type: number
        bedrooms:
          type: number
        bathrooms:
          type: number
        beds:
          type: number
        check_in_time:
          type: number
        check_out_time:
          type: number
        location:
          type: object
          properties:
            building:
              type: string
            street:
              type: string
            city:
              type: string
            country:
              type: string
            state:
              type: string
            zipcode:
              type: string
            geo:
              type: object
              properties:
                lat:
                  type: number
                lon:
                  type: number
        pictures:
          type: object
          properties:
            large_url:
              type: string
            regular_url:
              type: string
            thumbnail_url:
              type: string
    ListingDetailsResponse:
      properties:
        id:
          type: string
        my_id:
          type: string
        user_id:
          type: string
        status:
          type: string
        name:
          type: string
        nickname:
          type: string
        property_type:
          type: string
        accommodates:
          type: number
        bedrooms:
          type: number
        bathrooms:
          type: number
        beds:
          type: number
        check_in_time:
          type: number
        check_out_time:
          type: number
        location:
          type: object
          properties:
            street:
              type: string
            city:
              type: string
            state:
              type: string
            country:
              type: string
            time_zone_name:
              type: string
            building:
              type: string
        created_at:
          type: string
        updated_at:
          type: string
    ListingSuperhogResponse:
      properties:
        autohost_id:
          type: string
        superhog_id:
          type: string
    ListingPropertyTypesResponse:
      type: array
      items:
        type: string
    ListingSuperhogRequest:
      properties:
        action:
          type: string
          enum:
          - connect
          - disconnect
x-refined-from:
- autohost-openapi.json
- developer.autohost.ai_openapi.json