Data API endpoints
This section describes how to identify the correct endpoints when using the Data API
This core reference entry is suited for advanced-level builders.
To learn about this topic more in-depth, we recommend reading the suggested articles below:
Article series: The Data API
Article: Introduction to APIs This article covers how APIs work in general, and explores the terminology used.
Bubble offers a collection. This collection is specifically designed to help developers understand and experiment with the various API functionalities available in Bubble.
External page: Bubble Postman collection
You can find the API for your application in Settings - API.
Data API Root URL
The root URL of your application is structured as follows:
https://appname.bubbleapps.io/api/1.1/obj/typenameor if you have registered a domain:
https://yourdomain.com/api/1.1/obj/typenameWhere the following variables are replaced to construct the final endpoint:
appname:
the name of your application
If you have not registered a domain
yourdomain.com
The domain of your application
If you have registered a domain
typename
the name of the data type you are accessing
Use the data type name, but in lowercase and with spaces removed.
App branches and Data API URL
The different branches of your app will have different URLs.
Developer
Developer will have the ID of the selected branch you are working on included. The ID of the Main branch is always version-test, while custom branches have their own unique IDs.
The URL in Settings - API will show the root URL including the branch ID in the branch you are currently working.
https://appname.bubbleapps.io/version-test/api/1.1/obj/typenameor
https://yourdomain.com/version-test/api/1.1/obj/typenameLive
https://yourdomain.com/api/1.1/obj/typenameor
https://appname.bubbleapps.io/api/1.1/obj/typenameThe typename
The typename in the URL represents the data type you want to interact with. We highly recommend that you give all your data types a unique name, especially if you are using the Data API. If two data types share the same name, the Data API will return the first one it finds.
The typename is converted to a URL friendly format by removing spaces and setting it to lowercase. For example:
Data Type name: Rental Unit
Typename: rentalunit
Endpoint URL: https://appname.bubbleapps.io/api/1.1/obj/rentalunit
Last updated
Was this helpful?