Match

Verify linked record

Verify whether the supplied link record matches the published link record. The response indicates whether the records match, mismatch or there is an error.

post

{your-URL}/api/v1/linkedrecords/{txId}/match

Path parameters

txIdstringrequired

The transaction id of the record to query. Using a value other than a id returned by the LinkedRecords methods has undefined behavior.

Query parameters

encodestringrequired

The same encode parameters as used to create or update the record. In the case of encoders used without a "salt" parameter, this can be omitted.

prevTxIdstring

The Id of previous linked record which the record referred to by txId updates or deletes. This parameter must be omitted when verifying create record.

Header parameters

x-api-keystringrequired

{your-API-key}

Body

string · byte

Responses

text/plainapplication/jsontext/json

text/plainapplication/jsontext/json

text/plainapplication/jsontext/json

text/plainapplication/jsontext/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '{your-URL}/api/v1/linkedrecords/{txId}/match?encode=text' \
  --header 'x-api-key: text' \
  --header 'Content-Type: application/octet-stream'

200

400

404

500

200

text/plain

application/json

text/json

text/plain

{
  "match": true,
  "confirmation": {
    "confirmedBlocks": 1,
    "blockHash": "text",
    "blockTimestamp": "2025-02-23T06:48:24.175Z",
    "merkleProof": {
      "index": 1,
      "txOrId": "text",
      "target": "text",
      "targetType": "text",
      "proofType": "text",
      "composite": true,
      "nodes": [
        "text"
      ]
    }
  }
}

The transaction has been published. The response is a JSON structure containing:

• match: boolean indicating whether the supplied content matches the published transaction
• confirmation: set if transaction has been included in a valid block (same as with get status endpoint)
  • confirmedBlocks: Number of confirmations (blocks) at the time of request
  • blockHash: block hash if transaction has been included in a block
  • blockTimestamp: block header timestamp (field is set on best-effort basis)
  • merkleProof: A JSON object as defined in TSC Merkle Proof (https://tsc.bsvblockchain.org/standards/merkle-proof-standardised-format/#JSONform)