Australian BSB lookup

Resolve a 6-digit Australian BSB (Bank State Branch) number.

This documentation covers API V1.

Endpoint

Returns the Australian institution behind a BSB number. Dashes in the request value are accepted and normalized.

http

GET https://api.fincode.example.com/v1/bsb/{code}

Parameters

Name	Type	In	Description
code	string	path	The BSB, e.g. "062001" or "062-001".

Example request

bash

curl -s "https://api.fincode.example.com/v1/bsb/062-001" \
  -H "Authorization: Bearer sk_test_xxx"

Example response

json

{
  "data": {
    "bsb": "062001",
    "formatted": "062-001",
    "bank": {
      "id": "inst_commbank",
      "name_en": "Commonwealth Bank of Australia",
      "short_name": "CommBank",
      "country": "AU",
      "website": "https://www.commbank.com.au"
    },
    "city": "Sydney",
    "state": "NSW",
    "status": "ACTIVE",
    "source": {
      "name": "AFIA BSB directory",
      "source_type": "PUBLIC",
      "retrieved_at": "2026-09-01"
    }
  },
  "meta": { "request_id": "req_c41d7e82" }
}

Errors

Code	Description
INVALID_BSB	The code is not 6 digits.
NOT_FOUND	The identifier does not exist in the dataset.
UNAUTHORIZED	Missing or invalid API key.
RATE_LIMITED	Rate limit exceeded — retry after the indicated delay.