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	Unlimited

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

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