{"id":26926763,"url":"https://github.com/matchilling/hmrc-exchange-rates","last_synced_at":"2025-10-06T01:10:43.179Z","repository":{"id":39755140,"uuid":"249231853","full_name":"matchilling/hmrc-exchange-rates","owner":"matchilling","description":"🇬🇧 HMRC Exchange Rates API for Customs \u0026 VAT 💸","archived":false,"fork":false,"pushed_at":"2024-10-30T03:12:22.000Z","size":822,"stargazers_count":10,"open_issues_count":0,"forks_count":2,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-10-30T06:15:01.637Z","etag":null,"topics":["api","exchange-rates","git-scraping","hmrc","united-kingdom","vat"],"latest_commit_sha":null,"homepage":"https://hmrc.matchilling.com","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/matchilling.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2020-03-22T17:07:05.000Z","updated_at":"2024-10-30T03:12:26.000Z","dependencies_parsed_at":"2024-04-15T05:57:07.805Z","dependency_job_id":"8e63db83-3729-43ce-8699-ca4aa2aeb82a","html_url":"https://github.com/matchilling/hmrc-exchange-rates","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matchilling%2Fhmrc-exchange-rates","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matchilling%2Fhmrc-exchange-rates/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matchilling%2Fhmrc-exchange-rates/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matchilling%2Fhmrc-exchange-rates/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/matchilling","download_url":"https://codeload.github.com/matchilling/hmrc-exchange-rates/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246752577,"owners_count":20827987,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["api","exchange-rates","git-scraping","hmrc","united-kingdom","vat"],"created_at":"2025-04-02T03:35:41.604Z","updated_at":"2025-10-06T01:10:43.169Z","avatar_url":"https://github.com/matchilling.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!--\n*** ----------------------------------------------------------------\n*** NOTE: THIS IS AN AUTO-GENERATED FILE. DO NOT MODIFY IT DIRECTLY.\n*** ----------------------------------------------------------------\n--\u003e\n\n# 🇬🇧 HMRC Exchange Rates API for Customs \u0026 VAT [![Update Rates Cron Job](https://github.com/matchilling/hmrc-exchange-rates/actions/workflows/update_rates_cron_job.yml/badge.svg)](https://github.com/matchilling/hmrc-exchange-rates/actions/workflows/update_rates_cron_job.yml)\nFind foreign exchange rates issued by [His Majesty's Revenue and Customs][hmrc-url]\nin JSON format from __Jan 2015__ till __Oct 2025__.\n\n__Last update: Sun Oct  5 03:22:12 UTC 2025__\n\n## Usage\n\n```sh\n# Get the latest rates\n$ curl -X GET https://hmrc.matchilling.com/rate/latest.json\n{\n  \"base\": \"GBP\",\n  \"period\": {\n    \"start\": \"2020-01-01\",\n    \"end\": \"2020-01-31\"\n  },\n  \"rates\": {\n    \"AED\": \"4.8012\",\n    \"ALL\": \"143.53\",\n    \"AMD\": \"624.19\",\n    \"AOA\": \"598.72\",\n    \"ARS\": \"78.18\",\n    \"AUD\": \"1.905\",\n    ...\n  }\n}\n\n# Get rates by month (e.g. March 2020)\n$ curl -X GET https://hmrc.matchilling.com/rate/2020/03.json\n```\n\n## 💷 Details\n\nYou should use these exchanges rates if you have to convert any foreign currency to sterling for customs and VAT purposes.\n\nThe EU rate includes the following countries:\n\n- Austria\n- Belgium\n- Cyprus\n- Estonia\n- Finland\n- France\n- Germany\n- Greece\n- Ireland\n- Italy\n- Latvia\n- Lithuania\n- Luxembourg\n- Malta\n- Netherlands\n- Portugal\n- Slovakia\n- Slovenia\n- Spain\n\nYou should only use the EU rate for conversion of invoices drawn in the euro. Do not confuse it with the euro rate\npublished for agricultural levy purposes or the bit error rate (BER) daily rate set to help payment of taxes in the euro.\n\n## 🛠 CSV and XML converter\n\nHMRC publishes new monthly exchange rates in [CSV][hmrc-url] and [XML][hmrc-url] format on its website during\nthe last week of the month. The CSV version is usually a few days before the XML one available.\n\nUnfortunately only the XML version can be retrieved programmatically as the URI to CSV contains a unique file descriptor\nwhich obviously can not be predicted. Therefore the XML converter is being used by default.\n\nHowever, you can always manually add new rates to this repository using [this CSV converter](./script/converter/from_csv.sh).\n\n```sh\n$ curl --silent https://www.trade-tariff.service.gov.uk/api/v2/exchange_rates/files/monthly_csv_2023-11.csv | \\\n    ./script/converter/from_csv.sh \\\n    \u003e rate/2023/11.json\n```\n\n\u003c!-- MARKDOWN LINKS --\u003e\n[hmrc-url]: https://www.trade-tariff.service.gov.uk/exchange_rates\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatchilling%2Fhmrc-exchange-rates","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmatchilling%2Fhmrc-exchange-rates","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatchilling%2Fhmrc-exchange-rates/lists"}