Cancer.gov

Cancer.gov Recode API

Recode algorithms

Documentation GitHub OpenAPI

Operations 2

GET /rest/recode/sitegroup/{algorithm} Return the site group for the site/histology/behavior combination based on a… #

GET /rest/recode/sitegroup/algorithms Return the supported site group algorithms and versions #

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/cancer-gov-recode-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

openapi: 3.2.0
info:
  title: SEER* Recode API
  description: 'SEER API is a RESTful Web service that supports various SEER Program data sets and mapping.


    This service is available to developers who wish to incorporate SEER resources into their own systems. These resources

    include databases and tools developed to enhance registry operations and quality improvement. The SEER API is designed

    for integration into registry computer systems and is not designed to be accessed by end-users.'
  termsOfService: /terms
  version: '1.0'
servers:
- url: https://api.seer.cancer.gov
  description: Generated server url
security:
- apiKeyScheme: []
tags:
- name: recode
  description: Recode algorithms
paths:
  /rest/recode/sitegroup/{algorithm}:
    get:
      tags:
      - recode
      summary: Return the site group for the site/histology/behavior combination based on a…
      description: 'Supported algorithms are SEER Site Recode (''seer''), International Classification of Childhood Cancer (''iccc'') and Adolescents and Young Adults (AYA) Site Recode (''aya'').


        If no algorithm is supplied it will default to ''seer''.'
      operationId: getSiteGroup
      parameters:
      - name: algorithm
        in: path
        description: Recode algorithm ('seer', 'iccc' or 'aya'); defaults to 'seer' if not provided
        required: true
        schema:
          type: string
      - name: site
        in: query
        description: Primary site
        required: true
        schema:
          type: string
      - name: hist
        in: query
        description: Histology
        required: true
        schema:
          type: string
      - name: behavior
        in: query
        description: Behavior
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SiteRecode'
        '400':
          description: Missing or invalid input
  /rest/recode/sitegroup/algorithms:
    get:
      tags:
      - recode
      summary: Return the supported site group algorithms and versions
      operationId: getSiteRecodeAlgorithms
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SiteGroupAlgorithm'
components:
  schemas:
    SiteRecode:
      type: object
      properties:
        site:
          type: string
        hist:
          type: string
        behavior:
          type: string
        site_group:
          type: string
    SiteGroupAlgorithm:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        version:
          type: string
        required_input:
          type: array
          items:
            type: string
  securitySchemes:
    apiKeyScheme:
      type: apiKey
      name: X-SEERAPI-Key
      in: header