UAE Utility Bill Extraction

Overview

Utility bills are crucial documents in the UAE as they serve as address proof and contain important information for various administrative and legal purposes. This API facilitates the extraction of data points from utility bills issued by major providers in the UAE, such as DEWA (Dubai Electricity and Water Authority) and SEWA (Sharjah Electricity and Water Authority). The API accepts a persistent link to an image of the utility bill and returns structured data specific to the billing provider. Currently, the API supports bills from DEWA and SEWA, with plans to expand to other Emirates in the future.

Note: Additionally, we offer to build new utility bill extraction APIs, requiring 6 to 10 samples to create a tailored extraction API and timelines of around 3 to 4 weeks.

Use cases

Customer Verification: Verifies customer identity and address during account setup for financial or telecommunication services.
Automated Data Entry: Reduces manual data entry for companies that process large volumes of utility bills.
Compliance and Auditing: Assists in compliance checks by extracting and verifying address and account details from utility bills.
Payment Processing: Helps payment processors and utilities manage billing information more efficiently.
Custom OCR Development: Offers businesses the capability to create custom OCR solutions for new bill formats, enhancing their automation processes.

Documents Supported

Utility Bill Name	Emirate
Dubai Electricity and Water Authority (DEWA)	Dubai
Sharjah Electricity and Water Authority(SEWA)	Sharjah
Abu Dhabi Distribution Co. (ADDC)	Abu Dhabi

Sample API Request: Utility Bill Extraction

curl --location 'https://api.signzy.app/api/v3/uae/uae-utility-bill-extraction' \
--header 'Content-Type: application/json' 
--Authorization: <----Auth Token---->'
--data '{
  "utilityType": "1001/2001/3001",
  "fileLink": "https://persist.signzy.xyz/api/files/4645584/download/10wejkbr32978432fdsbhw78ewgfjh324ig89732482d9664b39a3b81573cd3de93e.html"
}'

Request Body Parameters

Parameter	Type	Description
utilityType	string	Utility Type being entered: Dubai DEWA Utility Bill - 1001 Sharjah SEWA Utility Bill - 2001 Abu Dhabi ADDC Utility Bill - 3001
file	array	Array containing URLs of the utility bill images to be processed.

Response Example: DEWA Utility Bill

{
    "result": {
        "invoice": "100042677273",
        "issueDate": "26/01/2022",
        "month": "January 2022",
        "period": "21/12/2021 to 21/01/2022",
        "dewaVatNumber": "100027620200003",
        "accountNumber": "2039920021",
        "accountType": "Residential",
        "businessPartner": "11699023",
        "customerName": "KAUSTABHADAS / PRI THA GHOSH",
        "landlordName": "BLOOM EMIRATES PROPERTIES LLC",
        "plotNumber": "NA",
        "premiseNumber": "681252758",
        "premiseType": "RESIDENTIAL - FLAT",
        "poBoxNumber": "127969",
        "collectiveAccountNumber": "NA",
        "customerVatNumber": "NA"
    }
}

Response Body Mapping: DEWA Utility Bill

Parameter	Type	Description
invoice	string	Invoice number of the utility bill.
issueDate	string	Date when the bill was issued.
month	string	Month and year to which the utility bill corresponds.
period	string	Billing period covered by the invoice.
dewaVatNumber	string	VAT registration number of DEWA.
accountNumber	string	Customer's account number with DEWA.
accountType	string	Type of the account (e.g., Residential, Commercial).
businessPartner	string	Business partner number associated with the account.
customerName	string	Name of the customer as stated on the bill.
landlordName	string	Name of the property owner if available.
plotNumber	string	Plot number of the property associated with the account.
premiseNumber	string	Premise number registered with DEWA.
premiseType	string	Type of the premise (e.g., RESIDENTIAL - FLAT, COMMERCIAL).
poBoxNumber	string	Post office box number associated with the bill.
collectiveAccountNumber	string	Collective account number if applicable (common in complexes).
customerVatNumber	string	VAT number of the customer if applicable.

Response Example: SEWA Utility Bill

{
    "result": {
        "tenant": "NA",
        "owner": "SHOP_30",
        "address": "NA",
        "plotNumber": "1860C",
        "area": "Industrial Area 03",
        "city": "Sharjah Main City",
        "branch": "Industrial Area",
        "deposit": "3000.00",
        "depositDate": "22/11/2022",
        "reader": "1006",
        "customerTRN": "1002323420003",
        "appLoad": "1405",
        "sewaTrnNumber": "NA",
        "personalId": "2000073405",
        "accountNumber": "510535558",
        "customerClass": "COMM C",
        "invoiceNumberDate": "040330024213 - 2/11/2023",
        "premiseId": "6001451830",
        "dueDate": "05/12/2023",
        "billingPeriod": "November 2023",
        "lastReceiptDate": "13/11/2023",
        "vat": "21.20",
        "discount": "0.00",
        "dueAmount": "559.00",
        "totalAmount": "559.00"
    }
}

Response Body Mapping for SEWA

Parameter	Type	Description
tenant	string	Name of the tenant, if applicable.
owner	string	Name of the property owner.
address	string	Full address of the property.
plotNumber	string	Plot number of the property.
area	string	Specific area where the property is located.
city	string	City where the property is situated.
branch	string	SEWA branch that issued the bill.
deposit	string	Amount of the security deposit.
depositDate	string	Date when the deposit was made.
reader	string	Reader code who recorded the meter reading.
customerTRN	string	Tax Registration Number of the customer.
appLoad	string	Approved load for electricity usage.
sewaTrnNumber	string	SEWA's TRN, if applicable.
personalId	string	Personal ID number associated with the account.
accountNumber	string	Account number for SEWA services.
customerClass	string	Classification of the customer (e.g., residential, commercial).
invoiceNumberDate	string	Invoice number and the date issued.
premiseId	string	ID of the premises as registered with SEWA.
dueDate	string	Date by which the bill is due.
billingPeriod	string	The billing period for which charges are applied.
lastReceiptDate	string	Date of the last payment receipt.
vat	string	VAT amount charged on the bill.
discount	string	Any discounts applied to the bill amount.
dueAmount	string	Amount due for payment.
totalAmount	string	Total amount charged, including VAT and other fees.

Sample Error

{
    "error": {
        "name": "error",
        "message": "Data not found for the given input",
        "status": "404",
        "reason": "NOT_FOUND",
        "type": "OK",
        "statusCode": "200"
    }
}

Error Response Parameters

Parameter	Type	Description
name	string	Name of the error.
message	string	Detailed message describing the error.
status	string	HTTP status code as a string.
reason	string	A brief explanation of the error.
type	string	Classification of the error type.
statusCode	int	Numerical HTTP status code of the error.

Getting help

Please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better.

You can reach out to us at [email protected]. We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively.

We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have. Thank you for choosing our services. We look forward to helping you!