API Reference

Base URL: https://api.incentedge.com/v1

All endpoints accept and return JSON. Authenticate with a Bearer token in the Authorization header. 429 status indicates rate limit exceeded.

Quick Start

GET/programsList Programs

Returns a paginated list of all incentive programs. Supports filtering by state, type, technology, and keyword.

Query Parameters

Name	Type	Required	Description
state	string	optional	Two-letter state code (e.g. NY, CA)
type	string	optional	Program type: federal \| state \| local \| utility
technology	string	optional	Technology category: solar \| wind \| storage \| hydrogen
q	string	optional	Keyword search across name and description
limit	integer	optional	Results per page (default: 20, max: 100)
offset	integer	optional	Pagination offset (default: 0)

Response (200 OK)

{
  "programs": [
    {
      "id": "prog_abc123",
      "name": "NY-SUN Megawatt Block Program",
      "type": "state",
      "state": "NY",
      "technology": ["solar"],
      "estimatedValue": "$0.20/W",
      "deadline": "2025-12-31",
      "url": "https://nysun.com/..."
    }
  ],
  "total": 1847,
  "limit": 20,
  "offset": 0
}

POST/programs/matchMatch Programs to a Project

Returns a ranked list of incentive programs matching the project parameters. This is the primary endpoint for project-level incentive analysis.

Request Body

{
  "projectType": "solar",       // Required: technology type
  "state": "NY",                // Required: two-letter state code
  "capacity": 5000,             // Optional: capacity in kW
  "projectSize": "commercial",  // Optional: residential | commercial | utility
  "includeBonus": true          // Optional: include IRA bonus adders
}

Response (200 OK)

{
  "programs": [
    {
      "id": "prog_itc_fed",
      "name": "Investment Tax Credit (ITC)",
      "jurisdiction": "Federal",
      "estimatedValue": "$450,000",
      "creditRate": "30%",
      "bonusAdders": ["energy_community", "domestic_content"],
      "eligibilityScore": 0.95
    }
  ],
  "totalValue": "$890,000",
  "programCount": 12
}

GET/programs/{id}Get Program Details

Returns full details for a specific program including eligibility requirements, application process, deadlines, and related programs.

Query Parameters

Name	Type	Required	Description
id	string	required	Program ID from the list or match endpoints

Response (200 OK)

{
  "id": "prog_itc_fed",
  "name": "Investment Tax Credit (ITC)",
  "type": "federal",
  "creditCode": "Sec. 48",
  "baseRate": 0.30,
  "bonusAdders": {
    "energyCommunity": 0.10,
    "domesticContent": 0.10,
    "lowIncome": 0.20
  },
  "eligibilityRequirements": [...],
  "applicationUrl": "https://irs.gov/...",
  "deadline": null,
  "updatedAt": "2025-11-01T00:00:00Z"
}

POST/calculateCalculate Incentive Value

Calculates the estimated dollar value of a specific incentive program for a given project. Accounts for bonus adders, prevailing wage, and project-specific factors.

Request Body

{
  "programId": "prog_itc_fed",
  "projectCost": 1500000,
  "state": "NY",
  "capacity": 5000,
  "qualifiesForBonus": {
    "energyCommunity": true,
    "domesticContent": false,
    "lowIncome": false
  }
}

Response (200 OK)

{
  "programId": "prog_itc_fed",
  "baseCredit": 450000,
  "bonusCredit": 150000,
  "totalCredit": 600000,
  "effectiveRate": 0.40,
  "breakdown": {
    "base": 0.30,
    "energyCommunityBonus": 0.10
  }
}

GET/programs/federalList Federal Programs

Returns all federal incentive programs. Subset of /programs filtered to federal jurisdiction. Supports same query parameters.

Query Parameters

Name	Type	Required	Description
technology	string	optional	Filter by technology category
limit	integer	optional	Results per page (default: 20, max: 100)

Response (200 OK)

{
  "programs": [...],
  "total": 47,
  "limit": 20,
  "offset": 0
}

GET/programs/state/{state}List State Programs

Returns all incentive programs for a specific state. Includes state, utility, and local programs for that state.

Query Parameters

Name	Type	Required	Description
state	string	required	Two-letter state code (e.g. NY, CA, TX)
technology	string	optional	Filter by technology category

Response (200 OK)

{
  "state": "NY",
  "stateName": "New York",
  "programs": [...],
  "total": 234,
  "limit": 20,
  "offset": 0
}

Error Codes

Status	Meaning
200	Success
400	Bad request — check request body or query parameters
401	Unauthorized — API key missing or invalid
403	Forbidden — endpoint not available on your plan
404	Not found — program ID does not exist
429	Rate limit exceeded — slow down requests
500	Server error — retry with exponential backoff

Ready to build?

Get your API key in minutes. Full access on Pro plan with 14-day free trial.

Get API Key Quick Start Guide