---
title: "Get Blocks From Bluescore"
method: GET
path: "/blocks-from-bluescore"
tags: ["Kaspa blocks"]
---

# Get Blocks From Bluescore

`GET /blocks-from-bluescore`

Lists blocks based on blueScore. Exactly one of blueScore, blueScoreGte, or blueScoreLt must be provided.

## Query parameters

- `blueScore` integer
- `blueScoreGte` integer
- `blueScoreLt` integer
- `includeTransactions` boolean

## Response `200`

Successful Response

- BlockModel[]
  - `header` EndpointsGetBlocksBlockHeader, required
    - `version` integer
    - `hashMerkleRoot` string
    - `acceptedIdMerkleRoot` string
    - `utxoCommitment` string
    - `timestamp` string
    - `bits` integer
    - `nonce` string
    - `daaScore` string
    - `blueWork` string
    - `parents` ParentHashModel[]
      - `parentHashes` string[]
    - `blueScore` string
    - `pruningPoint` string
  - `transactions` BlockTxModel[]
    - `inputs` BlockTxInputModel[]
      - `previousOutpoint` BlockTxInputPreviousOutpointModel
        - `transactionId` string, required
        - `index` integer, required
      - `signatureScript` string
      - `sigOpCount` integer
      - `sequence` integer
      - `computeBudget` integer
    - `outputs` BlockTxOutputModel[]
      - `amount` integer
      - `scriptPublicKey` BlockTxOutputScriptPublicKeyModel
        - `scriptPublicKey` string
        - `version` integer
      - `verboseData` BlockTxOutputVerboseDataModel
        - `scriptPublicKeyType` string
        - `scriptPublicKeyAddress` string
      - `covenant` BlockTxOutputCovenantModel
        - `authorizingInput` integer
        - `covenantId` string
    - `subnetworkId` string
    - `payload` string
    - `verboseData` BlockTxVerboseDataModel, required
      - `transactionId` string, required
      - `hash` string
      - `computeMass` integer
      - `blockHash` string
      - `blockTime` integer
    - `lockTime` integer
    - `gas` integer
    - `mass` integer
    - `version` integer
  - `verboseData` VerboseDataModel, required
    - `hash` string
    - `difficulty` number
    - `selectedParentHash` string
    - `transactionIds` string[]
    - `blueScore` string
    - `childrenHashes` string[]
    - `mergeSetBluesHashes` string[]
    - `mergeSetRedsHashes` string[]
    - `isChainBlock` boolean
  - `extra` ExtraModel
    - `color` string
    - `minerAddress` string
    - `minerInfo` string

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/kaspa/apis/kaspa-rest-api-server.md) · [All operations](https://skmtc.dev/kaspa/apis/kaspa-rest-api-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kaspa/kaspa-rest-api-server/revisions/12089df981aa/schema)