Skip to main content
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

Do not put the API key in the URL. Query-string keys (?apikey=) are rejected with 400 API_KEY_IN_QUERY — URLs are recorded in access logs, browser history, and Referer headers. A key that has ever been sent in a URL should be rotated. Send it in the x-api-key header instead.

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

Cache the results for a few minutes if you call this repeatedly. Project membership rarely changes minute-to-minute, and avoiding redundant calls keeps you well under fair-use thresholds.

Next

Project User Stats

Get live and queued user counts for a project.

Upload File API

Submit builds to a project via the API.