{"id":15519481,"url":"https://github.com/pichillilorenzo/http-status-code-db","last_synced_at":"2026-04-14T04:02:08.270Z","repository":{"id":60387277,"uuid":"542723940","full_name":"pichillilorenzo/http-status-code-db","owner":"pichillilorenzo","description":"HTTP Status Code Database","archived":false,"fork":false,"pushed_at":"2022-09-29T15:08:19.000Z","size":107,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-10-04T01:48:44.775Z","etag":null,"topics":["database","db","http","http-status","http-status-code","http-status-codes","http-status-message","javascript","js","json","status-code","status-message"],"latest_commit_sha":null,"homepage":"https://pichillilorenzo.github.io/http-status-code-db/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"isc","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pichillilorenzo.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":["https://www.paypal.me/LorenzoPichilli"]}},"created_at":"2022-09-28T17:58:55.000Z","updated_at":"2023-11-23T11:35:05.000Z","dependencies_parsed_at":"2023-01-18T21:20:54.296Z","dependency_job_id":null,"html_url":"https://github.com/pichillilorenzo/http-status-code-db","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/pichillilorenzo/http-status-code-db","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pichillilorenzo%2Fhttp-status-code-db","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pichillilorenzo%2Fhttp-status-code-db/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pichillilorenzo%2Fhttp-status-code-db/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pichillilorenzo%2Fhttp-status-code-db/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pichillilorenzo","download_url":"https://codeload.github.com/pichillilorenzo/http-status-code-db/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pichillilorenzo%2Fhttp-status-code-db/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31781292,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-14T02:24:21.117Z","status":"ssl_error","status_checked_at":"2026-04-14T02:24:20.627Z","response_time":153,"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":["database","db","http","http-status","http-status-code","http-status-codes","http-status-message","javascript","js","json","status-code","status-message"],"created_at":"2024-10-02T10:21:41.071Z","updated_at":"2026-04-14T04:02:08.236Z","avatar_url":"https://github.com/pichillilorenzo.png","language":"TypeScript","funding_links":["https://www.paypal.me/LorenzoPichilli"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# HTTP Status Code Database\n\n[![NPM](https://nodei.co/npm/http-status-code-db.png?compact=true)](https://nodei.co/npm/http-status-code-db/)\n\u003cbr /\u003e\n[![](https://img.shields.io/npm/dt/http-status-code-db.svg?style=flat-square)](https://www.npmjs.com/package/http-status-code-db)\n\n\u003c/div\u003e\n\n[![NPM Version](https://badgen.net/npm/v/http-status-code-db)](https://npmjs.org/package/http-status-code-db)\n[![license](https://img.shields.io/github/license/pichillilorenzo/http-status-code-db)](/LICENSE)\n[![Donate to this project using Paypal](https://img.shields.io/badge/paypal-donate-yellow.svg)](https://www.paypal.me/LorenzoPichilli)\n\nThis is a large database of known HTTP Status Codes and information about them. It consists of a single, public JSON file and does not include any logic, allowing it to remain as un-opinionated as possible with an API. It aggregates data from the following sources:\n\n- https://developer.mozilla.org/en-US/docs/Web/HTTP/Status\n- https://www.iana.org/assignments/http-status-codes/http-status-codes.xhtml\n\n## Installation\n\n```bash\nnpm i --save http-status-code-db\n```\n\n### Database Download\n\nIf you want download the database and use it directly in the browser, you can just grab the\nJSON file using [jsDelivr](https://www.jsdelivr.com/). It is recommended to\nreplace `main` with [a release tag](https://github.com/pichillilorenzo/http-status-code-db/tags)\nas the JSON format may change in the future.\n\n```\nhttps://cdn.jsdelivr.net/gh/pichillilorenzo/http-status-code-db@main/dist/db.json\n```\n\n## Usage\n\n```js\nimport db from 'http-status-code-db';\n// .. or\nconst db = require('http-status-code-db').default;\n\nconst statusCodeInfo = db['200']; // An instance of HTTPStatusCode\nconsole.log(statusCodeInfo.syntax); // 200 OK\n```\n\nAccess HTTP Status Code info using the status code number as a key.\n\n## Contributing\n\nThe primary way to contribute to this database is by updating the data in one of the upstream sources.\nCheck the `scripts/src/mdn-scraper.ts` to check the MDN scraper implementation.\n\n### Direct Inclusion\n\nIf that is not possible / feasible, they can be added directly here as a \"custom\" status code.\n\nTo edit the database, only make PRs against `scripts/src/custom-status-codes.json`.\n\nThe `scripts/src/custom-status-codes.json` file is a JSON object of type [HTTPStatusCodeDb](https://pichillilorenzo.github.io/http-status-code-db/interfaces/HTTPStatusCodeDb.html), where each `key` is the status code number as a string and the `value`\nis an Object of type [HTTPStatusCode](https://pichillilorenzo.github.io/http-status-code-db/interfaces/HTTPStatusCode.html).\n\nTo update the build, run `npm run build:all`.\n\n## HTTPStatusCodeDb Data Structure Example\n\n```json\n{\n  \"100\": {...},\n  \"200\": {\n    \"code\": 200,\n    \"reasonPhrase\": \"OK\",\n    \"description\": \"The HTTP 200 OK success status response code indicates that the request has succeeded. A 200 response is cacheable by default. The meaning of a success depends on the HTTP request method: The successful result of a PUT or a DELETE is often not a 200 OK but a 204 No Content (or a 201 Created when the resource is uploaded for the first time).\",\n    \"syntax\": \"200 OK\",\n    \"link\": \"https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/200\",\n    \"examples\": [],\n    \"specifications\": [\n      {\n        \"name\": \"HTTP Semantics # status.200\",\n        \"link\": \"https://httpwg.org/specs/rfc9110.html#status.200\"\n      }\n    ],\n    \"browserCompatibility\": [\n      {\n        \"name\": \"Chrome\",\n        \"supported\": true,\n        \"version\": \"Yes\"\n      },\n      {\n        \"name\": \"Edge\",\n        \"supported\": true,\n        \"version\": \"12\"\n      },\n      {\n        \"name\": \"Firefox\",\n        \"supported\": true,\n        \"version\": \"Yes\"\n      },\n      {\n        \"name\": \"Opera\",\n        \"supported\": true,\n        \"version\": \"Yes\"\n      },\n      {\n        \"name\": \"Safari\",\n        \"supported\": true,\n        \"version\": \"Yes\"\n      },\n      {\n        \"name\": \"Chrome Android\",\n        \"supported\": true,\n        \"version\": \"Yes\"\n      },\n      {\n        \"name\": \"Firefox for Android\",\n        \"supported\": true,\n        \"version\": \"Yes\"\n      },\n      {\n        \"name\": \"Opera Android\",\n        \"supported\": true,\n        \"version\": \"Yes\"\n      },\n      {\n        \"name\": \"Safari on iOS\",\n        \"supported\": true,\n        \"version\": \"Yes\"\n      },\n      {\n        \"name\": \"Samsung Internet\",\n        \"supported\": true,\n        \"version\": \"Yes\"\n      },\n      {\n        \"name\": \"WebView Android\",\n        \"supported\": true,\n        \"version\": \"Yes\"\n      }\n    ]\n  },\n  \"404\": {...},\n  ...\n}\n```\n\nCheck [HTTPStatusCodeDb](https://pichillilorenzo.github.io/http-status-code-db/interfaces/HTTPStatusCodeDb.html) for more details.\n\n## License\n\nReleased under the [ISC](/LICENSE) license.\n\nThis project is strongly inspired by the [mime-db](https://github.com/jshttp/mime-db).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpichillilorenzo%2Fhttp-status-code-db","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpichillilorenzo%2Fhttp-status-code-db","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpichillilorenzo%2Fhttp-status-code-db/lists"}