{
  "x402Version": 2,
  "id": 72572,
  "slug": "saylorinnovations-api-health-life-expectancy",
  "resource": "https://saylorinnovations.com/api/health/life-expectancy",
  "description": "US life expectancy at birth by year since 1900, by sex and race - years, death rate per 100,000, peak year and change over any period (CDC)",
  "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": {
      "race": {
        "type": "string",
        "description": "Population group: All Races, White or Black"
      },
      "sex": {
        "type": "string",
        "description": "Both Sexes, Male or Female"
      },
      "from_year": {
        "type": "number",
        "description": "First year returned"
      },
      "to_year": {
        "type": "number",
        "description": "Last year returned"
      },
      "points": {
        "type": "number",
        "description": "Number of yearly points"
      },
      "start_life_expectancy_years": {
        "type": "number",
        "description": "Life expectancy at birth in the first year"
      },
      "latest_life_expectancy_years": {
        "type": "number",
        "description": "Life expectancy at birth in the last year"
      },
      "change_years": {
        "type": "number",
        "description": "Years gained or lost between first and last year"
      },
      "peak_year": {
        "type": "number",
        "description": "Year with the highest life expectancy in the range"
      },
      "peak_life_expectancy_years": {
        "type": "number",
        "description": "Life expectancy in that peak year"
      },
      "series": {
        "type": "array",
        "description": "Yearly points, oldest first",
        "items": {
          "type": "object",
          "properties": {
            "year": {
              "description": "Calendar year",
              "type": [
                "number",
                "null"
              ]
            },
            "life_expectancy_years": {
              "description": "Average years a newborn is expected to live",
              "type": [
                "number",
                "null"
              ]
            },
            "death_rate_per_100k": {
              "description": "Age-adjusted death rate per 100,000 people",
              "type": [
                "number",
                "null"
              ]
            }
          }
        }
      },
      "note": {
        "type": "string",
        "description": "What the figures mean and where the series ends"
      },
      "source": {
        "type": "string",
        "description": "Dataset the numbers come from and its license"
      }
    },
    "required": [
      "race",
      "sex",
      "series"
    ]
  },
  "extensions": {
    "bazaar": {
      "info": {
        "input": {
          "type": "http",
          "method": "GET",
          "queryParams": {
            "from": "2000",
            "sex": "female",
            "to": "2018"
          }
        },
        "output": {
          "type": "json",
          "example": {
            "race": "All Races",
            "sex": "Female",
            "from_year": 2000,
            "to_year": 2018,
            "points": 19,
            "start_life_expectancy_years": 79.7,
            "latest_life_expectancy_years": 81.2,
            "change_years": 1.5,
            "peak_year": 2014,
            "peak_life_expectancy_years": 81.3,
            "series": [
              {
                "year": 2000,
                "life_expectancy_years": 79.7,
                "death_rate_per_100k": 731.4
              },
              {
                "year": 2001,
                "life_expectancy_years": 79.5,
                "death_rate_per_100k": 725.6
              },
              {
                "year": 2002,
                "life_expectancy_years": 79.6,
                "death_rate_per_100k": 723.6
              }
            ],
            "note": "Life expectancy at birth in years and the age-adjusted death rate per 100,000 for the US population. The CDC series stops at 2018.",
            "source": "CDC NCHS, Death rates and life expectancy at birth (data.cdc.gov dataset w9j2-ggv5), 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": {
                  "from": {
                    "type": "string",
                    "description": "optional first year, 1900-2018, default 1950"
                  },
                  "sex": {
                    "type": "string",
                    "description": "optional both (default), male or female"
                  },
                  "to": {
                    "type": "string",
                    "description": "optional last year, 1900-2018, default 2018"
                  }
                }
              }
            },
            "required": [
              "type",
              "method"
            ],
            "additionalProperties": false
          },
          "output": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "const": "json"
              },
              "example": {
                "type": "object",
                "properties": {
                  "race": {
                    "type": "string",
                    "description": "Population group: All Races, White or Black"
                  },
                  "sex": {
                    "type": "string",
                    "description": "Both Sexes, Male or Female"
                  },
                  "from_year": {
                    "type": "number",
                    "description": "First year returned"
                  },
                  "to_year": {
                    "type": "number",
                    "description": "Last year returned"
                  },
                  "points": {
                    "type": "number",
                    "description": "Number of yearly points"
                  },
                  "start_life_expectancy_years": {
                    "type": "number",
                    "description": "Life expectancy at birth in the first year"
                  },
                  "latest_life_expectancy_years": {
                    "type": "number",
                    "description": "Life expectancy at birth in the last year"
                  },
                  "change_years": {
                    "type": "number",
                    "description": "Years gained or lost between first and last year"
                  },
                  "peak_year": {
                    "type": "number",
                    "description": "Year with the highest life expectancy in the range"
                  },
                  "peak_life_expectancy_years": {
                    "type": "number",
                    "description": "Life expectancy in that peak year"
                  },
                  "series": {
                    "type": "array",
                    "description": "Yearly points, oldest first",
                    "items": {
                      "type": "object",
                      "properties": {
                        "year": {
                          "description": "Calendar year",
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "life_expectancy_years": {
                          "description": "Average years a newborn is expected to live",
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "death_rate_per_100k": {
                          "description": "Age-adjusted death rate per 100,000 people",
                          "type": [
                            "number",
                            "null"
                          ]
                        }
                      }
                    }
                  },
                  "note": {
                    "type": "string",
                    "description": "What the figures mean and where the series ends"
                  },
                  "source": {
                    "type": "string",
                    "description": "Dataset the numbers come from and its license"
                  }
                },
                "required": [
                  "race",
                  "sex",
                  "series"
                ]
              }
            },
            "required": [
              "type"
            ]
          }
        },
        "required": [
          "input"
        ]
      }
    }
  },
  "tags": [
    "us life expectancy history",
    "life expectancy by year",
    "life expectancy men vs women",
    "average lifespan united states",
    "death rate by year"
  ],
  "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": {
        "from": {
          "type": "string",
          "description": "optional first year, 1900-2018, default 1950"
        },
        "sex": {
          "type": "string",
          "description": "optional both (default), male or female"
        },
        "to": {
          "type": "string",
          "description": "optional last year, 1900-2018, default 2018"
        }
      },
      "required": []
    },
    "exampleResponse": {
      "race": "All Races",
      "sex": "Female",
      "from_year": 2000,
      "to_year": 2018,
      "points": 19,
      "start_life_expectancy_years": 79.7,
      "latest_life_expectancy_years": 81.2,
      "change_years": 1.5,
      "peak_year": 2014,
      "peak_life_expectancy_years": 81.3,
      "series": [
        {
          "year": 2000,
          "life_expectancy_years": 79.7,
          "death_rate_per_100k": 731.4
        },
        {
          "year": 2001,
          "life_expectancy_years": 79.5,
          "death_rate_per_100k": 725.6
        },
        {
          "year": 2002,
          "life_expectancy_years": 79.6,
          "death_rate_per_100k": 723.6
        }
      ],
      "note": "Life expectancy at birth in years and the age-adjusted death rate per 100,000 for the US population. The CDC series stops at 2018.",
      "source": "CDC NCHS, Death rates and life expectancy at birth (data.cdc.gov dataset w9j2-ggv5), public domain"
    },
    "parameterLocation": "query",
    "extensions": {
      "bazaar": {
        "info": {
          "input": {
            "type": "http",
            "method": "GET",
            "queryParams": {
              "from": "2000",
              "sex": "female",
              "to": "2018"
            }
          },
          "output": {
            "type": "json",
            "example": {
              "race": "All Races",
              "sex": "Female",
              "from_year": 2000,
              "to_year": 2018,
              "points": 19,
              "start_life_expectancy_years": 79.7,
              "latest_life_expectancy_years": 81.2,
              "change_years": 1.5,
              "peak_year": 2014,
              "peak_life_expectancy_years": 81.3,
              "series": [
                {
                  "year": 2000,
                  "life_expectancy_years": 79.7,
                  "death_rate_per_100k": 731.4
                },
                {
                  "year": 2001,
                  "life_expectancy_years": 79.5,
                  "death_rate_per_100k": 725.6
                },
                {
                  "year": 2002,
                  "life_expectancy_years": 79.6,
                  "death_rate_per_100k": 723.6
                }
              ],
              "note": "Life expectancy at birth in years and the age-adjusted death rate per 100,000 for the US population. The CDC series stops at 2018.",
              "source": "CDC NCHS, Death rates and life expectancy at birth (data.cdc.gov dataset w9j2-ggv5), 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": {
                    "from": {
                      "type": "string",
                      "description": "optional first year, 1900-2018, default 1950"
                    },
                    "sex": {
                      "type": "string",
                      "description": "optional both (default), male or female"
                    },
                    "to": {
                      "type": "string",
                      "description": "optional last year, 1900-2018, default 2018"
                    }
                  }
                }
              },
              "required": [
                "type",
                "method"
              ],
              "additionalProperties": false
            },
            "output": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "const": "json"
                },
                "example": {
                  "type": "object",
                  "properties": {
                    "race": {
                      "type": "string",
                      "description": "Population group: All Races, White or Black"
                    },
                    "sex": {
                      "type": "string",
                      "description": "Both Sexes, Male or Female"
                    },
                    "from_year": {
                      "type": "number",
                      "description": "First year returned"
                    },
                    "to_year": {
                      "type": "number",
                      "description": "Last year returned"
                    },
                    "points": {
                      "type": "number",
                      "description": "Number of yearly points"
                    },
                    "start_life_expectancy_years": {
                      "type": "number",
                      "description": "Life expectancy at birth in the first year"
                    },
                    "latest_life_expectancy_years": {
                      "type": "number",
                      "description": "Life expectancy at birth in the last year"
                    },
                    "change_years": {
                      "type": "number",
                      "description": "Years gained or lost between first and last year"
                    },
                    "peak_year": {
                      "type": "number",
                      "description": "Year with the highest life expectancy in the range"
                    },
                    "peak_life_expectancy_years": {
                      "type": "number",
                      "description": "Life expectancy in that peak year"
                    },
                    "series": {
                      "type": "array",
                      "description": "Yearly points, oldest first",
                      "items": {
                        "type": "object",
                        "properties": {
                          "year": {
                            "description": "Calendar year",
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "life_expectancy_years": {
                            "description": "Average years a newborn is expected to live",
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "death_rate_per_100k": {
                            "description": "Age-adjusted death rate per 100,000 people",
                            "type": [
                              "number",
                              "null"
                            ]
                          }
                        }
                      }
                    },
                    "note": {
                      "type": "string",
                      "description": "What the figures mean and where the series ends"
                    },
                    "source": {
                      "type": "string",
                      "description": "Dataset the numbers come from and its license"
                    }
                  },
                  "required": [
                    "race",
                    "sex",
                    "series"
                  ]
                }
              },
              "required": [
                "type"
              ]
            }
          },
          "required": [
            "input"
          ]
        }
      }
    },
    "examples": [
      {
        "label": "Unpaid discovery call",
        "method": "GET",
        "url": "https://saylorinnovations.com/api/health/life-expectancy?sex=female&from=2000&to=2018",
        "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": {
    "race": "string",
    "sex": "string",
    "from_year": 0,
    "to_year": 0,
    "points": 0,
    "start_life_expectancy_years": 0,
    "latest_life_expectancy_years": 0,
    "change_years": 0,
    "peak_year": 0,
    "peak_life_expectancy_years": 0,
    "series": [
      {
        "year": 0,
        "life_expectancy_years": 0,
        "death_rate_per_100k": 0
      }
    ],
    "note": "string",
    "source": "string"
  }
}