Metadata & Reference Data

Access reference data including Nigerian state codes, tax authority information, and other metadata required for tax calculations and filings.

State Information

All 36 states + FCT with tax codes

Tax Authorities

State revenue service contact info

Always Updated

Automatically synced with latest data

Get States Metadata

GEThttps://pioe.app/api/v1/metadata/states

Retrieve a complete list of Nigerian states with their tax authority codes, revenue service names, and contact information. Useful for populating dropdowns and validating state selections in your application.

Code Examples

const response = await fetch("https://pioe.app/api/v1/metadata/states", {
  headers: {
    "X-API-Key": "your_api_key_here"
  }
});

const data = await response.json();
console.log("Total States:", data.states.length);

// Find a specific state
const lagos = data.states.find(s => s.name === "Lagos");
console.log("Lagos Tax Code:", lagos.taxCode);
console.log("Revenue Service:", lagos.revenueService);

Success Response

200 OKSuccess response

{
  "states": [
    {
      "name": "Lagos",
      "code": "LA",
      "taxCode": "0100",
      "revenueService": "Lagos State Internal Revenue Service (LIRS)",
      "zone": "South West",
      "capital": "Ikeja",
      "contact": {
        "email": "info@lirs.gov.ng",
        "phone": "+234-1-2345678",
        "website": "https://lirs.gov.ng"
      }
    },
    {
      "name": "Abuja",
      "code": "FC",
      "taxCode": "0200",
      "revenueService": "Federal Capital Territory Internal Revenue Service (FCT-IRS)",
      "zone": "North Central",
      "capital": "Abuja",
      "contact": {
        "email": "info@fct-irs.gov.ng",
        "phone": "+234-9-8765432",
        "website": "https://fct-irs.gov.ng"
      }
    },
    {
      "name": "Kano",
      "code": "KN",
      "taxCode": "0300",
      "revenueService": "Kano State Internal Revenue Service (KIRS)",
      "zone": "North West",
      "capital": "Kano",
      "contact": {
        "email": "info@kirs.gov.ng",
        "phone": "+234-64-123456",
        "website": "https://kirs.gov.ng"
      }
    }
    // ... 34 more states
  ],
  "totalStates": 37,
  "lastUpdated": "2024-01-15T10:00:00Z"
}

Response Fields

Field	Type	Description
name	string	Full state name
code	string	2-letter state code
taxCode	string	4-digit tax authority code
revenueService	string	Official name of state revenue service
zone	string	Geopolitical zone
contact	object	Contact information (email, phone, website)

Try it Live

Use our interactive playground to test requests in real-time.

Open Playground