Provenance of the active bank register

Which Bits publication the answers come from, when it was fetched and its hashes. Poll this to detect a register update.

GET/v1/dataset

Authorization

Optional — this operation also accepts unauthenticated requests.

x-api-keyAPI key · header

API key issued from the dashboard. Optional: anonymous callers are served at a lower rate limit.

AuthorizationBearer token · header

The same API key, sent as a bearer token.

Responses

200Default Response

versionstringrequired

sourceobjectrequired

Show properties

namestringrequired

urlstring<uri>required

sheetstring

retrievedAtstring<date-time>required

matches ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$

sourceHashstringrequired

contentHashstringrequired

countsobjectrequired

Show properties

banksintegerrequired

min -9007199254740991 · max 9007199254740991

clearingCodesintegerrequired

min -9007199254740991 · max 9007199254740991

logosintegerrequired

min -9007199254740991 · max 9007199254740991

400Default Response

typestring<uri>required

titlestringrequired

statusintegerrequired

min -9007199254740991 · max 9007199254740991

codestringrequired

detailstring

instancestring

errorsobject[]

Show properties

Array of object

pathstringrequired

messagestringrequired

401Default Response

typestring<uri>required

titlestringrequired

statusintegerrequired

min -9007199254740991 · max 9007199254740991

codestringrequired

detailstring

instancestring

errorsobject[]

Show properties

Array of object

pathstringrequired

messagestringrequired

404Default Response

typestring<uri>required

titlestringrequired

statusintegerrequired

min -9007199254740991 · max 9007199254740991

codestringrequired

detailstring

instancestring

errorsobject[]

Show properties

Array of object

pathstringrequired

messagestringrequired

429Default Response

typestring<uri>required

titlestringrequired

statusintegerrequired

min -9007199254740991 · max 9007199254740991

codestringrequired

detailstring

instancestring

errorsobject[]

Show properties

Array of object

pathstringrequired

messagestringrequired

500Default Response

typestring<uri>required

titlestringrequired

statusintegerrequired

min -9007199254740991 · max 9007199254740991

codestringrequired

detailstring

instancestring

errorsobject[]

Show properties

Array of object

pathstringrequired

messagestringrequired

Request

curl -X GET "http://localhost:8080/v1/dataset" \
  -H "x-api-key: YOUR_API_KEY"

const response = await fetch("http://localhost:8080/v1/dataset", {
  method: "GET",
  headers: {
    "x-api-key": "YOUR_API_KEY"
  }
});

import requests

response = requests.get(
    "http://localhost:8080/v1/dataset",
    headers={
        "x-api-key": "YOUR_API_KEY"
    },
)

Response

{
  "version": "2026-06-22.3d073ac8",
  "source": {
    "name": "string",
    "url": "http://example.com",
    "sheet": "string",
    "retrievedAt": "2019-08-24T14:15:22Z"
  },
  "sourceHash": "string",
  "contentHash": "string",
  "counts": {
    "banks": -9007199254740991,
    "clearingCodes": -9007199254740991,
    "logos": -9007199254740991
  }
}

{
  "type": "http://example.com",
  "title": "string",
  "status": -9007199254740991,
  "code": "string",
  "detail": "string",
  "instance": "string",
  "errors": [
    {
      "path": "string",
      "message": "string"
    }
  ]
}

{
  "type": "http://example.com",
  "title": "string",
  "status": -9007199254740991,
  "code": "string",
  "detail": "string",
  "instance": "string",
  "errors": [
    {
      "path": "string",
      "message": "string"
    }
  ]
}

{
  "type": "http://example.com",
  "title": "string",
  "status": -9007199254740991,
  "code": "string",
  "detail": "string",
  "instance": "string",
  "errors": [
    {
      "path": "string",
      "message": "string"
    }
  ]
}

{
  "type": "http://example.com",
  "title": "string",
  "status": -9007199254740991,
  "code": "string",
  "detail": "string",
  "instance": "string",
  "errors": [
    {
      "path": "string",
      "message": "string"
    }
  ]
}

{
  "type": "http://example.com",
  "title": "string",
  "status": -9007199254740991,
  "code": "string",
  "detail": "string",
  "instance": "string",
  "errors": [
    {
      "path": "string",
      "message": "string"
    }
  ]
}