Resources

Resources Guide

This guide covers everything you need to know about accessing reference data and lookup information for your E-Invoicing application. Our Resources API provides standardized data that can be used for dropdown menus, validation, and ensuring compliance with e-invoicing standards.

Get Currencies

Retrieve a list of supported currencies with their symbols and decimal information.

Sample Request

Sample Response

{
  "code": 200,
  "data": [
    {
      "symbol": "$",
      "name": "US Dollar",
      "symbol_native": "$",
      "decimal_digits": 2,
      "rounding": 0,
      "code": "USD",
      "name_plural": "US dollars"
    },
    {
      "symbol": "₦",
      "name": "Nigerian Naira",
      "symbol_native": "₦",
      "decimal_digits": 2,
      "rounding": 0,
      "code": "NGN",
      "name_plural": "Nigerian nairas"
    }
  ]
}

Get Tax Categories

Retrieve tax category codes and their corresponding rates for different types of goods and services.

Sample Request

Sample Response

{
  "code": 200,
  "data": [
    {
      "code": "STANDARD_GST",
      "value": "Standard Goods and Services Tax",
      "percent": "7.5"
    },
    {
      "code": "ZERO_RATED",
      "value": "Zero Rated Goods and Services",
      "percent": "0"
    },
    {
      "code": "EXEMPT",
      "value": "Exempt Goods and Services",
      "percent": "Not Available"
    }
  ]
}

Get Payment Means

Retrieve available payment method codes for invoice payment terms.

Sample Request

Sample Response

{
  "code": 200,
  "data": [
    {
      "code": "10",
      "value": "Cash"
    },
    {
      "code": "20",
      "value": "Check"
    },
    {
      "code": "30",
      "value": "Credit Transfer"
    },
    {
      "code": "91",
      "value": "Not Otherwise Specified"
    }
  ]
}

Get Invoice Types

Retrieve invoice type codes for different types of invoices and credit notes.

Sample Request

Sample Response

{
  "code": 200,
  "data": [
    {
      "code": "380",
      "value": "Commercial Invoice"
    },
    {
      "code": "384",
      "value": "Consular Invoice"
    },
    {
      "code": "389",
      "value": "Debit Note"
    },
    {
      "code": "381",
      "value": "Credit Note"
    }
  ]
}

Get Service Codes

Retrieve service classification codes for different types of services.

Sample Request

Sample Response

{
  "code": 200,
  "data": [
    {
      "description": "Growing of cereals (except rice), leguminous crops and oil seeds",
      "code": "0111"
    },
    {
      "description": "Growing of rice",
      "code": "0112"
    },
    {
      "description": "Growing of vegetables and melons, roots and tubers",
      "code": "0113"
    }
  ]
}

Get Product Codes

Retrieve Product codes for product classification.

Sample Request

Sample Response

{
  "code": 200,
  "data": [
    {
      "hscode": "0101.21",
      "description": "Horses; live, pure-bred breeding animals"
    },
    {
      "hscode": "0101.29",
      "description": "Horses; live, other than pure-bred breeding animals"
    },
    {
      "hscode": "0101.30",
      "description": "Asses; live"
    }
  ]
}

Get VAT Exemptions

Retrieve VAT exemption categories and their descriptions.

Sample Request

Sample Response

{
  "code": 200,
  "data": [
    {
      "heading_no": "29.15",
      "harmonized_system_code": "2915.3100",
      "tariff_category": "MEDICAL, VENTIRINARY AND PHARMACEUTICAL RAW MATERIALS AND PRODUCTS",
      "tariff": "Ethyl acetate",
      "description": "Saturated acyclic monocarboxylic acids and their derivatives."
    },
    {
      "heading_no": "29.15",
      "harmonized_system_code": "2915.3200",
      "tariff_category": "MEDICAL, VENTIRINARY AND PHARMACEUTICAL RAW MATERIALS AND PRODUCTS",
      "tariff": "Vinyl acetate",
      "description": "Saturated acyclic monocarboxylic acids and their derivatives."
    }
  ]
}

Get Local Government Areas

Retrieve Nigerian Local Government Areas (LGAs) with their codes and state associations.

Sample Request

Sample Response

{
  "code": 200,
  "data": [
    {
      "name": "Aba North",
      "code": "NG-AB-ANO",
      "state_code": "NG-AB"
    },
    {
      "name": "Aba South",
      "code": "NG-AB-ASO",
      "state_code": "NG-AB"
    },
    {
      "name": "Arochukwu",
      "code": "NG-AB-ARO",
      "state_code": "NG-AB"
    }
  ]
}

Get States

Retrieve Nigerian states with their codes and regional information.

Sample Request

Sample Response

{
  "code": 200,
  "data": [
    {
      "name": "Abia",
      "code": "NG-AB"
    },
    {
      "name": "Adamawa",
      "code": "NG-AD"
    },
    {
      "name": "Akwa Ibom",
      "code": "NG-AK"
    }
  ]
}

Get Countries

Retrieve a list of all available countries with their ISO codes and geographic information.

Sample Request

Sample Response

{
  "code": 200,
  "data": [
    {
      "name": "Nigeria",
      "alpha_2": "NG",
      "alpha_3": "NGA",
      "country_code": "566",
      "iso_3166_2": "ISO 3166-2:NG",
      "region": "Africa",
      "sub_region": "Sub-Saharan Africa",
      "intermediate_region": "Western Africa",
      "region_code": "002",
      "sub_region_code": "202",
      "intermediate_region_code": "011"
    }
  ]
}

Use this endpoint to populate country dropdown menus and validate country codes in invoice data.

Next Steps

Now that you understand resource management operations, explore these related topics:

Invoice Management - Create and manage invoices
Invoice Inbox - Manage received invoices

Always ensure proper validation and error handling in your implementation. Resource data is essential for compliance and accurate invoice generation. Regular updates and monitoring of resource data are important for maintaining compliance with regulatory requirements.

Overview

Getting Started

Support

Resources Guide

Get Currencies

Get Tax Categories

Get Payment Means

Get Invoice Types

Get Service Codes

Get Product Codes

Get VAT Exemptions

Get Local Government Areas

Get States

Get Countries

Next Steps

Overview

Getting Started

Support

​Resources Guide

​Get Currencies

​Get Tax Categories

​Get Payment Means

​Get Invoice Types

​Get Service Codes

​Get Product Codes

​Get VAT Exemptions

​Get Local Government Areas

​Get States

​Get Countries

​Next Steps

Resources Guide

Get Currencies

Get Tax Categories

Get Payment Means

Get Invoice Types

Get Service Codes

Get Product Codes

Get VAT Exemptions

Get Local Government Areas

Get States

Get Countries

Next Steps