---
title: "Get latest algorithm data (code, binarys and advances)"
method: GET
path: "/get-algorithms"
tags: ["GET"]
---

# Get latest algorithm data (code, binarys and advances)

`GET /get-algorithms`

# Notes

* Query parameter `<block_id>` must be the latest block. Use `/get-block` endpoint
  
* `player_details` is a map of `<player_id>` to `PlayerDetails`

## Query parameters

- `block_id` string, required

## Response `200`

Success

- GetAlgorithmsResponse
  - `codes` Code[]
    - `id` string
    - `details` CodeDetails
      - `name` string
      - `player_id` string
      - `challenge_id` string
      - `algorithm_id` string
      - `fee_paid` string
    - `state` CodeState
      - `block_confirmed` integer
      - `round_submitted` integer
      - `round_pushed` integer
      - `round_merged` integer
      - `round_active` integer
      - `banned` boolean
    - `block_data` CodeBlockData
      - `num_qualifiers_by_track_by_player` object
      - `adoption` string
      - `merge_points` integer
      - `reward` string
  - `advances` Advance[]
    - `id` string
    - `details` AdvanceDetails
      - `name` string
      - `player_id` string
      - `challenge_id` string
    - `state` AdvanceState
      - `block_confirmed` integer
      - `round_submitted` integer
      - `round_pushed` integer
      - `round_voting_starts` integer
      - `round_votes_tallied` integer
      - `round_active` integer
      - `round_merged` integer
      - `vote_tally` object
        - `true` string
        - `false` string
    - `block_data` AdvanceBlockData
      - `adoption` string
      - `merge_points` integer
      - `reward` string
  - `binarys` Binary[]
    - `algorithm_id` string
    - `details` BinaryDetails
      - `compile_success` boolean
      - `download_url` string
    - `state` BinaryState
      - `block_confirmed` integer
  - `player_details` object — Map of player_id to PlayerDetails

## Changes

- **2026-02-03** `4c20b89cfdc4` — 1 warning, 1 info
  - removed the optional property `names` from the response with the `200` status
  - added the optional property `player_details` to the response with the `200` status
- **2025-12-05** `fcaa8927a4ae` — 1 warning, 1 info
  - removed the optional property `codes/items/block_data/num_qualifiers_by_player` from the response with the `200` status
  - added the optional property `codes/items/block_data/num_qualifiers_by_track_by_player` to the response with the `200` status
- **2025-08-22** `1b7c2b8a974d` — 2 warning, 3 info
  - removed the optional property `algorithms` from the response with the `200` status
  - removed the optional property `binaries` from the response with the `200` status
  - added the optional property `binarys` to the response with the `200` status
  - added the optional property `codes` to the response with the `200` status
  - …1 more
- **2025-08-13** `91a72967eb11` — 1 breaking
  - the `codes/items/block_data/num_qualifiers_by_player/additionalProperties/` response's property type/format changed from `integer`/`uint32` to `integer`/`uint64` for status `200`
- …earlier changes not shown

[Full history](https://skmtc.dev/tig-foundation/apis/the-innovation-game-api/changes/get-algorithms/get.md)

---

[API](https://skmtc.dev/tig-foundation/apis/the-innovation-game-api.md) · [All operations](https://skmtc.dev/tig-foundation/apis/the-innovation-game-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tig-foundation/the-innovation-game-api/revisions/2af9c398c1d4/schema)