{
  "x402Version": 2,
  "id": 72569,
  "slug": "saylorinnovations-api-health-overdose-deaths",
  "resource": "https://saylorinnovations.com/api/health/overdose-deaths",
  "description": "US drug overdose deaths by state - latest 12-month CDC provisional counts for fentanyl, opioids, heroin, cocaine and meth, with year-on-year change",
  "type": "http",
  "serviceName": "Saylor Innovations Data Desk",
  "mimeType": "application/json",
  "resourceType": "API",
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "payTo": "0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "eip155:137",
      "payTo": "0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa",
      "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "eip155:42161",
      "payTo": "0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa",
      "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "payTo": "7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7",
      "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "payTo": "7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7",
      "asset": "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "payTo": "7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7",
      "asset": "So11111111111111111111111111111111111111112",
      "amount": "95830",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    }
  ],
  "outputSchema": {
    "type": "object",
    "properties": {
      "state": {
        "type": "string",
        "description": "2-letter state code, or US for the national total"
      },
      "state_name": {
        "type": "string",
        "description": "Full jurisdiction name"
      },
      "drug": {
        "type": "string",
        "description": "Drug group requested: all, opioids, synthetic_opioids, heroin, natural_opioids, methadone, cocaine or psychostimulants"
      },
      "drug_label": {
        "type": "string",
        "description": "Plain-language name of that drug group, including the main drug behind it"
      },
      "measure": {
        "type": "string",
        "description": "What each number counts: deaths in the 12 months ending at that month"
      },
      "latest_period_end": {
        "type": "string",
        "description": "Most recent month in the series (YYYY-MM); the 12-month window ends here"
      },
      "latest_deaths": {
        "type": [
          "number",
          "null"
        ],
        "description": "Deaths in the latest 12-month window; the predicted figure when the CDC has one, otherwise the reported count"
      },
      "deaths_year_earlier": {
        "type": [
          "number",
          "null"
        ],
        "description": "The same 12-month count one year before the latest period"
      },
      "change_vs_year_earlier_percent": {
        "type": [
          "number",
          "null"
        ],
        "description": "Percent change of the latest count against a year earlier; negative means deaths fell"
      },
      "data_complete_percent": {
        "type": [
          "number",
          "null"
        ],
        "description": "Share of expected death records already received for the latest period"
      },
      "periods": {
        "type": "number",
        "description": "Number of monthly points returned"
      },
      "series": {
        "type": "array",
        "description": "Monthly points, newest first",
        "items": {
          "type": "object",
          "properties": {
            "period_end": {
              "description": "Month the 12-month window ends (YYYY-MM)",
              "type": [
                "string",
                "null"
              ]
            },
            "reported_deaths": {
              "description": "Count actually received by the CDC; null when suppressed for small numbers",
              "type": [
                "number",
                "null"
              ]
            },
            "predicted_deaths": {
              "description": "CDC estimate adjusted for reports still pending",
              "type": [
                "number",
                "null"
              ]
            },
            "percent_complete": {
              "description": "Share of expected records received for that month",
              "type": [
                "number",
                "null"
              ]
            }
          }
        }
      },
      "note": {
        "type": "string",
        "description": "How to read the figures and when they are suppressed"
      },
      "source": {
        "type": "string",
        "description": "Dataset the numbers come from and its license"
      }
    },
    "required": [
      "state",
      "drug",
      "latest_period_end",
      "series"
    ]
  },
  "extensions": {
    "bazaar": {
      "info": {
        "input": {
          "type": "http",
          "method": "GET",
          "queryParams": {
            "drug": "synthetic_opioids",
            "months": "6",
            "state": "TX"
          }
        },
        "output": {
          "type": "json",
          "example": {
            "state": "TX",
            "state_name": "Texas",
            "drug": "synthetic_opioids",
            "drug_label": "Synthetic opioids excluding methadone (mostly illicit fentanyl)",
            "measure": "12-month-ending provisional count of deaths",
            "latest_period_end": "2026-05",
            "latest_deaths": 1301,
            "deaths_year_earlier": 1512,
            "change_vs_year_earlier_percent": -14,
            "data_complete_percent": 100,
            "periods": 6,
            "series": [
              {
                "period_end": "2026-05",
                "reported_deaths": 1281,
                "predicted_deaths": 1301,
                "percent_complete": 100
              },
              {
                "period_end": "2026-04",
                "reported_deaths": 1349,
                "predicted_deaths": 1363,
                "percent_complete": 100
              },
              {
                "period_end": "2026-03",
                "reported_deaths": 1376,
                "predicted_deaths": 1386,
                "percent_complete": 100
              },
              {
                "period_end": "2026-02",
                "reported_deaths": 1421,
                "predicted_deaths": 1426,
                "percent_complete": 100
              },
              {
                "period_end": "2026-01",
                "reported_deaths": 1403,
                "predicted_deaths": 1404,
                "percent_complete": 100
              },
              {
                "period_end": "2025-12",
                "reported_deaths": 1421,
                "predicted_deaths": 1421,
                "percent_complete": 100
              }
            ],
            "note": "Provisional counts from the CDC VSRR system. predicted_deaths adjusts for reports still pending; reported_deaths is the count actually received. Counts can be suppressed (null) for small numbers.",
            "source": "CDC NCHS, VSRR Provisional Drug Overdose Death Counts (data.cdc.gov dataset xkb8-kh2a), public domain"
          }
        }
      },
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "type": "object",
        "properties": {
          "input": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "const": "http"
              },
              "method": {
                "type": "string",
                "enum": [
                  "GET"
                ]
              },
              "queryParams": {
                "type": "object",
                "properties": {
                  "drug": {
                    "type": "string",
                    "description": "optional all (default), opioids, synthetic_opioids, heroin, natural_opioids, methadone, cocaine or psychostimulants"
                  },
                  "months": {
                    "type": "string",
                    "description": "optional number of most recent monthly points, 1-60, default 12"
                  },
                  "state": {
                    "type": "string",
                    "description": "optional US state as TX or Texas, or US for the national total (default US)"
                  }
                }
              }
            },
            "required": [
              "type",
              "method"
            ],
            "additionalProperties": false
          },
          "output": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "const": "json"
              },
              "example": {
                "type": "object",
                "properties": {
                  "state": {
                    "type": "string",
                    "description": "2-letter state code, or US for the national total"
                  },
                  "state_name": {
                    "type": "string",
                    "description": "Full jurisdiction name"
                  },
                  "drug": {
                    "type": "string",
                    "description": "Drug group requested: all, opioids, synthetic_opioids, heroin, natural_opioids, methadone, cocaine or psychostimulants"
                  },
                  "drug_label": {
                    "type": "string",
                    "description": "Plain-language name of that drug group, including the main drug behind it"
                  },
                  "measure": {
                    "type": "string",
                    "description": "What each number counts: deaths in the 12 months ending at that month"
                  },
                  "latest_period_end": {
                    "type": "string",
                    "description": "Most recent month in the series (YYYY-MM); the 12-month window ends here"
                  },
                  "latest_deaths": {
                    "type": [
                      "number",
                      "null"
                    ],
                    "description": "Deaths in the latest 12-month window; the predicted figure when the CDC has one, otherwise the reported count"
                  },
                  "deaths_year_earlier": {
                    "type": [
                      "number",
                      "null"
                    ],
                    "description": "The same 12-month count one year before the latest period"
                  },
                  "change_vs_year_earlier_percent": {
                    "type": [
                      "number",
                      "null"
                    ],
                    "description": "Percent change of the latest count against a year earlier; negative means deaths fell"
                  },
                  "data_complete_percent": {
                    "type": [
                      "number",
                      "null"
                    ],
                    "description": "Share of expected death records already received for the latest period"
                  },
                  "periods": {
                    "type": "number",
                    "description": "Number of monthly points returned"
                  },
                  "series": {
                    "type": "array",
                    "description": "Monthly points, newest first",
                    "items": {
                      "type": "object",
                      "properties": {
                        "period_end": {
                          "description": "Month the 12-month window ends (YYYY-MM)",
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "reported_deaths": {
                          "description": "Count actually received by the CDC; null when suppressed for small numbers",
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "predicted_deaths": {
                          "description": "CDC estimate adjusted for reports still pending",
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "percent_complete": {
                          "description": "Share of expected records received for that month",
                          "type": [
                            "number",
                            "null"
                          ]
                        }
                      }
                    }
                  },
                  "note": {
                    "type": "string",
                    "description": "How to read the figures and when they are suppressed"
                  },
                  "source": {
                    "type": "string",
                    "description": "Dataset the numbers come from and its license"
                  }
                },
                "required": [
                  "state",
                  "drug",
                  "latest_period_end",
                  "series"
                ]
              }
            },
            "required": [
              "type"
            ]
          }
        },
        "required": [
          "input"
        ]
      }
    }
  },
  "tags": [
    "fentanyl deaths by state",
    "drug overdose deaths 2026",
    "opioid deaths per year",
    "cdc overdose statistics",
    "overdose deaths texas"
  ],
  "sourceHost": "saylorinnovations.com",
  "lastUpdated": "2026-10-26T22:14:01.962Z",
  "quality": {},
  "metadata": {
    "serviceName": "Saylor Innovations Data Desk",
    "method": "GET",
    "mimeType": "application/json",
    "inputSchema": {
      "type": "object",
      "properties": {
        "drug": {
          "type": "string",
          "description": "optional all (default), opioids, synthetic_opioids, heroin, natural_opioids, methadone, cocaine or psychostimulants"
        },
        "months": {
          "type": "string",
          "description": "optional number of most recent monthly points, 1-60, default 12"
        },
        "state": {
          "type": "string",
          "description": "optional US state as TX or Texas, or US for the national total (default US)"
        }
      },
      "required": []
    },
    "exampleResponse": {
      "state": "TX",
      "state_name": "Texas",
      "drug": "synthetic_opioids",
      "drug_label": "Synthetic opioids excluding methadone (mostly illicit fentanyl)",
      "measure": "12-month-ending provisional count of deaths",
      "latest_period_end": "2026-05",
      "latest_deaths": 1301,
      "deaths_year_earlier": 1512,
      "change_vs_year_earlier_percent": -14,
      "data_complete_percent": 100,
      "periods": 6,
      "series": [
        {
          "period_end": "2026-05",
          "reported_deaths": 1281,
          "predicted_deaths": 1301,
          "percent_complete": 100
        },
        {
          "period_end": "2026-04",
          "reported_deaths": 1349,
          "predicted_deaths": 1363,
          "percent_complete": 100
        },
        {
          "period_end": "2026-03",
          "reported_deaths": 1376,
          "predicted_deaths": 1386,
          "percent_complete": 100
        },
        {
          "period_end": "2026-02",
          "reported_deaths": 1421,
          "predicted_deaths": 1426,
          "percent_complete": 100
        },
        {
          "period_end": "2026-01",
          "reported_deaths": 1403,
          "predicted_deaths": 1404,
          "percent_complete": 100
        },
        {
          "period_end": "2025-12",
          "reported_deaths": 1421,
          "predicted_deaths": 1421,
          "percent_complete": 100
        }
      ],
      "note": "Provisional counts from the CDC VSRR system. predicted_deaths adjusts for reports still pending; reported_deaths is the count actually received. Counts can be suppressed (null) for small numbers.",
      "source": "CDC NCHS, VSRR Provisional Drug Overdose Death Counts (data.cdc.gov dataset xkb8-kh2a), public domain"
    },
    "parameterLocation": "query",
    "extensions": {
      "bazaar": {
        "info": {
          "input": {
            "type": "http",
            "method": "GET",
            "queryParams": {
              "drug": "synthetic_opioids",
              "months": "6",
              "state": "TX"
            }
          },
          "output": {
            "type": "json",
            "example": {
              "state": "TX",
              "state_name": "Texas",
              "drug": "synthetic_opioids",
              "drug_label": "Synthetic opioids excluding methadone (mostly illicit fentanyl)",
              "measure": "12-month-ending provisional count of deaths",
              "latest_period_end": "2026-05",
              "latest_deaths": 1301,
              "deaths_year_earlier": 1512,
              "change_vs_year_earlier_percent": -14,
              "data_complete_percent": 100,
              "periods": 6,
              "series": [
                {
                  "period_end": "2026-05",
                  "reported_deaths": 1281,
                  "predicted_deaths": 1301,
                  "percent_complete": 100
                },
                {
                  "period_end": "2026-04",
                  "reported_deaths": 1349,
                  "predicted_deaths": 1363,
                  "percent_complete": 100
                },
                {
                  "period_end": "2026-03",
                  "reported_deaths": 1376,
                  "predicted_deaths": 1386,
                  "percent_complete": 100
                },
                {
                  "period_end": "2026-02",
                  "reported_deaths": 1421,
                  "predicted_deaths": 1426,
                  "percent_complete": 100
                },
                {
                  "period_end": "2026-01",
                  "reported_deaths": 1403,
                  "predicted_deaths": 1404,
                  "percent_complete": 100
                },
                {
                  "period_end": "2025-12",
                  "reported_deaths": 1421,
                  "predicted_deaths": 1421,
                  "percent_complete": 100
                }
              ],
              "note": "Provisional counts from the CDC VSRR system. predicted_deaths adjusts for reports still pending; reported_deaths is the count actually received. Counts can be suppressed (null) for small numbers.",
              "source": "CDC NCHS, VSRR Provisional Drug Overdose Death Counts (data.cdc.gov dataset xkb8-kh2a), public domain"
            }
          }
        },
        "schema": {
          "$schema": "https://json-schema.org/draft/2020-12/schema",
          "type": "object",
          "properties": {
            "input": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "const": "http"
                },
                "method": {
                  "type": "string",
                  "enum": [
                    "GET"
                  ]
                },
                "queryParams": {
                  "type": "object",
                  "properties": {
                    "drug": {
                      "type": "string",
                      "description": "optional all (default), opioids, synthetic_opioids, heroin, natural_opioids, methadone, cocaine or psychostimulants"
                    },
                    "months": {
                      "type": "string",
                      "description": "optional number of most recent monthly points, 1-60, default 12"
                    },
                    "state": {
                      "type": "string",
                      "description": "optional US state as TX or Texas, or US for the national total (default US)"
                    }
                  }
                }
              },
              "required": [
                "type",
                "method"
              ],
              "additionalProperties": false
            },
            "output": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "const": "json"
                },
                "example": {
                  "type": "object",
                  "properties": {
                    "state": {
                      "type": "string",
                      "description": "2-letter state code, or US for the national total"
                    },
                    "state_name": {
                      "type": "string",
                      "description": "Full jurisdiction name"
                    },
                    "drug": {
                      "type": "string",
                      "description": "Drug group requested: all, opioids, synthetic_opioids, heroin, natural_opioids, methadone, cocaine or psychostimulants"
                    },
                    "drug_label": {
                      "type": "string",
                      "description": "Plain-language name of that drug group, including the main drug behind it"
                    },
                    "measure": {
                      "type": "string",
                      "description": "What each number counts: deaths in the 12 months ending at that month"
                    },
                    "latest_period_end": {
                      "type": "string",
                      "description": "Most recent month in the series (YYYY-MM); the 12-month window ends here"
                    },
                    "latest_deaths": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "Deaths in the latest 12-month window; the predicted figure when the CDC has one, otherwise the reported count"
                    },
                    "deaths_year_earlier": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "The same 12-month count one year before the latest period"
                    },
                    "change_vs_year_earlier_percent": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "Percent change of the latest count against a year earlier; negative means deaths fell"
                    },
                    "data_complete_percent": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "Share of expected death records already received for the latest period"
                    },
                    "periods": {
                      "type": "number",
                      "description": "Number of monthly points returned"
                    },
                    "series": {
                      "type": "array",
                      "description": "Monthly points, newest first",
                      "items": {
                        "type": "object",
                        "properties": {
                          "period_end": {
                            "description": "Month the 12-month window ends (YYYY-MM)",
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "reported_deaths": {
                            "description": "Count actually received by the CDC; null when suppressed for small numbers",
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "predicted_deaths": {
                            "description": "CDC estimate adjusted for reports still pending",
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "percent_complete": {
                            "description": "Share of expected records received for that month",
                            "type": [
                              "number",
                              "null"
                            ]
                          }
                        }
                      }
                    },
                    "note": {
                      "type": "string",
                      "description": "How to read the figures and when they are suppressed"
                    },
                    "source": {
                      "type": "string",
                      "description": "Dataset the numbers come from and its license"
                    }
                  },
                  "required": [
                    "state",
                    "drug",
                    "latest_period_end",
                    "series"
                  ]
                }
              },
              "required": [
                "type"
              ]
            }
          },
          "required": [
            "input"
          ]
        }
      }
    },
    "examples": [
      {
        "label": "Unpaid discovery call",
        "method": "GET",
        "url": "https://saylorinnovations.com/api/health/overdose-deaths?state=TX&drug=synthetic_opioids&months=6",
        "expectedStatus": 402
      }
    ],
    "cacheTtlSeconds": 0,
    "capabilities": [],
    "noAccountRequired": true,
    "noApiKeyRequired": true,
    "sideEffects": "Paid calls settle the advertised payment; see the provider contract for execution behavior.",
    "payment": {
      "protocol": "x402",
      "settlement": "direct-to-provider"
    },
    "provider": {
      "name": "Saylor Innovations",
      "host": "saylorinnovations.com",
      "manifestUrl": "https://saylorinnovations.com/.well-known/x402.json"
    }
  },
  "liveness": {
    "reliability": null
  },
  "verified": true,
  "featured": false,
  "provider": {
    "host": "saylorinnovations.com",
    "manifest_name": "Saylor Innovations Knowledge Base",
    "source": "submitted",
    "source_manifest_url": "https://saylorinnovations.com/.well-known/x402.json",
    "submitted_at": "2026-10-26T05:52:02.113Z"
  },
  "exampleResponse": {
    "state": "string",
    "state_name": "string",
    "drug": "string",
    "drug_label": "string",
    "measure": "string",
    "latest_period_end": "string",
    "latest_deaths": 0,
    "deaths_year_earlier": 0,
    "change_vs_year_earlier_percent": 0,
    "data_complete_percent": 0,
    "periods": 0,
    "series": [
      {
        "period_end": "string",
        "reported_deaths": 0,
        "predicted_deaths": 0,
        "percent_complete": 0
      }
    ],
    "note": "string",
    "source": "string"
  }
}