API Reference

Introduction

The Subspace API runs deterministic checks per domain against 36 public sources. Every response is a flat JSON object you can map directly to columns in Clay, Airtable, or your CRM. No nested arrays to flatten, no score magic numbers you can't back out.

You can authenticate, query /v1/enrich?domain=stripe.com, and have usable data in 30 seconds. The rest of this reference covers the surface area.

Authentication

Authenticate by passing your API key in the x-api-key header. All endpoints support CORS for browser-based requests.

curl "https://www.thesubspace.io/api/v1/enrich?domain=stripe.com" \
  -H "x-api-key: YOUR_API_KEY"

Rate limits

Rate limits are per-IP and reset every minute. Every response includes x-ratelimit-remaining. Cached responses do not count against your monthly allotment.

Enrich a company

Flat enrichment endpoint optimized for Clay and other enrichment platforms. Returns cost-center tiers, boolean feature flags, and per-signal evidence as top-level fields for direct column mapping — no nested objects.

If the domain is not in the database, it is automatically processed on-demand (first request may take 10–15 seconds).

curl "https://www.thesubspace.io/api/v1/enrich?domain=stripe.com" \
  -H "x-api-key: YOUR_API_KEY"

Query parameters

Pagination example

Walk all listings for a company, then poll for new ones:

# page 1
/api/v1/enrich?domain=stripe.com&include=jobs&jobs_limit=50

# follow jobs_next_offset until jobs_has_more is false
/api/v1/enrich?domain=stripe.com&include=jobs&jobs_limit=50&jobs_offset=50

# next sync — only what's new since your last poll
/api/v1/enrich?domain=stripe.com&include=jobs&jobs_seen_after=2026-04-30T00:00:00Z

Response · 200 OK

Example response for stripe.com. Field list may extend over time in additive fashion — existing field names and types are stable.

{
  "domain": "stripe.com",
  "company_name": "Stripe",
  "operating_status": "active",
  "ats_provider": "greenhouse",
  "company_size": "enterprise",
  "company_location": "us",
  "company_type": "saas_product",

  "hiring_actively": true,
  "total_jobs": 285,
  "fresh_jobs_30d": 241,
  "ghost_job_rate": 12,
  "confidence": "high",
  "job_quality": "excellent",
  "job_board_growing": true,
  "salary_transparent": true,

  "it_infrastructure_tier": "Enterprise",
  "it_infrastructure_budget": "Active",
  "engineering_product_tier": "Enterprise",
  "sales_marketing_tier": "Growth",
  "hr_hiring_tier": "Growth",
  "legal_compliance_tier": "Enterprise",
  "finance_revops_tier": "Growth",
  "telecom_remote_tier": "Growth",
  "corporate_dev_tier": "Growth",

  "cdn_enterprise": true,
  "waf_active": true,
  "security_posture_mature": true,
  "dmarc_enforcing": true,
  "email_security_gateway": true,
  "has_changelog": true,
  "shipping_actively": true,
  "has_status_page": true,
  "is_spending_on_ads": true,
  "ad_spend_heavy": true,
  "international_presence": true,
  "has_trust_center": true,
  "has_soc2": true,
  "has_compliance_program": true,
  "h1b_filer": true,
  "billing_model": "saas_payments",
  "has_enterprise_sso": true,
  "has_enterprise_uc": true,
  "possible_acquisition": false,
  "recent_funding": true,
  "sec_public_filer": false,
  "github_active": true,
  "saas_stack_premium": true,
  "credits_consumed": 1
}

List Companies

GET /api/v1/companies — filter + paginate across all tracked companies. Backs index and rollup views. Cursor-paginated; pass meta.next_cursor from the prior response to fetch the next page.

/api/v1/companies?verdict=actively_hiring&min_jobs=20&order_by=last_activity_at&order_dir=desc&limit=50

Filters: sector, verdict, min_jobs, max_jobs, has_hiring. Order by total_jobs, ghost_index, or last_activity_at.

Search

GET /api/v1/search?q=… — full-text search across companies and job listings. Use type=companies, type=jobs, or type=both (default).

/api/v1/search?q=platform%20engineer&type=jobs&limit=25

Trace (full audit)

GET /api/v1/companies/{domain}/trace — the complete trace payload in one call: cost centers, every signal with its confidence envelope, coverage summary, hiring rollup, and the aggregate confidence_summary (High/Medium/Low counts). A consumer can build their own trace UI from this single endpoint — no direct DB access required.

/api/v1/companies/stripe.com/trace

Reads the most recent stored trace. To refresh, POST /api/trace and poll the returned job id.

Per-signal Confidence

Every signal we emit carries an evidence-strength envelope — the audit trail that makes each observation independently verifiable. Three tiers: High, Medium, Low. Rendering one of these next to a claim is what separates our output from black-box competitors. See docs/ARCHITECTURE-CONFIDENCE-LAYER.md.

{
  "id": "analytics-cdn-unobservable",
  "name": "Analytics stack not observable from the CDN edge",
  "sentiment": "neutral",
  "confidence": {
    "tier": "high",
    "reasons": [
      "direct_http_200",
      "multi_path_consistent",
      "fresh_<6h"
    ],
    "sourceUrls": [
      "https://www.example.com/",
      "https://app.example.com/",
      "https://docs.example.com/"
    ],
    "collectionMethod": "direct_http",
    "observedAt": "2026-04-23T14:22:10Z"
  }
}

Tiers are defensible; decimals aren't — we never expose a numeric 0-1 score externally. Reason codes are machine-readable and never encode sentiment. They describe how sure we are, not whether the finding is good or bad news.

8 Cost Centers

Every company is analyzed across 8 cost centers that map to corporate P&L line items. Each center is derived from publicly observable digital infrastructure — DNS, HTTP headers, HTML, and job data — and surfaced as a categorical tier (Enterprise / Growth / Startup / Inactive) plus the raw signals that drove it. Evidence confidence lives on the individual signals, not on the aggregate.

Response fields

All 105 fields returned by the /enrich endpoint. Boolean fields are ideal for Clay filters and outreach personalization.

Errors & Rate Limits

Rate limit: 60 requests per minute per IP address. All error responses follow the same shape:

{ "error": "Description of what went wrong" }