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

Stuck on an integration step? Our engineers reply fast.