# FOID > FOID (Fintech Open Identity) lets people in Nigeria verify their identity once (NIN, BVN and a live face check) and share that proof with businesses only when they approve. Businesses integrate with "Continue with FOID" (OAuth 2.0 + PKCE sign-in), a hosted verification page, or server-to-server NIN/BVN checks, using the Python, Node and React SDKs. Every page is also available as markdown (add .md to the URL). All pages in one file: http://localhost:5177/llms-full.txt. MCP server (search and read these docs from an AI tool): see http://localhost:5177/guide/ai.md. ## Developer guides - [Introduction](http://localhost:5177/guide/index.md): FOID (Fintech Open Identity) lets your business verify customers without making them prove who they are again. A person verifies once with FOID (NIN, BVN, and a - [Quickstart](http://localhost:5177/guide/quickstart.md): Make your first FOID API call in about five minutes, in test mode. Nothing here touches real identity data or costs money. - [Core concepts](http://localhost:5177/guide/concepts.md): Your business is an organisation in the FOID console. Every organisation has two separate environments: - [Test and live mode](http://localhost:5177/guide/test-and-live.md): Every organisation has a test and a live environment. Switch between them with the Test / Live toggle in the console sidebar. In Test mode the console shows an - [Continue with FOID](http://localhost:5177/guide/continue-with-foid.md): A sign-in button, like "Sign in with Google", where the person arrives already verified. They approve what to share on FOID's own screen, and your server gets t - [Hosted verification](http://localhost:5177/guide/hosted-verification.md): Send a customer to a FOID-hosted page that collects their consent and runs the checks you ask for: NIN (by number, or by scanning an NIN slip or NIMC card), BVN - [NIN and BVN checks](http://localhost:5177/guide/checks.md): Server-to-server lookups for when you already hold the number and the person's consent, for example from your own onboarding form. FOID looks the number up and - [Subjects and consent](http://localhost:5177/guide/subjects.md): A subject is a person as your business knows them. Checks, verifications and Continue with FOID sign-ins all attach to a subject, and every read of a subject go - [Webhooks](http://localhost:5177/guide/webhooks.md): FOID sends signed POST requests to your server when something happens: a verification finishes, a check completes, a person revokes consent. Use webhooks rather - [Going live](http://localhost:5177/guide/going-live.md): Everything you build in test mode works in live mode with live credentials. Live mode adds real data, billing, and stricter rules. - [Security checklist](http://localhost:5177/guide/security.md): Go through this before you go live, and again whenever you change how you handle FOID credentials. - [Errors, limits, idempotency](http://localhost:5177/guide/errors.md): Open API errors look like this: - [Use FOID docs with AI](http://localhost:5177/guide/ai.md): Building with an AI assistant? Give it the FOID docs, so it writes code against the real SDKs and API instead of guessing. ## SDKs - [SDKs](http://localhost:5177/sdks/index.md): The server SDKs hold your secrets. The React SDK only ever has your public client ID. A typical setup uses one of each: the button in your front end, and the se - [Python SDK — `foid`](http://localhost:5177/sdks/python.md): A server-side SDK for Python ≥ 3.10. It covers the Continue with FOID code exchange (client secret or key pair), the Open API, webhook signature verification an - [Node SDK — `@foid/node`](http://localhost:5177/sdks/node.md): A server-side SDK for Node ≥ 18. It covers the Continue with FOID code exchange (client secret or key pair), the Open API, webhook signature verification and PK - [React SDK — `@foid/react`](http://localhost:5177/sdks/react.md): The browser side of Continue with FOID, in the style of @react-oauth/google: a provider, a branded button, a hook, and a framework-free core. It opens the FOID - [Example app (Harbor)](http://localhost:5177/sdks/example-app.md): Harbor is a pretend digital bank that integrates FOID the way a real customer would. It's in the repo under demo/. One React front end (with @foid/react) runs w ## API reference - [API overview](http://localhost:5177/api/index.md): The FOID Open API is a JSON-over-HTTPS API for your server. Never call it from a browser or mobile app — that would expose your API key. For the browser side, u - [Endpoints](http://localhost:5177/api/reference.md): Every endpoint of the Open API, generated from the FOID backend. The examples are real responses from a ## Help for FOID users - [Help centre](http://localhost:5177/help/index.md): FOID is your verified identity, built once and reused. You prove who you are one time — your NIN, BVN and a quick face check — and then share that proof with ba - [Create your FOID](http://localhost:5177/help/getting-started.md): You need an email address you can open and your 11-digit NIN. - [Verify your identity](http://localhost:5177/help/verify-identity.md): Everything happens on My Identity in the left menu. The Verification progress card shows each step and ticks it off when it's done. Do the steps in this order — - [Your FOID code](http://localhost:5177/help/foid-code.md): Your FOID code lets someone — a bank teller, a landlord, a shop — check that you're verified without you reading out your NIN or BVN. - [Continue with FOID](http://localhost:5177/help/continue-with-foid.md): Some banks and apps have a Continue with FOID button — like "Sign in with Google", except you arrive already verified, so you don't repeat KYC. - [Connected apps and consent](http://localhost:5177/help/connected-apps.md): Every business you've shared with is listed in FOID, and you can take access back at any time. - [Keep your account safe](http://localhost:5177/help/security.md): All of these are in Profile & Settings → Security. - [FAQ](http://localhost:5177/help/faq.md): What is FOID? ## Other - [Playground](http://localhost:5177/playground.md): This is the real button from @foid/react, wired to a FOID test app that FOID runs for these docs. Change the options on the left, click the b - [Changelog](http://localhost:5177/changelog.md): Changes to the FOID API, SDKs and docs. Dates are when the change shipped.