Skip to content

Create et-tin.json Fixes #705#706

Merged
mdpointer merged 2 commits into
mainfrom
et-tin
Jun 12, 2026
Merged

Create et-tin.json Fixes #705#706
mdpointer merged 2 commits into
mainfrom
et-tin

Conversation

@mdpointer

Copy link
Copy Markdown
Contributor

This JSON file contains details about the Ethiopia Tax Identification Number (TIN), including its description, access details, and metadata.

Sources are patchy.

I could not find a lookup function, but known TINs can be verified.

This JSON file contains details about the Ethiopia Tax Identification Number (TIN), including its description, access details, and metadata.
@mdpointer mdpointer requested a review from emmajclegg June 10, 2026 14:04
Comment thread lists/et/et-tin.json Outdated
"code": "ET-TIN",
"confirmed": true,
"deprecated": false,
"listType": "primary",

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Tax identification numbers are normally classed as "secondary", as it requires an already established entity to register for a tax number.

See Ghana (https://github.com/org-id/register/blob/main/lists/gh/gh-tin.json) and Colombia (https://github.com/org-id/register/blob/main/lists/co/co-nit.json), for example.

Additional guidance on determining list type: https://org-idguide-handbook.readthedocs.io/en/latest/metadata.html?highlight=primary#list-type

Comment thread lists/et/et-tin.json Outdated
},
"url": "https://www.mor.gov.et/",
"description": {
"en": "TIN is a ten digit identifier assigned to individuals and entities for tax purposes in Ethiopia. It is a permanent identification number and never changes."

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'd add a little more to the description about which agency assigns tax numbers, and who to.

i.e. TINs are administered by the Ethiopian Ministry of Revenue. A TIN is assigned to:

  • Individual taxpayers (employees, self-employed persons, landlords, etc.)
  • Sole proprietors
  • Partnerships
  • Companies and other legal entities
  • Other organizations with tax obligations

Comment thread lists/et/et-tin.json Outdated
"availableOnline": true,
"onlineAccessDetails": "The list is maintained by the Ethiopian Ministry of Revenue: https://www.mor.gov.et/\n\nAn identifier lookup portal can be found here: https://www.mor.gov.et/qr/",
"publicDatabase": "https://www.mor.gov.et/qr/",
"guidanceOnLocatingIds": "Enter the TIN to confirm the associated organisation. Lookup by known TIN, not searchable by name or browsable.",

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'd specify here that TINs are 10 numeric digits (to help future us know the format to expect, alongside the examples below)

Comment thread lists/et/et-tin.json Outdated
"ET"
],
"subnationalCoverage": [],
"structure": [],

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This should be populated with the types of organisation that the list covers. I expect here that it's companies, charities, and trusts (the most common legal entities) - i.e:

"charity",
"company",
"trust"

@emmajclegg

Copy link
Copy Markdown
Collaborator

Thanks @mdpointer - I've added some comments as review, and happy to discuss more tomorrow.

I don't know if you've stumbled across this resource yet, but it's what I mentioned should help understand the field definitions: https://org-idguide-handbook.readthedocs.io/en/latest/index.html#

…ure and type

Updated the description of TIN to include additional details about its administration and the types of entities assigned a TIN. Modified structure and listType fields for better categorization.
@mdpointer

Copy link
Copy Markdown
Contributor Author

Thanks @emmajclegg I've made the changes you requested in a new commit.

@emmajclegg

Copy link
Copy Markdown
Collaborator

Thanks @mdpointer - looks good. You can now merge the pull request via the button below, and delete the associated GitHub branch that you'd created for this list.

Visiting https://org-id.guide/_update_lists after having done that will load the latest changes from GitHub to the live site.

@mdpointer mdpointer merged commit 6691c01 into main Jun 12, 2026
1 check passed
@mdpointer mdpointer deleted the et-tin branch June 12, 2026 08:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants