Developer API

Everything the web calculator does, available over HTTPS. Send a project location and investment details, get back every state, local, zone, and federal incentive program the project qualifies for, with estimated dollar benefits. Free to use.

Get your API key

Register once and your personal API key is emailed to you within a minute. No credit card, no approval wait.

Check your email

Your API key was sent to your email address so we know it is really yours. Send it as the x-api-key header on every request. If it does not arrive within a few minutes, check your spam folder or email brendan@businessincentives.net.

Quickstart

Base URL:

https://bkwzfrpgycmnihcovcpr.supabase.co/functions/v1/public-api/v1

Calculate every incentive for a $10M manufacturing project in Dallas creating 50 jobs:

curl -X POST 'https://bkwzfrpgycmnihcovcpr.supabase.co/functions/v1/public-api/v1/calculate' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "latitude": 32.7767,
    "longitude": -96.7970,
    "capex": 10000000,
    "jobs_created": 50,
    "average_wage": 65000,
    "industry_tags": ["Manufacturing & Processing"]
  }'

The response includes the resolved location (state, county, census tract, opportunity zone and NMTC status), every eligible program with its estimated benefit in dollars, mutual-exclusivity handling, and a total:

{
  "location": {
    "state": "Texas",
    "county": "Dallas County",
    "census_tract_geoid": "48113020402",
    "opportunity_zone_eligible": true,
    "nmtc_qualified": true
  },
  "summary": {
    "total_estimated_benefit": 5621381,
    "program_count": 5
  },
  "programs": [
    {
      "program_id": 260,
      "program_name": "New Markets Tax Credit (NMTC)",
      "jurisdiction": "federal",
      "estimated_benefit": 2771415,
      "excluded_from_total": false,
      "benefit_details": { ... }
    }
  ],
  "additional_programs_identified": [ ... ]
}

Endpoints

EndpointDescription
POST /v1/register Create an account and receive an API key. Body: {"name", "email", "company"}. No key required.
POST /v1/calculate Full incentive calculation for a project. Body: latitude, longitude, capex (required); jobs_created, average_wage, industry_tags, responses (optional). The responses object accepts any program-specific answers, such as qualified_rd_wages or real_property_investment, which refine the estimates.
GET /v1/programs Search the program database. Query params: state, tag, type, q (name search), limit (max 100), offset. Returns totals for pagination.
GET /v1/programs/{id} Full program detail: descriptions, eligibility, legal citation, contacts, and required_questions (the project-specific inputs its calculation accepts via responses).
GET /v1/tags The list of valid industry tags for industry_tags and the tag filter.
GET /v1/tax-rates Effective property tax and combined sales tax rates for a point. Query params: lat, lng, optional property_class.
GET /v1/me Your account details and usage counters.

Rate limits

The free tier allows 60 requests per minute and 2,000 requests per day per key. Every response includes X-RateLimit-Remaining-Daily. If you need more, email brendan@businessincentives.net.

Notes

Benefit figures are estimates derived from published program rules and historical award data. Most incentives are discretionary and require application to the administering agency. The API never asks for information that can be derived from the project location, such as tax rates or zone membership, so a minimal request of location plus capex already returns meaningful results.