List Properties

Retrieve your full property catalog from every connected PMS in a single, normalized API call.

When to use this endpoint

  • Sync your property catalog into your own database
  • Build a property picker or search dropdown for a booking widget
  • Populate a calendar view with all available listings
  • Generate a property directory or portfolio page

Need property details?

Use GET /v1/properties/:id to fetch a single property with full details including custom fields, photos, and amenities.

List properties

GET/v1/properties
curl "https://api.repull.dev/v1/properties?limit=20" \
  -H "Authorization: Bearer sk_live_YOUR_KEY"

# Only properties published on Booking.com
curl "https://api.repull.dev/v1/properties?channel=booking" \
  -H "Authorization: Bearer sk_live_YOUR_KEY"

Query parameters

limitintegerDefault: 50

Maximum number of results to return.

cursorstring

The previous page's pagination.nextCursor. Omit for the first page.

statusstringDefault: active

Which properties to return. Defaults to active only. Inactive properties are returned with identity fields only: id, name, city, status, inactiveReason (plan_limit, unlisted_on_airbnb or deactivated), lifecycleStatus, channels, accounts and updatedAt.

active inactive all
channelstring

Filter to properties published on that OTA. Omit for all.

airbnb booking

Response format

Returns a paginated array of property objects.

{
  "data": [
    {
      "id": "33805",
      "name": "NoMad_241",
      "publicName": "Design 1BR NoMad Wynwood | Terrace + Pool",
      "address": "2700 Northwest 2nd Avenue",
      "city": "Miami",
      "addressDetails": {
        "line1": "2700 Northwest 2nd Avenue",
        "line2": "Unit 241",
        "city": "Miami",
        "state": "FL",
        "postalCode": "33127",
        "countryCode": "US"
      },
      "currency": "USD",
      "status": "active",
      "lifecycleStatus": "live",
      "channels": ["airbnb"],
      "accounts": [
        { "provider": "airbnb", "externalAccountId": "1694261387043536024", "connectionId": "285" }
      ],
      "updatedAt": "2026-10-22T01:16:24.104Z"
    }
  ],
  "pagination": {
    "nextCursor": null,
    "hasMore": false,
    "total": 1
  }
}

Response fields

idstring

Unique property identifier.

namestring

Internal property name.

publicNamestringnullable

Guest-facing display name.

addressstringnullable

Street line as stored on the listing, without the unit. Kept for existing integrations; use addressDetails for the full address.

citystringnullable

City as stored on the listing. Kept for existing integrations.

addressDetailsobject

Full postal address, unit included. Each part is read from the listing first, then from its connected channels (Airbnb, Vrbo, Booking.com); a part nobody has stored is null.

currencystring

Default currency for this property (ISO 4217).

statusstring

active or inactive. An inactive property is not billed and cannot be read or changed through the API until it is activated.

lifecycleStatusstring

The listing's lifecycle state, e.g. live, draft or archived.

channelsstring[]

The OTAs this property is currently published on (e.g. airbnb, booking). Empty if the property is not linked to any channel.

accountsarray

The connected account the property belongs to on each channel: provider, externalAccountId, connectionId.

updatedAtstring

Last time the property record changed. Pass the newest value back as ?updated_since= to poll for changes only.

Filtering examples

Inactive properties you can activate

curl "https://api.repull.dev/v1/properties?status=inactive" \
  -H "Authorization: Bearer sk_live_YOUR_KEY"

# Inactive rows carry identity fields only:
# { "id": "4119", "name": "Harbor Loft", "city": "Tampa", "status": "inactive",
#   "inactiveReason": "plan_limit", "lifecycleStatus": "live", "channels": ["airbnb"],
#   "accounts": [...], "updatedAt": "2026-09-01T12:00:00.000Z" }

Every other property endpoint returns 403 listing_inactive for an inactive property. Activate it with POST /v1/listings/status. See Active & inactive listings.

Properties published on a specific OTA

curl "https://api.repull.dev/v1/properties?channel=booking" \
  -H "Authorization: Bearer sk_live_YOUR_KEY"

Paginate through all properties

curl "https://api.repull.dev/v1/properties?limit=10&cursor=NEXT_CURSOR_FROM_PREVIOUS_PAGE" \
  -H "Authorization: Bearer sk_live_YOUR_KEY"

Pagination

Results are cursor-paginated. Pass the previous response's pagination.nextCursor back as cursor, and stop when pagination.hasMore is false.

// Page through all properties
let cursor: string | undefined

do {
  const { data, pagination } = await repull.properties.list({ limit: 20, cursor });

  for (const property of data) {
    await syncProperty(property);
  }

  cursor = pagination.hasMore ? pagination.nextCursor ?? undefined : undefined;
} while (cursor);

API Reference

See the complete Properties API Reference for all endpoints including get, create, and update.

Want to keep only some of the properties you imported? See Active & Inactive Listings— deactivate the ones you don't need without touching your upstream account.

AI