{"openapi":"3.1.0","info":{"title":"Credit Union Ledger API","version":"1.0.0","summary":"Free JSON data on every US credit union, from NCUA 5300 call reports.","description":"Static JSON files rebuilt each quarter (current data: quarter ended 2026-06). No key, no sign-up. Every record carries its quarter and source. License: CC BY 4.0, attribute \"Credit Union Ledger, creditunions.online\". Not affiliated with NCUA or any credit union. An MCP server with the same data is at https://creditunions.online/mcp.","contact":{"name":"Credit Union Ledger","email":"hello@creditunions.online","url":"https://creditunions.online/developers/"},"license":{"name":"CC BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/"}},"servers":[{"url":"https://creditunions.online"}],"externalDocs":{"url":"https://creditunions.online/developers/"},"paths":{"/api/v1/index.json":{"get":{"operationId":"getIndex","summary":"Discovery document: endpoints, data quarter, MCP server.","responses":{"200":{"description":"Discovery document","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Not found (unknown charter or state)."}}}},"/api/v1/credit-unions.json":{"get":{"operationId":"listCreditUnions","summary":"Every credit union with every metric, in columns.","description":"rows[i][j] is fields[j] for credit union i. Profile fields come first, then one column per metric key (see metrics).","responses":{"200":{"description":"All credit unions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Dataset"}}}},"404":{"description":"Not found (unknown charter or state)."}}}},"/api/v1/credit-unions/{charter}.json":{"get":{"operationId":"getCreditUnion","summary":"One credit union by NCUA charter number.","parameters":[{"name":"charter","in":"path","required":true,"description":"NCUA charter number, e.g. 5536 (Navy Federal).","schema":{"type":"string","pattern":"^[0-9]+$"}}],"responses":{"200":{"description":"Profile, raw call-report figures with NCUA account codes, every metric with national and peer percentiles, five quarters, offices.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreditUnion"}}}},"404":{"description":"Not found (unknown charter or state)."}}}},"/api/v1/states.json":{"get":{"operationId":"listStates","summary":"Totals and ratio medians for every state (by headquarters).","responses":{"200":{"description":"States","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Not found (unknown charter or state)."}}}},"/api/v1/states/{st}.json":{"get":{"operationId":"getState","summary":"One state with every credit union headquartered there, largest first.","parameters":[{"name":"st","in":"path","required":true,"description":"Two-letter state code, lower case (tx, ca, dc, pr).","schema":{"type":"string","pattern":"^[a-z]{2}$"}}],"responses":{"200":{"description":"State","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Not found (unknown charter or state)."}}}},"/api/v1/metrics.json":{"get":{"operationId":"listMetrics","summary":"Every metric key with its definition, unit and better direction.","responses":{"200":{"description":"Metric registry","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Not found (unknown charter or state)."}}}},"/api/v1/mergers.json":{"get":{"operationId":"listMergers","summary":"NCUA-approved mergers from the last five Merger Activity and Insurance Reports.","responses":{"200":{"description":"Mergers","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Not found (unknown charter or state)."}}}},"/api/v1/trade-names.json":{"get":{"operationId":"listTradeNames","summary":"Charter number to the trade names NCUA lists for it.","responses":{"200":{"description":"Trade names","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}}}}},"404":{"description":"Not found (unknown charter or state)."}}}}},"components":{"schemas":{"Dataset":{"type":"object","required":["quarter","fields","rows","metrics"],"properties":{"quarter":{"type":"string","example":"2026-06"},"source":{"type":"string"},"source_url":{"type":"string","format":"uri"},"license":{"type":"string"},"metrics":{"type":"array","items":{"$ref":"#/components/schemas/Metric"}},"fields":{"type":"array","items":{"type":"string"}},"rows":{"type":"array","items":{"type":"array"}}}},"Metric":{"type":"object","properties":{"key":{"type":"string","enum":["assets","members","loans","shares","netWorth","branches","employees","assetGrowth","memberGrowth","loanGrowth","shareGrowth","nwr","aclCoverage","aclToDelinq","roa","nim","dividendRate","costOfFunds","efficiency","opexRatio","nonIntIncomeRatio","feePerMember","provisionRatio","delinqRate","ncoRate","loanToShare","autoShare","mortgageShare","cardShare","commercialShare","autoLoans","mortgageLoans","cardLoans","commercialLoans","studentLoans","avgLoan","certShare","coreShare","uninsuredShare","avgDeposit","investmentsToAssets","cashToAssets","borrowingsToAssets","membersPerEmployee","assetsPerEmployee","membersPerBranch","penetration","rateNewAuto","rateUsedAuto","rateCard","rateUnsecured","rateMortgage","rateHeloc"]},"label":{"type":"string"},"short":{"type":"string"},"group":{"type":"string"},"unit":{"type":"string","enum":["pct","usd","count","times","rate"]},"better":{"type":["string","null"],"enum":["high","low",null]},"def":{"type":"string"},"rankMin":{"type":["number","null"]}}},"MetricValue":{"type":"object","properties":{"value":{"type":["number","null"]},"percentile_national":{"type":["number","null"]},"percentile_peer":{"type":["number","null"]},"peer_median":{"type":["number","null"]}}},"CreditUnion":{"type":"object","required":["charter","name","quarter","source","metrics"],"properties":{"charter":{"type":"string"},"name":{"type":"string"},"filed_name":{"type":"string"},"trade_names":{"type":"array","items":{"type":"string"}},"url":{"type":"string","format":"uri"},"address":{"type":"object"},"phone":{"type":["string","null"]},"charter_type":{"type":"string"},"federally_insured":{"type":"boolean"},"peer_group":{"type":"object"},"state_rank_by_assets":{"type":"object"},"call_report":{"type":"object","description":"Raw figures: { value, account (NCUA account code), ytd? }."},"metrics":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/MetricValue"}},"series":{"type":"array","items":{"type":"object"}},"offices":{"type":"object"},"quarter":{"type":"string"},"source":{"type":"string"},"source_url":{"type":"string","format":"uri"},"license":{"type":"string"}}}}}}