Sharetribe API changes
2024-10-08
Added
- Add
read
permission tocurrentUser
permissionSet in the Marketplace API. - Add
read
permission touser
permissionSet in the Integration API. - New Integration API endpoint
/users/update_permissions
2024-10-02
Added
- Add
initiateTransactions
permission tocurrentUser
permissionSet in the Marketplace API. - Add
initiateTransactions
permission touser
permissionSet in the Integration API.
2024-08-27
Added
- Add attribute
state
to thecurrentUser
resource in the Marketplace API. - Add attribute
state
to theuser
resource in the Marketplace API. - Add attribute
state
to theuser
resource in the Integration API.
Deprecated
- The
banned
flag in thecurrentUser
anduser
resources in the Marketplace API, and in theuser
resource in the Integration API, is now deprecated. Usestate
instead.
2024-08-16
Added
- Add support for new query parameters
ids
keywords
origin
bounds
price
publicData
metadata
start
end
seats
availability
minDuration
stockMode
minStock
sort
states
in the Marketplace API/own_listings/query
endpoint.
2024-08-14
Added
- Add attribute
permissions
and relationshipeffectivePermissionSet
for thecurrentUser
resource in the Marketplace API. - Add attribute
permissions
and relationshipeffectivePermissionSet
for theuser
resource in the Integration API.
2024-05-20
Added
- Add support for passing collection options (
collectionOptions
parameter) when creating Stripe Account Links with the /stripe_account_links/create Marketplace API endpoint.
Deprecated
- The
collect
parameters in the /stripe_account_links/create Marketplace API endpoint is now deprecated. UsecollectionOptions
instead.
2024-04-25
Changed
- User display name can now be reset to default value. Affected endpoints:
2023-10-16
Added
- Add /sitemap_data/query_listings and /sitemap_data/query_assets API endpoints to Marketplace API.
2023-08-30
Added
- Add support for an additional query parameter
stockMode
in the Marketplace API/listings/query
and the Integration API/listings/query
API endpoints.
2023-05-09
Added
- Add support for querying multiple assets
2023-03-06
Added
- Add support for additional query parameters
userId
,listingId
,createdAtStart
,createdAtEnd
andprocessNames
in the Marketplace API/transactions/query
API endpoint.
2023-02-14
Added
- Add documentation for asset references in Asset Delivery API.
2023-01-17
Fixed
- Fix an issue that prevented the listing search from working with negative numbers as search parameters
2022-12-21
Changed
- Document API rate limits that come into effect. See:
2022-05-16
- Add reference for the new Asset Delivery API.
2022-05-03
Added
- Add support for creating a listing in the Integration API via the /listings/create endpoint.
Fixed
- Fix issue causing several Marketplace and Integration API endpoints to ignore
the
limit.*
andfields.*
query parameters.
2022-04-05
Fixed
- Integration API's /users/show now treats the
email
query parameter as case insensitive, as the rest of the APIs.
2022-03-23
Added
- Add support for deleting a user in the Marketplace API /current_user/delete endpoint using trusted token.
Changed
- The /transactions/transition and /transactions/transition_speculative command endpoints in the Marketplace API now return appropriate error code if either party of the transaction is a banned or deleted user.
- The /transactions/transition and /transactions/transition_speculative command endpoints in the Integration API now return appropriate error code if either party of the transaction is a banned or deleted user.
2021-12-16
Added
- Add support for filtering users by extended data in the Integration API /users/query endpoint.
- Add support for sorting of users by numeric extended data in the Integration API /users/query endpoint.
- Add
paginationLimit
to API responsemeta
where applicable. Update documentation on pagination limits in some API requests. See pagination section.
2021-10-08
Changed
- Change
/listings/query
to return no listings ifids
parameter is empty. Earlier, the API ignoredids
filter if the value was empty.
2021-09-22
Added
Add support for ids
query parameter in the /listings/query
endpoints in both
the Marketplace API and the Integration
API.
2021-09-20
Added
Add support for listing stock management:
- Add new resource type
stockAdjustment
in the Marketplace API and the Integration API and new API endpoints:/stock_adjustments/create
in the Marketplace API and the Integration API/stock_adjustments/query
in the Marketplace API and the Integration API
- Add new resource type
stockReservation
in the Marketplace API and the Integration API and new API endpoints:/stock_reservations/show
endpoint in the Integration API
- Add new resource type
stock
in the Marketplace API and the Integration API and new API endpoints:/stock/compare_and_set
in the Marketplace API and the Integration API
- Add new relationships:
currentStock
relationship ofownListing
resource in the Marketplace APIcurrentStock
relationship oflisting
resource in the Marketplace APIcurrentStock
relationship oflisting
resource in the Integration APIstockReservation
relationship oftransaction
resource in the Marketplace APIstockReservation
relationship oftransaction
resource in the Integration API
- Add support for new nested
relationships:
listing.currentStock
oftransaction
resources in the Marketplace API and Integration APIstockReservation.stockAdjustments
oftransaction
resource in the Integration API
- Add support for filtering listings by minimum available stock in the
/listings/query
endpoints in the Marketplace API and the Integration API
2021-06-10
Changed
- Allow creating Stripe Customer without PaymentMethodId. See
2021-05-11
Changed
- Allow combining
sort
andkeywords
parameters in listings query in Marketplace API and Integration API. See
2021-04-29
Changed
- Updated Flex API timezone data to use the 2021a version of the IANA timezone database. This fixes an issue where time-based availability plans were incorrectly handled for some time zones that had their DST rules changed recently.
2021-03-25
- Add support for ISO 8601 timestamp string format without milliseconds, e.g. "2021-03-25T18:01:42Z"
2021-02-04
Added
- Add a
listing
relationship tobooking
resource in Integration API. See booking relationships - Add support for querying events with
relatedResourceId
. See querying events.
2021-01-27
Added
- Add a relationship from
reviews
totransaction
in Integration API. See review relationships
2021-01-26
Deprecated
description
attribute of the marketplace resource in Marketplace API is now deprecated.description
attribute of the marketplace resource in Integration API is now deprecated.
2020-12-16
Added
- Add OpenID Connect to supported identity providers, see Identity providers.
2020-12-15
Added
- Add support for querying events in the Integration API
- See Events
- New Integration API endpoint
/events/query
- Add support for
listing
relationship foravailabilityException
resource type in the Integration API - Add support for
ownListing
relationship foravailabilityException
resource type in the Marketplace API
Changed
- Update the Integration API URL to
https://flex-integ-api.sharetribe.com/v1/integration_api/
. Use of the oldhttps://flex-api.sharetribe.com/v1/integration_api/
for the Integration API is now DEPRECATED. The latest Flex Integration API SDK v1.4.0 uses the correct URL by default.
2020-11-16
Added
- Add Google to supported identity providers, see Identity providers.
2020-10-15
Added
- Add support for authenticating using an identity provider
- New endpoint in Marketplace API
/current_user/create_with_idp
- New endpoint in Authentication API
/auth/auth_with_idp
- currentUser resource in
Marketplace API has a new attribute:
identityProviders
. - user resource in Integration API
has a new attribute:
identityProviders
.
- New endpoint in Marketplace API
2020-09-28
- New possible state
proposed
forbooking
resources in the Marketplace API and the Integration API
2020-08-12
Added
- Add support for custom image variants in Marketplace and Integration APIs
2020-07-08
Added
- Add support for transitioning transactions as operator via the Integration API:
- New API endpoint
/transactions/transition
- New API endpoint
/transactions/transition_speculative
- New API endpoint
- Add support for transaction metadata:
- Add
metadata
to thetransaction
resource format in the Marketplace API - Add
metadata
to thetransaction
resource format in the Integration API - New API endpoint
/transactions/update_metadata
- Add
2020-06-25
Added
- Add support to Authentication API for token_exchange for requesting trusted:user tokens that are used for secure API calls
- Enable client secrets for Marketplace API applications
- Enable privileged transitions that require trusted:user token for transitioning
2020-06-15
Changed
- Expand supported query time range for availability exceptions in both the Marketplace API and the Integration API
- Expand the supported query time range for bookings in the Marketplace API
- Expand the supported query time range for timeslots in the Marketplace API
2020-04-30
Changed
- Update documentation to clarify that transactions can not have more than 100 transitions.
2020-03-25
Added
- Add support for filtering listings by time-based availability in
/listings/query
endpoints in both the Marketplace API and the Integration API:- New types of availability filtering
time-full
andtime-partial
- Support for partial availability with given minimum duration (
minDuration
query parameter) - NOTE: Pagination is not supported with
time-full
andtime-partial
availability search queries
- New types of availability filtering
- Add support for minimum duration queries when filtering by day-based
availability:
- New
minDuration
query parameter is now supported - NOTE: Pagination is not supported with queries using
minDuration
- New
- Add support for new
sort
query parameter in/listings/query
. It allows controlling sort order and sorting listings by one or more of:- price amount
- listing creation time
- numeric
publicData
andmetadata
attributes that have a corresponding extended data schema defined
For details, see:
- Marketplace API
/listings/query
- Integration API
/listings/query
Changed
- Deprecating
full
andpartial
values foravailability
query parameter in/listings/query
in both the Marketplace API and the Integration API. Useday-full
andday-partial
instead.
2020-02-19
Fixed
- Integration API endpoint
/users/show
always returnedfalse
forstripeConnected
.
2020-02-12
Chanegd
- Auth API
/token
POST endpoint now returns scopes associated with the issued token.
2020-01-21
Added
- Add support for updating, approving, closing and opening listings in the
Integration API:
- New endpoint
/listings/update
- New endpoint
/listings/approve
- New endpoint
/listings/close
- New endpoint
/listings/open
- New endpoint
- Add support for updating user profile data in the Integration
API:
- New endpoint
/users/update_profile
- New endpoint
- Add public
metadata support
for users (new attribute
profile.metadata
):- Read-only support in the Marketplace API
user
andcurrentUser
resources - Read-write support in the Integration API
user
- Read-only support in the Marketplace API
- Add support for creating, querying and deleting availability exceptions in the
Integration API:
- New endpoint
/availability_exceptions/query
- New endpoint
/availability_exceptions/create
- New endpoint
/availability_exceptions/delete
- New endpoint
- Add support for uploading images in the Integration API:
- New endpoint
/images/upload
- New endpoint
- Add support for querying transactions by user or listing in the Integration
API's
/transactions/query
API endpoint. - Add support for deleting user profile image in the Marketplace API
/current_user/update_profile
endpoint.
2019-12-20
Changed
- Stripe Account resource in Marketplace API updated to contain Account object
returned from Stripe, see
stripeAccount
.
Added
- New API endpoint
/stripe_account/fetch
.
2019-12-19
Changed
- Marketplace API endpoints that invoke the Stripe API now return a
409
response with error codestripe-invalid-request
for all unknown4xx
responses from Stripe. See:
2019-12-11
Fixed
- Change listings keyword search to be accent insensitive.
Changed
- Listing's query now supports passing in the minimum number of seats that the listing should have available on the given period to match. Works with both the Integration API and the Marketplace API.
2019-12-04
Added
- A new Flex API is now available - Integration API.
2019-12-02
Added
- Add support for
client_credentials
grant using client secret in the Authentication API. Used for obtaining access tokens for the Integration API.
2019-11-27
Changed
- Listing's query now allows choosing between AND (has all) and OR (has any)
matching mode for public extended data and metadata when querying against a
multi enum field. The default is still AND so this is a non-breaking change.
See
/listings/query
.
2019-09-16
Added
- Expose listing's availability plan
type
andtimezone
inlisting
resources.
2019-08-22
Added
- Add support for storing payment cards using Stripe's Customers and Payment Methods
- New API endpoint
/stripe_setup_intents/create
- New API endpoint
/stripe_customer/create
- New API endpoint
/stripe_customer/add_payment_method
- New API endpoint
/stripe_customer/delete_payment_method
- New API resource
stripeSetupIntent
- New API resource
stripePaymentMethod
- Updated relationships on API resource
currentUser
- New API endpoint
2019-07-16
Added
- Keyword search added to the listings query endpoint. See
/listings/query
.
2019-06-12
Changed
- Expand the bookings query up to 365 days in the future for listings with a
day-based availability plan. See
/bookings/query
.
2019-05-15
Changed
- Allow querying listings by availability up to 365 days in the future. See
/listings/query
. - Expand the timeslots query range to 365 days for listings with a day-based
availability plan. See
/timeslots/query
.
2019-04-15
Changed
- Increase page size to 500 for the time slots query endpoint: See
/timeslots/query
- Time-based availability management and booking display times officially relased. See:
2019-03-25
Added
- Add support for creating Stripe Business accounts and Stripe Persons:
- New API endpoint
/stripe_account/create
replacing deprecated/current_user/create_stripe_account
- New API endpoint
/stripe_account/update
replacing deprecated/current_user/update_stripe_account
- New API endpoint
/stripe_persons/create
- New API endpoint
Changed
- Deprecate
chargesEnabled
andpayoutsEnabled
flags for currentUser resource - Deprecate
/current_user/create_stripe_account
API endpoint - Deprecate
/current_user/update_stripe_account
API endpoint
2019-03-21
Added
- Arbitrary line item codes in the
transaction
resource format. For more information about arbitrary line items, see Custom pricing. - New parameter types
money
and["lineItems"]
in theprocessTransition
resource format.
2019-02-20
Added
- Beta: Support for time-based availability plans and timeslots. See:
- Beta: Support for booking display times in
booking
resource type.
2019-01-30
Changed
- Allow requesting password reset with unverified email address via
/password_reset/request
API endpoint.
Fixed
privateData
was missing fromcurrentUser
resource type whenprofileImage
was included in the/current_user/show
API endpoint.
2019-01-28
Added
- Support for querying listings by day-based availability in
/listings/query
API endpoint.
2019-01-10
Added
2018-11-26
Added
- Support for day-based availability management. See:
- Support for querying bookings for a given time range. See
/bookings/query
.
2018-11-15
Added
- Support for draft listing state. See
/own_listings/create_draft
,/own_listings/publish_draft
and/own_listings/discard_draft
API endpoints.
2018-10-25
Added
- Support for removing listing's price or location data in
/own_listings/update
API endpoint
Fixed
- Fix setting location if listing did not previously have location data in
/own_listings/update
API endpoint
2018-08-14
Added
- New query parameter
price
for/listings/query
API endpoint, which allows filtering listings by price
2018-08-08
Added
- New attribute
protectedData
fortransaction
resource - New possible value
object
forprocessTransition
parameter types
2018-07-05
Added
- New API endpoint:
/timeslots/query