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?
GET /v1/properties/:id to fetch a single property with full details including custom fields, photos, and amenities.List properties
/v1/propertiescurl "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: 50Maximum number of results to return.
cursorstringThe previous page's pagination.nextCursor. Omit for the first page.
statusstringDefault: activeWhich 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 allchannelstringFilter to properties published on that OTA. Omit for all.
airbnb bookingResponse 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
idstringUnique property identifier.
namestringInternal property name.
publicNamestringnullableGuest-facing display name.
addressstringnullableStreet line as stored on the listing, without the unit. Kept for existing integrations; use addressDetails for the full address.
citystringnullableCity as stored on the listing. Kept for existing integrations.
addressDetailsobjectFull 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.
currencystringDefault currency for this property (ISO 4217).
statusstringactive or inactive. An inactive property is not billed and cannot be read or changed through the API until it is activated.
lifecycleStatusstringThe 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.
accountsarrayThe connected account the property belongs to on each channel: provider, externalAccountId, connectionId.
updatedAtstringLast 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.