API Documentation

A REST API for the same data behind the FabPulse dashboard — projects, status changes, and reports. Available on Pro and above.

Base URL

https://getfabpulse.com/api/v1

Authentication

Every request needs an x-api-key header. Generate a key from My Account (Pro plan or above required — regenerating a key immediately invalidates the previous one).

curl https://getfabpulse.com/api/v1/projects \
  -H "x-api-key: fp_live_..."

Rate Limits

Limits reset daily (UTC) and apply per API key:

Param	Type	Description
Free	—	No API access
Pro	100 / day
Team	10,000 / day	Shared across all team members' keys
Enterprise	100,000 / day	Higher limits available on request

Exceeding your limit returns 429 with { "error": "Daily rate limit of N requests exceeded." }.

Verification & schedule baselines

Each project in /api/v1/projects includes two extra fields. verification lists how each key fact was checked, and schedule_baseline holds the earliest official schedule target we could verify (or null). A fact with no entry in verification is unverified.

Param	Type	Description
verification[].field	string	status, schedule, or investment
verification[].level	string	confirmed (company/official) or reported (press)
verification[].source_url	string	Where it was checked, with source_name and verified_at
schedule_baseline.baseline_label	string	Earliest verified target, e.g. "2028"
schedule_baseline.baseline_precision	string	year, quarter, month, or day

Pagination

All list endpoints accept page (default 1) and limit (default 25, max 100), and return a pagination object:

{
  "data": [...],
  "pagination": {
    "page": 1,
    "limit": 25,
    "total": 80,
    "total_pages": 4
  }
}

Endpoints

GET/projects

All tracked projects, sorted by investment size (largest first).

Param	Type	Description
status	string	announced · design_permitting · under_construction · operational · delayed · cancelled
country	string	Exact match on location_country, e.g. "USA"
company	string	Partial, case-insensitive match on company_name
page, limit	int	Pagination

curl "https://getfabpulse.com/api/v1/projects?status=under_construction&country=USA" \
  -H "x-api-key: fp_live_..."

GET/updates

Detected changes to tracked projects (status, funding, timeline, etc.), newest first.

Param	Type	Description
project_id	uuid	Limit to one project
since	ISO date	Only updates detected on or after this date
page, limit	int	Pagination

curl "https://getfabpulse.com/api/v1/updates?since=2026-09-01" \
  -H "x-api-key: fp_live_..."

GET/reports

All published reports, newest first. full_content is included only for reports at or below your plan's tier — otherwise it comes back null (the rest of the report's metadata is always included).

curl https://getfabpulse.com/api/v1/reports \
  -H "x-api-key: fp_live_..."

Errors

Param	Type	Description
401	Unauthorized	Missing or invalid x-api-key
403	Forbidden	API access requires Pro or above
429	Too Many Requests	Daily rate limit exceeded
500	Server Error	Something went wrong on our end

Questions

Something not working as documented? hello@getfabpulse.com