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.
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!