Get Current Taxpayer Details

Overview/Purpose
Retrieves the current taxpayer’s profile and configuration from EFRIS, including taxpayer identity, branch details, registered tax types, device information, platform feature flags, and other invoicing/compliance settings.

Method & URL

Method: GET

URL: {{baseUrl}}/efris/taxpayer-details

Authentication

Type: Bearer token

Header: Authorization: Bearer {{token}}

Headers

Required:

Authorization: Bearer {{token}}

Optional:

Content-Type: application/json

Variables

{{baseUrl}} – Base API URL (e.g., https://api-uat.ura.go.ug/efris)

{{token}} – Access token for the authenticated taxpayer context

Query/Body

Query params: None

Body: None

Successful Response (200) – Full sample (latest observed payload)
{
"success": true,
"msg": "SUCCESS",
"data": {
"taxpayerBranchVersion": "",
"agentFlag": "0",
"issueTaxTypeRestrictions": "1",
"creditMemoPeriodDate": "15",
"exportCommodityTaxRate": "0",
"commodityCategoryVersion": "13.6",
"isAllowIssueCreditWithoutFDN": "0",
"isAllowIssueRebate": "0",
"isTaxCategoryCodeMandatory": "1",
"autoCalculateSectionF": "1",
"dictionaryVersion": "1283",
"buyerModificationPeriod": "48",
"autoCalculateSectionE": "0",
"taxpayerBranch": {
"brachStatus": "101",
"branchCode": "00",
"branchName": "GLOVO UGANDA SMC LIMITED",
"branchType": "101",
"contactMobile": " ",
"contactNumber": " ",
"eInvoiceStatus": "101",
"id": "687015356530910024",
"placeOfBusiness": "26 KYADONDO ROAD DFCU TOWERS KAMPALA KA...",
"registrationType": "102"
},
"hsCodeVersion": "34193",
"buyerModifiedTimes": "1",
"frequentContactsLimit": "40",
"taxType": [
{ "registrationDate": "01/07/2022", "taxTypeCode": "309", "taxTypeName": "Withholding Tax" },
{ "registrationDate": "03/02/2021", "taxTypeCode": "307", "taxTypeName": "Imports and Exports" },
{ "registrationDate": "01/12/2020", "taxTypeCode": "301", "taxTypeName": "Value Added Tax" },
{ "registrationDate": "01/11/2020", "taxTypeCode": "308", "taxTypeName": "PAYE" },
{ "registrationDate": "01/10/2020", "taxTypeCode": "302", "taxTypeName": "Income Tax" }
],
"issueDebitNote": "0",
"webServiceURL": "https://api-uat.ura.go.ug/efris",
"exciseDutyVersion": "2.0",
"maxGrossAmount": "100000000",
"isAllowBackDate": "0",
"taxpayer": {
"businessName": "GLOVO UGANDA SMC LIMITED",
"contactEmail": "nicholas.k.kabonge@pwc.com",
"contactMobile": "256312179750",
"contactNumber": "2560778497936",
"departmentId": "136",
"id": "687015356530910023",
"legalName": "GLOVO UGANDA SMC LIMITED",
"ninBrn": "/80020002742646",
"placeOfBusiness": "26 KYADONDO ROAD DFCU TOWERS KAMPALA CEN...",
"taxpayerRegistrationStatusId": "401",
"taxpayerStatusId": "101",
"taxpayerType": "202",
"tin": "1017265563"
},
"financialYearDate": "0701",
"goodsStockLimit": "101",
"exportInvoiceExciseDuty": "0",
"periodDate": "16",
"isDutyFreeTaxpayer": "0",
"lowestTCSVersion": "18",
"environment": "1",
"isAllowIssueInvoice": "1",
"sellersLogo": "",
"qrCodeURL": "https://efristest.ura.go.ug/site_new/#/i...",
"isReferenceNumberMandatory": "1",
"isAllowOutOfScopeVAT": "0",
"whetherEnableServerStock": "1",
"device": {
"branchCode": "00",
"branchId": "687015356530910024",
"deviceModel": "V-EFD",
"deviceNo": "1017265563_01",
"deviceStatus": "801",
"offlineAmount": "1001",
"offlineDays": "5",
"offlineValue": "1000000000"
}
}
}

Notes

Environment "1" commonly indicates UAT/test. Feature flags and versions may vary by tenant and time.

Some long string fields are truncated in this sample as per the latest observed payload returned by the upstream service.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Request

Responses