API Reference

Programmatic access to workplace signal scores for 600+ companies.

Beta. This API is provided as-is for developers and researchers. Endpoints, field names, and rate limits may change without notice. Pin the response fields you depend on and monitor the methodology page for scoring changes.

Overview

The Pulvian API gives you programmatic access to workplace signal scores for 600+ companies. Use it to build internal dashboards, enrich your portfolio monitoring tools, or power due-diligence workflows.

All endpoints are read-only and return JSON. The base URL for all requests is:

https://api.pulvian.com

Responses use standard HTTP status codes. Errors return a JSON object with a detail field explaining the problem.

Authentication

All API endpoints require authentication. Pass your API key in the X-API-Key header on every request. Keys are issued to Pro and Enterprise subscribers.

GET /api/v1/companies/stripe HTTP/1.1
Host: api.pulvian.com
X-API-Key: pk_live_...

Alternatively, pass the key as a query parameter for clients that cannot set custom headers:

curl "https://api.pulvian.com/api/v1/companies/stripe?api_key=pk_live_your_key_here"

Key format

Keys follow the format pk_live_<32 random chars> — always starts with "pk_live_".

401

Unknown or revoked key — check you are sending the full key value.

429

Rate limit reached. See the Rate Limits section below.

Key endpoints

GET/api/v1/companies/{slug}

Returns the company profile and its latest signal scores. Replaces {slug} with the company identifier (e.g. stripe).

curl "https://api.pulvian.com/api/v1/companies/stripe" \
  -H "X-API-Key: pk_live_your_key_here"

Example response (abbreviated)

{
  "company": {
    "name": "Stripe",
    "slug": "stripe",
    "industry": "Fintech",
    "country": "US",
    "website": "https://stripe.com"
  },
  "latest_snapshot": {
    "stress_score": 42.1,
    "risk_score": 31.8,
    "confidence_score": 87.5,
    "stress_level": "medium",
    "snapshot_date": "2026-05-24"
  },
  "coverage": "strong"
}

Key response fields

company.name

stringDisplay name of the company.

latest_snapshot.stress_score

float 0–100Aggregate stress signal. Higher = more stress indicators.

latest_snapshot.risk_score

float 0–100Aggregate risk signal. Higher = more risk flags.

latest_snapshot.confidence_score

float 0–100Data confidence. Lower = fewer sources, treat with caution.

coverage

strong | moderate | limitedQualitative coverage band for this company.

GET/api/v1/companies

Lists companies with optional filters. Returns paginated results with latest scores.

curl "https://api.pulvian.com/api/v1/companies?industry=Fintech&limit=20" \
  -H "X-API-Key: pk_live_your_key_here"

Query parameters

industry

stringFilter by industry (e.g. "Fintech", "SaaS"). Case-insensitive.

country

stringISO 3166-1 alpha-2 country code (e.g. US, GB, DE).

stress_level

low | medium | highFilter by stress level band.

sort

stringSort order: name_asc (default), stress_desc, risk_desc, recently_updated, most_changed.

limit

integerResults per page (1–100, default 20).

offset

integerPagination offset (default 0).

GET/api/v1/companies/{slug}/trend

Returns score history as a time series, ordered by date ascending. History depth depends on your plan tier (see Rate Limits below).

curl "https://api.pulvian.com/api/v1/companies/stripe/trend?limit=90" \
  -H "X-API-Key: pk_live_your_key_here"

Example response (abbreviated)

{
  "slug": "stripe",
  "snapshots": [
    {
      "snapshot_date": "2026-03-01",
      "stress_score": 38.4,
      "risk_score": 29.1,
      "confidence_score": 85.2
    },
    {
      "snapshot_date": "2026-04-01",
      "stress_score": 41.0,
      "risk_score": 30.5,
      "confidence_score": 86.8
    }
  ],
  "total": 90
}

limit

integerCap the number of returned points (most-recent N, max 1 000). Default 30.

Additional endpoints — search, industry statistics, similar companies, and bulk export — are also available. See the full endpoint listing or contact us for the complete OpenAPI schema.

Rate limits

Rate limits are enforced per API key. Exceeding the limit returns 429 Too Many Requests. Scores update at most once per day — cache responses on your side to stay well within limits.

Tier	Requests / day	History	Export
Pro	1 000	180 days	CSV
Enterprise	Custom	Full	CSV + JSON

Enterprise rate limits are negotiated per account. Daily request quotas for Pro keys reset at midnight UTC.

Error format

All errors return JSON with a detail field:

{
  "detail": "Company not found."
}

400

Bad request — malformed query parameter or body.

401

Missing or invalid API key.

404

Resource not found.

422

Validation error — missing required field or invalid value.

429

Rate limit exceeded. Back off and retry after the window resets.

Terms and attribution

API usage is governed by the API access section of our Terms of Use. Key points:

Attribution required. When displaying Pulvian scores in a product visible to end users, you must attribute the data to Pulvian and link to pulvian.com.
No resale. You may not resell, sublicense, or redistribute API data as a standalone data product without prior written agreement.
No misrepresentation. Scores are opinions derived from publicly available data — do not present them as verified facts or certified ratings.

