{
  "openapi": "3.1.0",
  "info": {
    "title": "SR&ED tax credit calculator",
    "version": "1.0.0",
    "description": "Estimate the Canadian SR&ED (scientific research and experimental development) tax credits a Canadian-controlled private corporation can claim for a calendar tax year, using the rates for 2025 or 2026 (default 2026): federal and provincial, cash refund and credits not paid in cash. Use it when someone asks how much SR&ED or R&D tax credit a small Canadian company could get from its R&D salaries, an owner's salary or contractor costs. Read-only; returns an estimate, not tax advice. Rules checked in November 2026. Within v1, fields may be added; existing fields will not be removed or change meaning. No key and no fixed quota; see the terms for fair use.",
    "termsOfService": "https://calculator.sredready.ca/terms",
    "contact": {
      "url": "https://www.sredready.ca/contact"
    }
  },
  "externalDocs": {
    "url": "https://calculator.sredready.ca/developers"
  },
  "servers": [
    {
      "url": "https://calculator.sredready.ca"
    }
  ],
  "paths": {
    "/api/v1/estimate": {
      "get": {
        "operationId": "estimateSredCredit",
        "summary": "Estimate SR&ED tax credits for a calendar tax year",
        "parameters": [
          {
            "name": "province",
            "in": "query",
            "required": false,
            "description": "Province or territory, two-letter code, case-insensitive. Valid: AB, BC, MB, NB, NL, NS, NT, NU, ON, PE, QC, SK, YT.",
            "schema": {
              "type": "string",
              "enum": [
                "AB",
                "BC",
                "MB",
                "NB",
                "NL",
                "NS",
                "NT",
                "NU",
                "ON",
                "PE",
                "QC",
                "SK",
                "YT"
              ],
              "default": "ON",
              "description": "Province or territory, two-letter code, case-insensitive. Valid: AB, BC, MB, NB, NL, NS, NT, NU, ON, PE, QC, SK, YT. Default: ON."
            }
          },
          {
            "name": "salaries",
            "in": "query",
            "required": false,
            "description": "Annual pay of employees who work on R&D, before bonuses, in Canadian dollars. Valid: a number from 0 to 999,999,999.",
            "schema": {
              "type": "number",
              "default": 0,
              "description": "Annual pay of employees who work on R&D, before bonuses, in Canadian dollars. Valid: a number from 0 to 999,999,999. Default: 0.",
              "minimum": 0,
              "maximum": 999999999
            }
          },
          {
            "name": "share",
            "in": "query",
            "required": false,
            "description": "Share of those employees' time spent on eligible R&D, in percent. Valid: a number from 0 to 100.",
            "schema": {
              "type": "number",
              "default": 50,
              "description": "Share of those employees' time spent on eligible R&D, in percent. Valid: a number from 0 to 100. Default: 50.",
              "minimum": 0,
              "maximum": 100
            }
          },
          {
            "name": "owner",
            "in": "query",
            "required": false,
            "description": "Annual salary of an owner (holds 10% or more of the shares, or is related to someone who does), before bonuses, in Canadian dollars. Valid: a number from 0 to 999,999,999.",
            "schema": {
              "type": "number",
              "default": 0,
              "description": "Annual salary of an owner (holds 10% or more of the shares, or is related to someone who does), before bonuses, in Canadian dollars. Valid: a number from 0 to 999,999,999. Default: 0.",
              "minimum": 0,
              "maximum": 999999999
            }
          },
          {
            "name": "owner_share",
            "in": "query",
            "required": false,
            "description": "Share of the owner's time spent on eligible R&D, in percent. Valid: a number from 0 to 100.",
            "schema": {
              "type": "number",
              "default": 50,
              "description": "Share of the owner's time spent on eligible R&D, in percent. Valid: a number from 0 to 100. Default: 50.",
              "minimum": 0,
              "maximum": 100
            }
          },
          {
            "name": "contractors",
            "in": "query",
            "required": false,
            "description": "Payments to arm's-length Canadian contractors for R&D work, in Canadian dollars. Valid: a number from 0 to 999,999,999.",
            "schema": {
              "type": "number",
              "default": 0,
              "description": "Payments to arm's-length Canadian contractors for R&D work, in Canadian dollars. Valid: a number from 0 to 999,999,999. Default: 0.",
              "minimum": 0,
              "maximum": 999999999
            }
          },
          {
            "name": "ordtc",
            "in": "query",
            "required": false,
            "description": "Ontario only: also claim the non-refundable Ontario R&D tax credit. Valid: 1 or 0.",
            "schema": {
              "type": "integer",
              "enum": [
                0,
                1
              ],
              "default": 0,
              "description": "Ontario only: also claim the non-refundable Ontario R&D tax credit. Valid: 1 or 0. Default: 0."
            }
          },
          {
            "name": "ab_base",
            "in": "query",
            "required": false,
            "description": "Alberta only: average eligible R&D spending in the two previous tax years, in Canadian dollars. Valid: a number of 0 or more.",
            "schema": {
              "type": "number",
              "default": 0,
              "description": "Alberta only: average eligible R&D spending in the two previous tax years, in Canadian dollars. Valid: a number of 0 or more. Default: 0.",
              "minimum": 0
            }
          },
          {
            "name": "qc_fte",
            "in": "query",
            "required": false,
            "description": "Quebec only: employees on R&D, full-time equivalent. Valid: a number of 0 or more.",
            "schema": {
              "type": "number",
              "default": 0,
              "description": "Quebec only: employees on R&D, full-time equivalent. Valid: a number of 0 or more. Default: 0.",
              "minimum": 0
            }
          },
          {
            "name": "year",
            "in": "query",
            "required": false,
            "description": "Tax year whose rates to use: a calendar year, January to December. Valid: 2025, 2026.",
            "schema": {
              "type": "integer",
              "enum": [
                2025,
                2026
              ],
              "default": 2026,
              "description": "Tax year whose rates to use: a calendar year, January to December. Valid: 2025, 2026. Default: 2026."
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The estimate",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "api_version": {
                      "type": "string",
                      "const": "v1"
                    },
                    "inputs": {
                      "type": "object",
                      "description": "The parameters used, with defaults filled in"
                    },
                    "result": {
                      "type": "object",
                      "properties": {
                        "cash_refund": {
                          "type": "integer",
                          "description": "Canadian dollars, rounded to whole dollars"
                        },
                        "non_refundable": {
                          "type": "integer",
                          "description": "Canadian dollars, rounded to whole dollars"
                        },
                        "total": {
                          "type": "integer",
                          "description": "Canadian dollars, rounded to whole dollars"
                        },
                        "federal": {
                          "type": "object",
                          "properties": {
                            "refundable": {
                              "type": "integer",
                              "description": "Canadian dollars, rounded to whole dollars"
                            },
                            "non_refundable": {
                              "type": "integer",
                              "description": "Canadian dollars, rounded to whole dollars"
                            },
                            "rate_text": {
                              "type": "string"
                            }
                          }
                        },
                        "provincial": {
                          "type": "object",
                          "properties": {
                            "province": {
                              "type": "string"
                            },
                            "credit": {
                              "type": "string"
                            },
                            "refundable": {
                              "type": "integer",
                              "description": "Canadian dollars, rounded to whole dollars"
                            },
                            "non_refundable": {
                              "type": "integer",
                              "description": "Canadian dollars, rounded to whole dollars"
                            },
                            "approximate": {
                              "type": "boolean"
                            },
                            "notes": {
                              "type": "array",
                              "items": {
                                "type": "string"
                              }
                            }
                          }
                        },
                        "spending": {
                          "type": "object",
                          "properties": {
                            "staff_salary": {
                              "type": "integer",
                              "description": "Canadian dollars, rounded to whole dollars"
                            },
                            "owner_salary": {
                              "type": "integer",
                              "description": "Canadian dollars, rounded to whole dollars"
                            },
                            "overhead": {
                              "type": "integer",
                              "description": "Canadian dollars, rounded to whole dollars"
                            },
                            "contractors": {
                              "type": "integer",
                              "description": "Canadian dollars, rounded to whole dollars"
                            },
                            "total": {
                              "type": "integer",
                              "description": "Canadian dollars, rounded to whole dollars"
                            }
                          }
                        },
                        "if_all_time_eligible": {
                          "type": "object",
                          "properties": {
                            "cash_refund": {
                              "type": "integer",
                              "description": "Canadian dollars, rounded to whole dollars"
                            }
                          }
                        }
                      }
                    },
                    "assumptions": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "rules": {
                      "type": "object",
                      "properties": {
                        "tax_year_ending": {
                          "type": "integer"
                        },
                        "checked": {
                          "type": "string",
                          "format": "date"
                        },
                        "sources": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "format": "uri"
                          }
                        }
                      }
                    },
                    "page_url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "disclaimer": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "A parameter is not valid",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error",
                    "parameter",
                    "valid"
                  ],
                  "properties": {
                    "error": {
                      "type": "string"
                    },
                    "parameter": {
                      "type": "string",
                      "enum": [
                        "province",
                        "salaries",
                        "share",
                        "owner",
                        "owner_share",
                        "contractors",
                        "ordtc",
                        "ab_base",
                        "qc_fte",
                        "year"
                      ]
                    },
                    "valid": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/rules": {
      "get": {
        "operationId": "getSredRules",
        "summary": "SR&ED rates and limits for one calendar tax year, and what changed that year",
        "parameters": [
          {
            "name": "year",
            "in": "query",
            "required": false,
            "description": "Tax year whose rates to use: a calendar year, January to December. Valid: 2025, 2026.",
            "schema": {
              "type": "integer",
              "enum": [
                2025,
                2026
              ],
              "default": 2026,
              "description": "Tax year whose rates to use: a calendar year, January to December. Valid: 2025, 2026. Default: 2026."
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The rules for the year",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "api_version": {
                      "type": "string",
                      "const": "v1"
                    },
                    "year": {
                      "type": "integer"
                    },
                    "definition": {
                      "type": "string"
                    },
                    "checked": {
                      "type": "string",
                      "format": "date"
                    },
                    "years_available": {
                      "type": "array",
                      "items": {
                        "type": "integer"
                      },
                      "description": "Newest first"
                    },
                    "federal": {
                      "type": "object",
                      "properties": {
                        "high_rate": {
                          "type": "number"
                        },
                        "low_rate": {
                          "type": "number"
                        },
                        "expenditure_limit": {
                          "type": "number"
                        },
                        "low_refundable_share": {
                          "type": "number"
                        },
                        "rate_text": {
                          "type": "string"
                        },
                        "sources": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "format": "uri"
                          }
                        }
                      }
                    },
                    "salary": {
                      "type": "object",
                      "properties": {
                        "overhead_rate": {
                          "type": "number"
                        },
                        "contract_share": {
                          "type": "number"
                        },
                        "all_time_counts_from_percent": {
                          "type": "number"
                        },
                        "ympe": {
                          "type": "number"
                        },
                        "owner_overhead_share_cap": {
                          "type": "number"
                        },
                        "owner_overhead_base_cap": {
                          "type": "number"
                        },
                        "owner_salary_cap": {
                          "type": "number"
                        }
                      }
                    },
                    "provinces": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "code": {
                            "type": "string"
                          },
                          "name": {
                            "type": "string"
                          },
                          "credit": {
                            "type": "string"
                          },
                          "formula": {
                            "type": "object",
                            "description": "kind plus the numbers that formula uses"
                          },
                          "rate_text": {
                            "type": "string"
                          },
                          "paid_in_cash": {
                            "type": "string"
                          },
                          "approximate": {
                            "type": "boolean"
                          },
                          "notes": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "source": {
                            "type": "string",
                            "format": "uri"
                          },
                          "page_url": {
                            "type": "string",
                            "format": "uri"
                          }
                        }
                      }
                    },
                    "changes": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "note": {
                            "type": "string"
                          },
                          "effective": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "status": {
                            "type": "string",
                            "enum": [
                              "in force",
                              "proposed"
                            ]
                          },
                          "affects_estimate": {
                            "type": "boolean"
                          },
                          "source": {
                            "type": "string",
                            "format": "uri"
                          }
                        }
                      }
                    },
                    "page_url": {
                      "type": "string",
                      "format": "uri"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "The year is not valid",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error",
                    "parameter",
                    "valid"
                  ],
                  "properties": {
                    "error": {
                      "type": "string"
                    },
                    "parameter": {
                      "type": "string",
                      "enum": [
                        "province",
                        "salaries",
                        "share",
                        "owner",
                        "owner_share",
                        "contractors",
                        "ordtc",
                        "ab_base",
                        "qc_fte",
                        "year"
                      ]
                    },
                    "valid": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}