{"id":48595274,"url":"https://github.com/borschai/uk-sic-codes","last_synced_at":"2026-04-10T11:00:52.551Z","repository":{"id":347321905,"uuid":"1192032004","full_name":"borschai/uk-sic-codes","owner":"borschai","description":"Fast, zero-dependency UK SIC 2007 code lookup, search, and validation","archived":false,"fork":false,"pushed_at":"2026-03-27T12:17:23.000Z","size":70,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-27T23:21:39.329Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://borsch.ai","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/borschai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-25T20:33:11.000Z","updated_at":"2026-03-27T12:17:26.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/borschai/uk-sic-codes","commit_stats":null,"previous_names":["borschai/uk-sic-codes"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/borschai/uk-sic-codes","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/borschai%2Fuk-sic-codes","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/borschai%2Fuk-sic-codes/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/borschai%2Fuk-sic-codes/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/borschai%2Fuk-sic-codes/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/borschai","download_url":"https://codeload.github.com/borschai/uk-sic-codes/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/borschai%2Fuk-sic-codes/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31639524,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-10T07:40:12.752Z","status":"ssl_error","status_checked_at":"2026-04-10T07:40:11.664Z","response_time":98,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-04-08T21:00:31.108Z","updated_at":"2026-04-10T11:00:52.544Z","avatar_url":"https://github.com/borschai.png","language":"TypeScript","funding_links":[],"categories":["Market Data \u0026 Data Sources","[↑](#-table-of-contents) Company Research"],"sub_categories":["[↑](#-table-of-contents) GitHub"],"readme":"# uk-sic-codes\n\nFast, zero-dependency UK SIC 2007 code lookup, search, and validation for Node.js and the browser.\n\n\u003e Built by [BORSCH.AI](https://borsch.ai) — UK Business Intelligence Platform\n\u003e covering 5.9M companies with AI-powered risk analysis and 50M+ government data signals.\n\n[![npm version](https://img.shields.io/npm/v/uk-sic-codes.svg)](https://www.npmjs.com/package/uk-sic-codes)\n[![PyPI version](https://img.shields.io/pypi/v/uk-sic-codes.svg)](https://pypi.org/project/uk-sic-codes/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n\nAlso available as a [Python package](https://pypi.org/project/uk-sic-codes/) (`pip install uk-sic-codes`).\n\n## Features\n\n- Complete UK SIC 2007 database (**731 codes**, 21 sections, 88 divisions)\n- Fuzzy keyword search with relevance scoring\n- Code validation (4 or 5 digit formats)\n- Section and division browsing\n- Full hierarchical tree\n- Zero dependencies\n- TypeScript types included\n- Works in Node.js and the browser\n- ESM and CommonJS support\n\n## Installation\n\n```bash\nnpm install uk-sic-codes\n```\n\n## Quick Start\n\n```typescript\nimport { lookup, search, validate } from \"uk-sic-codes\";\n\n// Look up a code\nconst code = lookup(\"62012\");\n// {\n//   code: \"62012\",\n//   description: \"Business and domestic software development\",\n//   section: \"J\",\n//   sectionName: \"Information and Communication\",\n//   division: \"62\",\n//   group: \"620\",\n//   classCode: \"6201\"\n// }\n\n// Search by keyword\nconst results = search(\"restaurant\");\n// [\n//   { code: \"56101\", description: \"Licenced restaurants\", ... },\n//   { code: \"56102\", description: \"Unlicenced restaurants and cafes\", ... },\n//   ...\n// ]\n\n// Validate a code\nvalidate(\"62012\"); // true\nvalidate(\"00000\"); // false\n```\n\n## API\n\n### `lookup(code: string): SICCode | null`\n\nLook up a SIC code by its numeric string. Accepts 4 or 5 digit codes.\n\n```typescript\nlookup(\"62012\");  // Business and domestic software development\nlookup(\"1110\");   // Growing of cereals (auto-pads to 01110)\nlookup(\"62.01.2\"); // Also works (strips punctuation)\n```\n\n### `search(query: string, limit?: number): SICCode[]`\n\nSearch codes by keyword. Case-insensitive with relevance scoring.\n\n```typescript\nsearch(\"software\");           // All software-related codes\nsearch(\"coal mining\");        // Multi-word search\nsearch(\"manufacture\", 5);     // Limit to 5 results\n```\n\n### `validate(code: string): boolean`\n\nCheck if a string is a valid UK SIC 2007 code.\n\n```typescript\nvalidate(\"62012\");  // true\nvalidate(\"99999\");  // true (Dormant Company)\nvalidate(\"abc\");    // false\nvalidate(\"00000\");  // false\n```\n\n### `listSection(letter: string): SICCode[]`\n\nGet all codes in a section (A-U).\n\n```typescript\nlistSection(\"J\");  // All Information and Communication codes\nlistSection(\"A\");  // All Agriculture codes\n```\n\n### `listDivision(code: string): SICCode[]`\n\nGet all codes in a 2-digit division.\n\n```typescript\nlistDivision(\"62\"); // IT activities (62011, 62012, 62020, 62030, 62090)\nlistDivision(\"56\"); // Food service (56101, 56102, 56103, ...)\n```\n\n### `tree(): SICSection[]`\n\nGet the full hierarchy: all sections with their divisions and codes.\n\n```typescript\nconst hierarchy = tree();\n// [\n//   { letter: \"A\", name: \"Agriculture...\", divisions: [\"01\",\"02\",\"03\"], codes: [...] },\n//   { letter: \"B\", name: \"Mining...\", divisions: [\"05\",\"06\",...], codes: [...] },\n//   ...\n// ]\n```\n\n### `sections(): Array\u003c{ letter: string; name: string }\u003e`\n\nGet all 21 section letters and names.\n\n```typescript\nsections();\n// [\n//   { letter: \"A\", name: \"Agriculture, Forestry and Fishing\" },\n//   { letter: \"B\", name: \"Mining and Quarrying\" },\n//   ...\n// ]\n```\n\n### `count(): number`\n\nGet the total number of codes in the database.\n\n```typescript\ncount(); // 731\n```\n\n## Types\n\n```typescript\ninterface SICCode {\n  code: string;        // 5-digit code, e.g. \"62012\"\n  description: string; // Full description\n  section: string;     // Section letter, e.g. \"J\"\n  sectionName: string; // Section name, e.g. \"Information and Communication\"\n  division: string;    // 2-digit division, e.g. \"62\"\n  group: string;       // 3-digit group, e.g. \"620\"\n  classCode: string;   // 4-digit class, e.g. \"6201\"\n}\n\ninterface SICSection {\n  letter: string;      // Section letter\n  name: string;        // Section name\n  divisions: string[]; // 2-digit division codes\n  codes: string[];     // All 5-digit codes in this section\n}\n```\n\n## Data Source\n\nBased on the official [UK SIC 2007 condensed list](https://resources.companieshouse.gov.uk/sic/) published by Companies House and the [Office for National Statistics](https://www.ons.gov.uk/methodology/classificationsandstandards/ukstandardindustrialclassificationofeconomicactivities/uksic2007).\n\n## Need More Company Data?\n\nThis package provides SIC code lookup. For full UK company data — search, risk scores, director networks, government signals, and AI-powered analysis across 5.9 million companies — visit [borsch.ai](https://borsch.ai).\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fborschai%2Fuk-sic-codes","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fborschai%2Fuk-sic-codes","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fborschai%2Fuk-sic-codes/lists"}