List Projects
Retrieve every project owned by your account, authenticated with your API key in the x-api-key header.
GET
Return a list of all projects owned by the authenticated account, with the basic status of each. Use this to enumerate your projects from a server-side script, CI/CD pipeline, or monitoring job before fanning out to per-project endpoints.
Typical workflow
1
Authenticate
Send your API key in the
x-api-key request header. The account is identified by the key — no IDs needed.2
Request the list
Call
GET /projects/projects-status to retrieve every project you own.3
Use the IDs
Take each project’s
_id and pass it anywhere a projectId is required — for example, Project User Stats.Prerequisites
Headers
string
required
Your Streampixel API key. Identifies your account — the project list is scoped to the key’s owner.
Query parameters
string
Optional, for backward compatibility. If provided, it must be the ID of the authenticated account (the key’s owner) — any other value returns
403 Access denied. Omit it in new integrations.Response
number
The number of projects returned.
array
Array of project objects. Each item contains:
Error reference
Next
Project User Stats
Get live and queued user counts for a project.
Upload File API
Submit builds to a project via the API.