List projects
Fetch a list of Lovable projects across your workspaces using the Lovable API. You can search project names, filter by folders or published status, and view results sorted by recent activity.
Teams on a Business plan or higher who want to display or manage their workspace projects inside an integration or dashboard.
Do this, in order
- 1
Create an API key in your Lovable settings that has workspace read permissions.
This endpoint requires permission to read workspace data before it will return any projects.
- 2
Send a GET request to https://api.lovable.dev/v1/projects with your workspace ID as a parameter.
The request must include at least one workspace ID to know where to find projects.
- 3
Add optional query filters such as search text, folder ID, or publication status.
Filtering narrows down your results to just the projects you care about.
- 4
Read the next page marker from the response and pass it back in your next call to fetch more projects.
Results arrive in pages of up to 100 projects, so you need the page marker to see the rest.
Paste this into your project
Create a dashboard view that connects to the Lovable API at https://api.lovable.dev/v1/projects to display all projects in my workspace. Include a search bar that filters by project name, a toggle to filter by published status, and cards showing project titles, visibility, and last edited dates. Handle page loading using the API next cursor.
Words decoded
- cursor
- A code passed between requests that marks your exact place in a list so you can load the next batch of results.
- scope
- A specific permission attached to an API key that defines what actions it is allowed to perform.
- eventual consistency
- A delay where newly created or updated items take a few moments to show up in search results and lists.
Where people get stuck
- Your API key is locked to its own workspace and will return an error if you request data from another workspace.
- If any workspace ID in your request fails authorization, the entire request fails.
- Search queries with fewer than three characters are ignored.
- You cannot query more than 10 workspaces in a single request.
- Setting the folder filter to false while also providing a specific folder ID causes a validation error.
The short version, steps, decoder and prompt on this page are written automatically from Lovable's own documentation and can lag or misread it. The official page is always the authority.