Get project
This endpoint lets you retrieve the details of a specific Lovable project using its ID. It requires an API key from a Business or higher plan with read permission for projects.
Anyone on a Business plan or above who wants to display or sync Lovable project details inside another tool or dashboard.
Do this, in order
- 1
Check that your workspace is on a Business plan or higher.
Public API access is blocked on lower tier plans.
- 2
Create an API key in your Lovable settings with the 'projects:read' scope enabled.
The request will be rejected with an insufficient scope error without this permission.
- 3
Copy your Project ID from your project settings or URL.
You must include this ID in the web address of your request.
- 4
Send a GET request to https://api.lovable.dev/v1/projects/{project_id} using your API key in the headers.
This tells Lovable to verify your identity and return the project information.
Paste this into your project
Create an internal edge function and an admin screen that fetches project details from the Lovable API. The edge function should make a GET request to https://api.lovable.dev/v1/projects/{project_id}, use a secret named LOVABLE_API_KEY in the Lovable-API-Key header, pin the Lovable-Version header to 2026-09-11, and display the returned project name and details on the page with error handling.Words decoded
- API key
- A secret code that lets external software talk to Lovable on your behalf.
- Scope
- A specific permission granted to an API key, like permission to view projects.
- Endpoint
- A specific web address where an automated program sends requests to fetch or update data.
- Header
- Extra metadata sent alongside a web request, often used to pass authentication credentials.
Where people get stuck
- Using an API key from one workspace to fetch a project that belongs to another workspace will return a 404 not found error.
- Forgetting to add the projects:read scope to your API key will result in a 403 forbidden error.
- Calling this endpoint from free or starter tiers will fail with a 402 payment required 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.