HHS (US Department of Health and Human Services)

HHS (US Department of Health and Human Services) User v1 - Internal Only API

The User v1 - Internal Only API from HHS (US Department of Health and Human Services) — 23 operation(s) for user v1 - internal only.

GitHub OpenAPI

Operations 26

GET /v1/users/login User Login #
POST /v1/users/token/logout User Token Logout #
POST /v1/users/token/refresh User Token Refresh #
GET /v1/users/{user_id} User Get #
PUT /v1/users/{user_id}/profile Update the authenticated user's profile data' #
POST /v1/users/{user_id}/agencies User Get Agencies #
POST /v1/users/{user_id}/api-keys Create a new API key for the authenticated user #
POST /v1/users/{user_id}/privileges Get the roles and privileges for the authenticated user #
POST /v1/users/{user_id}/can_access Check user access for a given resource #
POST /v1/users/{user_id}/applications Get all applications for a user #
GET /v1/users/{user_id}/organizations User Get Organizations #
POST /v1/users/{user_id}/api-keys/list List all API keys for the authenticated user #
POST /v1/users/{user_id}/saved-searches User Save Search #
POST /v1/users/{user_id}/invitations/list Get all invitations for a user by matching their login.gov email #
POST /v1/users/{user_id}/saved-opportunities User Save Opportunity #
POST /v1/users/{user_id}/saved-searches/list User Get Saved Searches #
POST /v1/users/{user_id}/saved-opportunities/list User Get Saved Opportunities #
PUT /v1/users/{user_id}/api-keys/{api_key_id} Rename an existing API key for the authenticated user #
DELETE /v1/users/{user_id}/api-keys/{api_key_id} Delete (deactivate) an API key for the authenticated user #
GET /v1/users/{user_id}/saved-opportunities/notifications User Get Saved Opportunity Notifications #
POST /v1/users/{user_id}/saved-opportunities/notifications User Saved Opportunities Notifications #
PUT /v1/users/{user_id}/saved-searches/{saved_search_id} User Update Saved Search #
DELETE /v1/users/{user_id}/saved-searches/{saved_search_id} User Delete Saved Search #
DELETE /v1/users/{user_id}/saved-opportunities/{opportunity_id} User Delete Saved Opportunity #
POST /v1/users/{user_id}/invitations/{invitation_id}/organizations User Response Org Invitation #
DELETE /v1/users/{user_id}/saved-opportunities/{legacy_opportunity_id} User Delete Saved Opportunity Legacy #

Documentation

📖
Documentation
https://simpler.grants.gov/developers
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/hhs/refs/heads/main/rate-limits/simpler-grants.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/hhs/refs/heads/main/openapi/hhs-user-v1-internal-only-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/hhs/refs/heads/main/json-schema/opportunityv1.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/hhs/refs/heads/main/json-schema/opportunitysearchresponsev1.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/hhs/refs/heads/main/json-schema/agencyv1.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/hhs/refs/heads/main/json-schema/errorresponse.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/hhs/refs/heads/main/json-schema/paginationinfo.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/hhs/refs/heads/main/json-schema/healthcheckresponse.json

Other Resources

🔗
OpenAPISpec
https://raw.githubusercontent.com/api-evangelist/hhs/refs/heads/main/openapi/_original/simpler-grants-gov.yml
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/hhs/refs/heads/main/examples/v1_opportunities_search_post_request.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/hhs/refs/heads/main/examples/v1_agencies_search_post_request.json
🔗
JSONLDContext
https://raw.githubusercontent.com/api-evangelist/hhs/refs/heads/main/json-ld/context.json
🔗
Plans
https://raw.githubusercontent.com/api-evangelist/hhs/refs/heads/main/plans/simpler-grants.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/hhs-user-v1-internal-only-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

hhs-user-v1-internal-only-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  description: 'Back end API for simpler.grants.gov.


    This API is in active development as we build out new functionalities for Simpler.Grants.gov. It is currently stable for everyday use, and will be versioned with advance notice for any breaking changes.


    Learn more in our API documentation.

    See Release Phases for further details.'
  contact:
    name: Simpler Grants.gov
    url: https://simpler.grants.gov/
    email: simpler@grants.gov
  title: Simpler Grants User v1 - Internal Only API
  version: v0
servers: .
tags:


# --- truncated at 32 KB (90 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/hhs/refs/heads/main/openapi/hhs-user-v1-internal-only-api-openapi.yml