For the full explanation of how scores are computed, see the methodology page.

Get API access

API access is available to Pro and Enterprise subscribers. Enterprise plans include custom rate limits, full score history, JSON + CSV export, and a dedicated onboarding call.

Overview

All endpoints are read-only and return JSON. The base URL for all requests is:

https://api.pulvian.com

Responses use standard HTTP status codes. Errors return a JSON object with a detail field explaining the problem.

Authentication

All API endpoints require authentication. Pass your API key in the X-API-Key header on every request. Keys are issued to Pro and Enterprise subscribers.

GET /api/v1/companies/stripe HTTP/1.1
Host: api.pulvian.com
X-API-Key: pk_live_...

Alternatively, pass the key as a query parameter for clients that cannot set custom headers:

curl "https://api.pulvian.com/api/v1/companies/stripe?api_key=pk_live_your_key_here"

Key format

Keys follow the format pk_live_<32 random chars> — always starts with "pk_live_".

401

Unknown or revoked key — check you are sending the full key value.

429

Rate limit reached. See the Rate Limits section below.

Key endpoints

GET/api/v1/companies/{slug}

Returns the company profile and its latest signal scores. Replaces {slug} with the company identifier (e.g. stripe).

curl "https://api.pulvian.com/api/v1/companies/stripe" \
  -H "X-API-Key: pk_live_your_key_here"

Example response (abbreviated)

{
  "company": {
    "name": "Stripe",
    "slug": "stripe",
    "industry": "Fintech",
    "country": "US",
    "website": "https://stripe.com"
  },
  "latest_snapshot": {
    "stress_score": 42.1,
    "risk_score": 31.8,
    "confidence_score": 87.5,
    "stress_level": "medium",
    "snapshot_date": "2026-05-24"
  },
  "coverage": "strong"
}

Key response fields

company.name

stringDisplay name of the company.

latest_snapshot.stress_score

float 0–100Aggregate stress signal. Higher = more stress indicators.

latest_snapshot.risk_score

float 0–100Aggregate risk signal. Higher = more risk flags.

latest_snapshot.confidence_score

float 0–100Data confidence. Lower = fewer sources, treat with caution.

coverage

strong | moderate | limitedQualitative coverage band for this company.

GET/api/v1/companies

Lists companies with optional filters. Returns paginated results with latest scores.

curl "https://api.pulvian.com/api/v1/companies?industry=Fintech&limit=20" \
  -H "X-API-Key: pk_live_your_key_here"

Query parameters

industry

stringFilter by industry (e.g. "Fintech", "SaaS"). Case-insensitive.

country

stringISO 3166-1 alpha-2 country code (e.g. US, GB, DE).

stress_level

low | medium | highFilter by stress level band.

sort

stringSort order: name_asc (default), stress_desc, risk_desc, recently_updated, most_changed.

limit

integerResults per page (1–100, default 20).

offset

integerPagination offset (default 0).

GET/api/v1/companies/{slug}/trend

Returns score history as a time series, ordered by date ascending. History depth depends on your plan tier (see Rate Limits below).

curl "https://api.pulvian.com/api/v1/companies/stripe/trend?limit=90" \
  -H "X-API-Key: pk_live_your_key_here"

Example response (abbreviated)

{
  "slug": "stripe",
  "snapshots": [
    {
      "snapshot_date": "2026-03-01",
      "stress_score": 38.4,
      "risk_score": 29.1,
      "confidence_score": 85.2
    },
    {
      "snapshot_date": "2026-04-01",
      "stress_score": 41.0,
      "risk_score": 30.5,
      "confidence_score": 86.8
    }
  ],
  "total": 90
}

limit

integerCap the number of returned points (most-recent N, max 1 000). Default 30.

Additional endpoints — search, industry statistics, similar companies, and bulk export — are also available. See the full endpoint listing or contact us for the complete OpenAPI schema.

Rate limits

Rate limits are enforced per API key. Exceeding the limit returns 429 Too Many Requests. Scores update at most once per day — cache responses on your side to stay well within limits.

Tier	Requests / day	History	Export
Pro	1 000	180 days	CSV
Enterprise	Custom	Full	CSV + JSON

Enterprise rate limits are negotiated per account. Daily request quotas for Pro keys reset at midnight UTC.

Error format

All errors return JSON with a detail field:

{
  "detail": "Company not found."
}

400

Bad request — malformed query parameter or body.

401

Missing or invalid API key.

404

Resource not found.

422

Validation error — missing required field or invalid value.

429

Rate limit exceeded. Back off and retry after the window resets.

Terms and attribution

API usage is governed by the API access section of our Terms of Use. Key points:

Attribution required. When displaying Pulvian scores in a product visible to end users, you must attribute the data to Pulvian and link to pulvian.com.
No resale. You may not resell, sublicense, or redistribute API data as a standalone data product without prior written agreement.
No misrepresentation. Scores are opinions derived from publicly available data — do not present them as verified facts or certified ratings.

For the full explanation of how scores are computed, see the methodology page.