API Endpoints

This section documents all available Partners API v1 endpoints. For full request/response schemas with the ability to make live calls, use the interactive API reference tools:

Tool	URL	Description
Swagger UI	/api/v1/docs/	Interactive API explorer -- browse endpoints, try requests, view schemas
ReDoc	/api/v1/redoc/	Clean, readable API reference
OpenAPI Schema	/api/v1/schema/	Downloadable OpenAPI 3.0 spec (YAML) for code generation

To download the schema for use with code generators:

curl -o openapi.yaml $BASE_URL/api/v1/schema/

Endpoint Summary

Endpoint	Method	Scope	Token Tier	Description
/api/v1/listings/	GET	listings:read	Both	List all listings
/api/v1/listings/<id>/	GET	listings:read	Both	Get listing details
/api/v1/listings/<id>/activation/	PATCH	listings:write	Both	Enable or disable price syncing for a listing
/api/v1/listings/<id>/refresh/	POST	listings:write	Both	Queue a reservations refresh for a listing
/api/v1/listings/<id>/calendar/	GET	listings:read	Both	Get listing calendar
/api/v1/listings/<id>/recommendations/	GET	listings:read	Both	List recommendations for a listing
/api/v1/listings/<id>/customizations/min-stays/	GET	listings:read	Both	Get min-stays customization for a listing
/api/v1/listings/<id>/customizations/min-stays/	PATCH	listings:write	Both	Update min-stays customization for a listing
/api/v1/listings/<id>/customizations/extra-guest-fees/	GET	listings:read	Both	Get extra guest fee customization for a listing
/api/v1/listings/<id>/customizations/extra-guest-fees/	PATCH	listings:write	Both	Update extra guest fee customization for a listing
/api/v1/listings/<id>/customizations/max-stays/	GET	listings:read	Both	Get max-stays customization for a listing
/api/v1/listings/<id>/customizations/max-stays/	PATCH	listings:write	Both	Update max-stays customization for a listing
/api/v1/listings/<id>/customizations/min-max-prices/	GET	listings:read	Both	Get min/max prices customization for a listing
/api/v1/listings/<id>/customizations/min-max-prices/	PATCH	listings:write	Both	Update min/max prices customization for a listing
/api/v1/listings/<id>/customizations/time-based-adjustments/	GET	listings:read	Both	Get time-based adjustments customization for a listing
/api/v1/listings/<id>/customizations/time-based-adjustments/	PATCH	listings:write	Both	Update time-based adjustments customization for a listing
/api/v1/listings/<id>/customizations/checkin-checkout-days/	GET	listings:read	Both	Get checkin/checkout days customization for a listing
/api/v1/listings/<id>/customizations/checkin-checkout-days/	PATCH	listings:write	Both	Update checkin/checkout days customization for a listing
/api/v1/users/	GET	user:read	Both	List users
/api/v1/users/	POST	user:write	App-level only	Create a user
/api/v1/users/<id>/credentials/	GET	user:read	Both	List credentials for a user
/api/v1/users/<id>/	DELETE	user:write	App-level only	Delete a user
/api/v1/users/<id>/accounts/	GET	user:read	Both	List accounts for a user
/api/v1/users/<id>/accounts/	POST	user:write	Both	Add an account for a user
/api/v1/users/<id>/accounts/<id>/refresh/	POST	user:write	Both	Queue a full refresh for an account
/api/v1/users/<id>/accounts/<id>/	DELETE	user:write	Both	Delete an account

Token Tier key:

• App-level only: Requires an application-level token (no user_id).
• Both: Works with either an app-level token (all resources) or a user-scoped token (bound user's resources only).

See User-Scoped Tokens for details.

Common Patterns

All endpoints follow the same conventions:

• Authentication: OAuth2 Bearer token in the Authorization header
• Content-Type: application/vnd.api+json
• Response format: JSON:API
• Pagination: Page-based with page[number] and page[size]
• Errors: Structured JSON:API error responses