Skip to content

fnb-bank-sync ​

← All modules

6 endpoints.

GET /api/v1/fnb-bank-sync/settings ​

Get Settings

The FNB Bank Sync settings, password withheld.

200 — Successful Response

json
{}

PUT /api/v1/fnb-bank-sync/settings ​

Update Settings

Request body

json
{
  "properties": {
    "username": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 140
        },
        {
          "type": "null"
        }
      ],
      "title": "Username"
    },
    "password": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 512
        },
        {
          "type": "null"
        }
      ],
      "title": "Password"
    },
    "account_number": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 64
        },
        {
          "type": "null"
        }
      ],
      "title": "Account Number"
    },
    "proxy_server": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 255
        },
        {
          "type": "null"
        }
      ],
      "title": "Proxy Server"
    },
    "profile_name": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 140
        },
        {
          "type": "null"
        }
      ],
      "title": "Profile Name"
    },
    "default_bank_account_id": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Default Bank Account Id"
    }
  },
  "type": "object",
  "title": "FnbSettingsIn",
  "description": "Partial update for the FNB Bank Sync settings. A field omitted (``None``)\nis left untouched; an empty string clears that field's override."
}

200 — Successful Response

json
{}

422 — Validation Error

json
{
  "properties": {
    "detail": {
      "items": {
        "properties": {
          "loc": {
            "items": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "integer"
                }
              ]
            },
            "type": "array",
            "title": "Location"
          },
          "msg": {
            "type": "string",
            "title": "Message"
          },
          "type": {
            "type": "string",
            "title": "Error Type"
          }
        },
        "type": "object",
        "required": [
          "loc",
          "msg",
          "type"
        ],
        "title": "ValidationError"
      },
      "type": "array",
      "title": "Detail"
    }
  },
  "type": "object",
  "title": "HTTPValidationError"
}

GET /api/v1/fnb-bank-sync/status ​

Status

Settings + a quick reconciliation snapshot for the configured account.

200 — Successful Response

json
{}

POST /api/v1/fnb-bank-sync/test-connection ​

Test Connection

FNB Sync Trx tests the connection first (owner, 2026-11-05): the route must pass traffic and get FNB's sign-in page, not its bot check (no login). usable is what the modal goes on; held says a refusal or the gap between logins is holding FNB.

200 — Successful Response

json
{
  "additionalProperties": true,
  "type": "object",
  "title": "Response Test Connection Api V1 Fnb Bank Sync Test Connection Post"
}

GET /api/v1/fnb-bank-sync/person-step ​

Person Step

Where the button's login is (owner, 2026-11-06: the person clicks Log in on noVNC, then the window closes and the sync takes over). FNB Sync Trx polls this while syncing: {step, at}, or {} before the scraper starts.

200 — Successful Response

json
{
  "additionalProperties": true,
  "type": "object",
  "title": "Response Person Step Api V1 Fnb Bank Sync Person Step Get"
}

POST /api/v1/fnb-bank-sync/scrape ​

Scrape

Pull FNB transactions into the configured default bank account. Pass statement_text (downloaded OFX/CSV) for the working path; the credential-driven live login is a gated scaffold.

Request body

json
{
  "properties": {
    "statement_text": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Statement Text"
    },
    "fmt": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Fmt"
    }
  },
  "type": "object",
  "title": "Body_scrape_api_v1_fnb_bank_sync_scrape_post"
}

200 — Successful Response

json
{}

422 — Validation Error

json
{
  "properties": {
    "detail": {
      "items": {
        "properties": {
          "loc": {
            "items": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "integer"
                }
              ]
            },
            "type": "array",
            "title": "Location"
          },
          "msg": {
            "type": "string",
            "title": "Message"
          },
          "type": {
            "type": "string",
            "title": "Error Type"
          }
        },
        "type": "object",
        "required": [
          "loc",
          "msg",
          "type"
        ],
        "title": "ValidationError"
      },
      "type": "array",
      "title": "Detail"
    }
  },
  "type": "object",
  "title": "HTTPValidationError"
}

Lubb Business Documentation