Agents & Accounts
URA authorises some taxpayers to issue invoices on behalf of others. These endpoints cover the agent lookups and two account operations.
| Endpoint | Purpose |
|---|---|
POST /query-agent-relations |
The principals you may invoice for as an agent |
POST /query-principal-agent-info |
A principal's invoicing settings (tax types, back-dating, restrictions) |
POST /create-ussd-account |
Create a USSD account for a taxpayer and mobile number |
POST /reset-password |
Reset the EFRIS (URA portal) user password |
Invoicing as an agent
Agent invoices are issued with the usual invoice endpoint, naming the principal:
{
"invoice": {
"agentEntity": {
"tin": "1000029771",
"legalName": "Principal Holdings Ltd",
...
},
...
}
}
Want a working example of an agent invoice? Chat with our team
Resetting the password changes the EFRIS user's URA portal login. It doesn't affect your API key.
Looking for the complete reference? Field definitions, code lists, validation rules, error
handling, and ready-to-run examples for every endpoint are available inside your EFRIS Simplified dashboard
once your business is registered on the platform.
Sign in to the dashboard · Get started
Sign in to the dashboard · Get started