Dewa Bill OCR extraction API

Introduction

The DEWA Bill Extraction API is designed to automatically extract key information from DEWA (Dubai Electricity and Water Authority) utility bills submitted by users. Using OCR and document intelligence techniques, the API identifies and captures relevant fields from the bill, converting unstructured document data into a structured JSON response.

This API helps organizations digitize utility bill processing, reduce manual data entry, improve operational efficiency, and enable faster address verification, KYC, and underwriting workflows.

API Details

Endpoint:

POST  https://api.signzy.app/api/v3/extraction/dewa-bill_uae

POST  https://api-preproduction.signzy.app/api/v3/extraction/dewa-bill_uae

Request body parameters

Parameter	Type	Required	Description
file_url	string	Yes	Persist file URL (Supported file types are jpg, jpeg, png, pdf, tiff)

JSON

{ "file_url": "file url" }

Request headers

Name	Value	Required	Description
Content-Type	application/json	Yes	The type of content that the request body contains.
Authorization	XXXXXXXXXXX	Yes	An authentication token to authorize the request. Reach out to the Signzy support team to get one created.

Code samples

Code samples:

curl --location 'https://api-preproduction.signzy.app/api/v3/extraction/dewa-bill_uae' \
--header 'Content-Type: application/json' \
--header 'Authorization:<auth_key>' \
--data '{
    "file_url": "file url"
}'

Response body parameters

Group	Parameter	Data type	Description
document_identity	invoice_number	string	Bill/invoice number as printed on the DEWA bill.
document_identity	issue_date_and_month	string (date)	Bill issue date. Format: DD/MM/YYYY.
document_identity	billing_period	string	Billing cycle covered by the bill. Format: DD/MM/YYYY to DD/MM/YYYY.
borrower_corporate_profile	account_number	string	DEWA account number associated with the bill.
borrower_corporate_profile	business_partner_name	string	Registered account holder / business partner name.
borrower_corporate_profile	account_and_premise_type	string	Account category and premise type. Example: Commercial / SHED, Residential / Villa.
borrower_corporate_profile	customer_vat_number	string	Customer's VAT (TRN) number, if present on the bill.
property_geolocation	premise_number	string	Premise number identifying the metered location.
property_geolocation	physical_address_plot_info	string	Full physical address including plot/shed, area, and PO Box. May contain newline characters.
financial_overheads	total_amount_due	string	Total payable amount including currency. Example: 2,330.62 AED.
financial_overheads	current_month_total	string	Current month's charges total (currency implied as AED).
financial_overheads	total_vat_paid	string	Total VAT amount on the current bill.
credit_risk_past_arrears	previous_bill_balance	string	Outstanding balance carried over from the previous bill.
credit_risk_past_arrears	payments_received	string	Payments received against the previous balance.
operational_capacity	electricity_consumption	string	Electricity consumed in the billing period, including unit. Example: 5,897 kWh.
operational_capacity	water_consumption	string	Water consumed in the billing period, including unit. Example: 17.812 m³.
operational_capacity	sewerage_charges	string	Sewerage charges for the billing period.

Response examples

{
    "result": {
        "document_identity": {
            "invoice_number": "100930395454",
            "issue_date_and_month": "29/01/2026",
            "billing_period": "26/12/2025 to 25/01/2026"
        },
        "borrower_corporate_profile": {
            "account_number": "2042932280",
            "business_partner_name": "BLUE BIRD FOODS FACTORY L.L.C",
            "account_and_premise_type": "Commercial / SHED",
            "customer_vat_number": "100451353500003"
        },
        "property_geolocation": {
            "premise_number": "599018143",
            "physical_address_plot_info": "SHED - WH-38\n599-JEBEL ALI INDUSTRIAL FIRST,\nPO Box: 52936, Dubai, UAE"
        },
        "financial_overheads": {
            "total_amount_due": "2,330.62 AED",
            "current_month_total": "2,330.62",
            "total_vat_paid": "107.43"
        },
        "credit_risk_past_arrears": {
            "previous_bill_balance": "2,486.31",
            "payments_received": "2,486.31"
        },
        "operational_capacity": {
            "electricity_consumption": "5,897 kWh",
            "water_consumption": "17.812 m³",
            "sewerage_charges": "74.59"
        }
    }
}

Contact Us for Any Assistance

If you have any questions or need assistance, please reach out to our customer support team. You can contact us via email at [email protected]. We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively.