DIGIT Specifications
PlatformUrbanHealthPublic FinanceSanitation
  • Specifications Overview
    • Standardisation Approach
  • Common Service Specs
    • Access Control
    • Analytics
    • Billing
    • Collection
    • Dashboard Analytics
    • Decision Support System Ingest
    • Document Controller
    • Employee
    • Encryption
    • Filestore
    • ID Generation
    • Inbox
    • Indexer
    • Master
    • Master Data Management
    • OTP
    • Payment Gateway
    • PDF Generation
    • URL Shortening
    • User
    • Workflow
  • Domain Service Specs
    • Attendance
    • Bank Account
    • Billing Calculator
    • Birth-Death
    • Building Plan Approval
    • Building Plan Calculator
    • Campaign
    • Campaign Delivery
    • Contracts
    • Estimates
    • eChallan
    • Facility
    • Faecal Sludge Management (FSM)
    • Fire NOC
    • Fire NOC Calculator
    • Household
    • Individual
    • Inventory
    • Land
    • Muster Roll
    • National Dashboard Ingest
    • No Objection Certificate
    • Organization
    • Planning
    • Product
    • Project
    • Property Registry
    • Property Tax Calculator
    • Public Grievance Redressal
    • Registration
    • Sewerage Connection
    • Stock
    • Supervision
    • Sync
    • Trade Licence
    • Trade Licence Calculator
    • User Events
    • Vehicle Registration
    • Vendor Registration
    • Water Connection
  • Archived-docs
    • DIGIT Urban Service Specs
      • Property Tax Service
        • Property Tax Taxonomy
        • Property Tax Data Model
        • Property Tax Service API
      • Public Grievance Redressal Service
        • Public Grievance Redressal Taxonomy
        • Public Grievance Redressal Data Model
        • Public Grievance Redressal Service API
      • Trade License Service
        • Trade License Taxonomy
        • Trade License Data Model
        • Trade License API
      • Fire NOC Service
        • Fire NOC Taxonomy
        • Fire NOC Data Model
        • Fire NOC API
      • Miscellaneous Collection Service
        • Miscellaneous Collections Taxonomy
        • Miscellaneous Collections Data Model
        • Miscellaneous Collection API
      • Online Building Plan Approval Service
        • Online Building Plan Approval Taxonomy
        • Online Building Plan Approval Data Model
        • Online Building Plan Approval Service API
      • Water & Sewerage Service
        • Water & Sewerage Taxonomy
        • Water Service Data Model
        • Sewerage Service Data Model
        • Water & Sewerage Service API
      • Birth & Death Service
        • Birth & Death Taxonomy
        • Birth & Death Data Model
        • Birth & Death Service API
    • DIGIT Public Finance Management Service Specs
      • iFIX Master Data Service API
      • Adapter Master Data Service API
      • mGramSeva iFIX Adapter Service API
      • iFIX Department Entity Service API
      • Fiscal Event API
    • DIGIT Health Service Specs
      • Health Service Data Model
      • Health Service API
    • DIGIT Sanitation Service Specs
      • Faecal Sludge Management Service
        • Faecal Sludge Management Data Model
        • Faecal Sludge Management Service API
Powered by GitBook

​All content on this page by eGov Foundation is licensed under a Creative Commons Attribution 4.0 International License.

On this page

Was this helpful?

Export as PDF
  1. Common Service Specs

Billing

PreviousAnalyticsNextCollection

Last updated 2 years ago

Was this helpful?

Billing APIs

Manage demand, bill and amendments

  • Billing APIs
  • POSTcreate
  • POSTsearch
  • POSTupdate
  • POSTcancelBill
  • POSTcreate
  • POSTfetchBill
  • POSTgenrateBill
  • POSTsearch
  • POSTsearch
  • POSTcreate
  • POSTmigrate
  • POSTsearch
  • POSTupdate
  • POSTsearch
  • POSTsearch

create

post
Body
Responses
200
OK
*/*
Responseobject
201
Created
401
Unauthorized
403
Forbidden
404
Not Found
post
POST /amendment/_create HTTP/1.1
Host: billing-service
Content-Type: application/json
Accept: */*
Content-Length: 3932

{
  "Amendment": {
    "additionalDetails": {},
    "amendedDemandId": "text",
    "amendmentId": "text",
    "amendmentReason": "ARREAR_WRITE_OFF",
    "auditDetails": {
      "createdBy": "text",
      "lastModifiedBy": "text",
      "createdTime": 1,
      "lastModifiedTime": 1
    },
    "businessService": "text",
    "consumerCode": "text",
    "demandDetails": [
      {
        "id": "text",
        "demandId": "text",
        "taxHeadMasterCode": "text",
        "taxAmount": 1,
        "collectionAmount": 1,
        "additionalDetails": {},
        "auditDetails": {
          "createdBy": "text",
          "lastModifiedBy": "text",
          "createdTime": 1,
          "lastModifiedTime": 1
        },
        "tenantId": "text"
      }
    ],
    "documents": [
      {
        "additionalDetails": {},
        "documentType": "text",
        "documentUid": "text",
        "fileStoreId": "text",
        "id": "text"
      }
    ],
    "effectiveFrom": 1,
    "effectiveTill": 1,
    "id": "text",
    "reasonDocumentNumber": "text",
    "status": "ACTIVE",
    "tenantId": "text",
    "workflow": {
      "action": "text",
      "assigner": {
        "tenantId": "text",
        "id": 1,
        "userName": "text",
        "authToken": "password",
        "salutation": "text",
        "name": "text",
        "gender": "text",
        "mobileNumber": "text",
        "emailId": "text",
        "aadhaarNumber": "text",
        "active": true,
        "locale": "text",
        "type": "text",
        "accountLocked": true,
        "roles": [
          {
            "name": "text",
            "description": "text"
          }
        ],
        "userDetails": {
          "firstName": "text",
          "middleName": "text",
          "lastName": "text",
          "dob": "2025-05-09",
          "altContactNumber": "text",
          "fatherName": "text",
          "husbandName": "text",
          "bloodGroup": "text",
          "pan": "text",
          "permanentAddress": "text",
          "permanentCity": "text",
          "permanentPincode": "text",
          "correspondenceCity": "text",
          "correspondencePincode": "text",
          "correspondenceAddress": "text",
          "signature": "text",
          "identificationMark": "text",
          "photo": "text"
        },
        "auditDetails": {
          "createdBy": "text",
          "lastModifiedBy": "text",
          "createdTime": 1,
          "lastModifiedTime": 1
        }
      },
      "assignes": [
        {
          "tenantId": "text",
          "id": 1,
          "userName": "text",
          "authToken": "password",
          "salutation": "text",
          "name": "text",
          "gender": "text",
          "mobileNumber": "text",
          "emailId": "text",
          "aadhaarNumber": "text",
          "active": true,
          "locale": "text",
          "type": "text",
          "accountLocked": true,
          "roles": [
            {
              "name": "text",
              "description": "text"
            }
          ],
          "userDetails": {
            "firstName": "text",
            "middleName": "text",
            "lastName": "text",
            "dob": "2025-05-09",
            "altContactNumber": "text",
            "fatherName": "text",
            "husbandName": "text",
            "bloodGroup": "text",
            "pan": "text",
            "permanentAddress": "text",
            "permanentCity": "text",
            "permanentPincode": "text",
            "correspondenceCity": "text",
            "correspondencePincode": "text",
            "correspondenceAddress": "text",
            "signature": "text",
            "identificationMark": "text",
            "photo": "text"
          },
          "auditDetails": {
            "createdBy": "text",
            "lastModifiedBy": "text",
            "createdTime": 1,
            "lastModifiedTime": 1
          }
        }
      ],
      "auditDetails": {
        "createdBy": "text",
        "lastModifiedBy": "text",
        "createdTime": 1,
        "lastModifiedTime": 1
      },
      "businessId": "text",
      "businessService": "text",
      "businesssServiceSla": 1,
      "comment": "text",
      "documents": [
        {
          "additionalDetails": {},
          "documentType": "text",
          "documentUid": "text",
          "fileStoreId": "text",
          "id": "text"
        }
      ],
      "entity": {},
      "id": "text",
      "moduleName": "text",
      "nextActions": [
        {
          "action": "text",
          "auditDetails": {
            "createdBy": "text",
            "lastModifiedBy": "text",
            "createdTime": 1,
            "lastModifiedTime": 1
          },
          "currentState": "text",
          "nextState": "text",
          "roles": [
            "text"
          ],
          "tenantId": "text",
          "uuid": "text"
        }
      ],
      "previousStatus": "text",
      "state": {
        "actions": [
          {
            "action": "text",
            "auditDetails": {
              "createdBy": "text",
              "lastModifiedBy": "text",
              "createdTime": 1,
              "lastModifiedTime": 1
            },
            "currentState": "text",
            "nextState": "text",
            "roles": [
              "text"
            ],
            "tenantId": "text",
            "uuid": "text"
          }
        ],
        "applicationStatus": "text",
        "auditDetails": {
          "createdBy": "text",
          "lastModifiedBy": "text",
          "createdTime": 1,
          "lastModifiedTime": 1
        },
        "businessServiceId": "text",
        "docUploadRequired": true,
        "isStartState": true,
        "isStateUpdatable": true,
        "isTerminateState": true,
        "sla": 1,
        "state": "text",
        "tenantId": "text",
        "uuid": "text"
      },
      "stateSla": 1,
      "tenantId": "text"
    }
  },
  "RequestInfo": {
    "apiId": "text",
    "ver": "text",
    "ts": 1,
    "action": "text",
    "did": "text",
    "key": "text",
    "msgId": "text",
    "requesterId": "text",
    "authToken": "text",
    "userInfo": {
      "tenantId": "text",
      "id": 1,
      "userName": "text",
      "mobile": "text",
      "email": "text",
      "primaryrole": [
        {
          "name": "text",
          "description": "text"
        }
      ],
      "additionalroles": [
        {
          "tenantId": "text",
          "roles": [
            {
              "name": "text",
              "description": "text"
            }
          ]
        }
      ]
    }
  }
}
{}

search

post
Query parameters
amendmentIdstringOptional
businessServicestringRequired
consumerCodestring[]Optional
mobileNumberstringOptional
statusstring[]Optional
tenantIdstringRequired
Body
Responses
200
OK
*/*
Responseobject
201
Created
401
Unauthorized
403
Forbidden
404
Not Found
post
POST /amendment/_search?businessService=text&tenantId=text HTTP/1.1
Host: billing-service
Content-Type: application/json
Accept: */*
Content-Length: 376

{
  "RequestInfo": {
    "apiId": "text",
    "ver": "text",
    "ts": 1,
    "action": "text",
    "did": "text",
    "key": "text",
    "msgId": "text",
    "requesterId": "text",
    "authToken": "text",
    "userInfo": {
      "tenantId": "text",
      "id": 1,
      "userName": "text",
      "mobile": "text",
      "email": "text",
      "primaryrole": [
        {
          "name": "text",
          "description": "text"
        }
      ],
      "additionalroles": [
        {
          "tenantId": "text",
          "roles": [
            {
              "name": "text",
              "description": "text"
            }
          ]
        }
      ]
    }
  }
}
{}

update

post
Body
Responses
200
OK
*/*
Responseobject
201
Created
401
Unauthorized
403
Forbidden
404
Not Found
post
POST /amendment/_update HTTP/1.1
Host: billing-service
Content-Type: application/json
Accept: */*
Content-Length: 3526

{
  "AmendmentUpdate": {
    "additionalDetails": {},
    "amendedDemandId": "text",
    "amendmentId": "text",
    "auditDetails": {
      "createdBy": "text",
      "lastModifiedBy": "text",
      "createdTime": 1,
      "lastModifiedTime": 1
    },
    "documents": [
      {
        "additionalDetails": {},
        "documentType": "text",
        "documentUid": "text",
        "fileStoreId": "text",
        "id": "text"
      }
    ],
    "status": "ACTIVE",
    "tenantId": "text",
    "workflow": {
      "action": "text",
      "assigner": {
        "tenantId": "text",
        "id": 1,
        "userName": "text",
        "authToken": "password",
        "salutation": "text",
        "name": "text",
        "gender": "text",
        "mobileNumber": "text",
        "emailId": "text",
        "aadhaarNumber": "text",
        "active": true,
        "locale": "text",
        "type": "text",
        "accountLocked": true,
        "roles": [
          {
            "name": "text",
            "description": "text"
          }
        ],
        "userDetails": {
          "firstName": "text",
          "middleName": "text",
          "lastName": "text",
          "dob": "2025-05-09",
          "altContactNumber": "text",
          "fatherName": "text",
          "husbandName": "text",
          "bloodGroup": "text",
          "pan": "text",
          "permanentAddress": "text",
          "permanentCity": "text",
          "permanentPincode": "text",
          "correspondenceCity": "text",
          "correspondencePincode": "text",
          "correspondenceAddress": "text",
          "signature": "text",
          "identificationMark": "text",
          "photo": "text"
        },
        "auditDetails": {
          "createdBy": "text",
          "lastModifiedBy": "text",
          "createdTime": 1,
          "lastModifiedTime": 1
        }
      },
      "assignes": [
        {
          "tenantId": "text",
          "id": 1,
          "userName": "text",
          "authToken": "password",
          "salutation": "text",
          "name": "text",
          "gender": "text",
          "mobileNumber": "text",
          "emailId": "text",
          "aadhaarNumber": "text",
          "active": true,
          "locale": "text",
          "type": "text",
          "accountLocked": true,
          "roles": [
            {
              "name": "text",
              "description": "text"
            }
          ],
          "userDetails": {
            "firstName": "text",
            "middleName": "text",
            "lastName": "text",
            "dob": "2025-05-09",
            "altContactNumber": "text",
            "fatherName": "text",
            "husbandName": "text",
            "bloodGroup": "text",
            "pan": "text",
            "permanentAddress": "text",
            "permanentCity": "text",
            "permanentPincode": "text",
            "correspondenceCity": "text",
            "correspondencePincode": "text",
            "correspondenceAddress": "text",
            "signature": "text",
            "identificationMark": "text",
            "photo": "text"
          },
          "auditDetails": {
            "createdBy": "text",
            "lastModifiedBy": "text",
            "createdTime": 1,
            "lastModifiedTime": 1
          }
        }
      ],
      "auditDetails": {
        "createdBy": "text",
        "lastModifiedBy": "text",
        "createdTime": 1,
        "lastModifiedTime": 1
      },
      "businessId": "text",
      "businessService": "text",
      "businesssServiceSla": 1,
      "comment": "text",
      "documents": [
        {
          "additionalDetails": {},
          "documentType": "text",
          "documentUid": "text",
          "fileStoreId": "text",
          "id": "text"
        }
      ],
      "entity": {},
      "id": "text",
      "moduleName": "text",
      "nextActions": [
        {
          "action": "text",
          "auditDetails": {
            "createdBy": "text",
            "lastModifiedBy": "text",
            "createdTime": 1,
            "lastModifiedTime": 1
          },
          "currentState": "text",
          "nextState": "text",
          "roles": [
            "text"
          ],
          "tenantId": "text",
          "uuid": "text"
        }
      ],
      "previousStatus": "text",
      "state": {
        "actions": [
          {
            "action": "text",
            "auditDetails": {
              "createdBy": "text",
              "lastModifiedBy": "text",
              "createdTime": 1,
              "lastModifiedTime": 1
            },
            "currentState": "text",
            "nextState": "text",
            "roles": [
              "text"
            ],
            "tenantId": "text",
            "uuid": "text"
          }
        ],
        "applicationStatus": "text",
        "auditDetails": {
          "createdBy": "text",
          "lastModifiedBy": "text",
          "createdTime": 1,
          "lastModifiedTime": 1
        },
        "businessServiceId": "text",
        "docUploadRequired": true,
        "isStartState": true,
        "isStateUpdatable": true,
        "isTerminateState": true,
        "sla": 1,
        "state": "text",
        "tenantId": "text",
        "uuid": "text"
      },
      "stateSla": 1,
      "tenantId": "text"
    }
  },
  "RequestInfo": {
    "apiId": "text",
    "ver": "text",
    "ts": 1,
    "action": "text",
    "did": "text",
    "key": "text",
    "msgId": "text",
    "requesterId": "text",
    "authToken": "text",
    "userInfo": {
      "tenantId": "text",
      "id": 1,
      "userName": "text",
      "mobile": "text",
      "email": "text",
      "primaryrole": [
        {
          "name": "text",
          "description": "text"
        }
      ],
      "additionalroles": [
        {
          "tenantId": "text",
          "roles": [
            {
              "name": "text",
              "description": "text"
            }
          ]
        }
      ]
    }
  }
}
{}

cancelBill

post
Body
Responses
200
OK
*/*
Responseobject
201
Created
401
Unauthorized
403
Forbidden
404
Not Found
post
POST /bill/v2/_cancelbill HTTP/1.1
Host: billing-service
Content-Type: application/json
Accept: */*
Content-Length: 538

{
  "requestInfo": {
    "apiId": "text",
    "ver": "text",
    "ts": 1,
    "action": "text",
    "did": "text",
    "key": "text",
    "msgId": "text",
    "requesterId": "text",
    "authToken": "text",
    "userInfo": {
      "tenantId": "text",
      "id": 1,
      "userName": "text",
      "mobile": "text",
      "email": "text",
      "primaryrole": [
        {
          "name": "text",
          "description": "text"
        }
      ],
      "additionalroles": [
        {
          "tenantId": "text",
          "roles": [
            {
              "name": "text",
              "description": "text"
            }
          ]
        }
      ]
    }
  },
  "updateBillCriteria": {
    "additionalDetails": {},
    "billIds": [
      "text"
    ],
    "businessService": "text",
    "consumerCodes": [
      "text"
    ],
    "statusToBeUpdated": "ACTIVE",
    "tenantId": "text"
  }
}
{}

create

post
Body
Responses
200
OK
*/*
Responseobject
201
Created
401
Unauthorized
403
Forbidden
404
Not Found
post
POST /bill/v2/_create HTTP/1.1
Host: billing-service
Content-Type: application/json
Accept: */*
Content-Length: 1212

{
  "Bills": [
    {
      "additionalDetails": {},
      "auditDetails": {
        "createdBy": "text",
        "lastModifiedBy": "text",
        "createdTime": 1,
        "lastModifiedTime": 1
      },
      "billDate": 1,
      "billDetails": [
        {
          "additionalDetails": {},
          "amount": 1,
          "amountPaid": 1,
          "billAccountDetails": [
            {
              "additionalDetails": {},
              "adjustedAmount": 1,
              "amount": 1,
              "auditDetails": {
                "createdBy": "text",
                "lastModifiedBy": "text",
                "createdTime": 1,
                "lastModifiedTime": 1
              },
              "billDetailId": "text",
              "demandDetailId": "text",
              "id": "text",
              "order": 1,
              "taxHeadCode": "text",
              "tenantId": "text"
            }
          ],
          "billId": "text",
          "demandId": "text",
          "expiryDate": 1,
          "fromPeriod": 1,
          "id": "text",
          "tenantId": "text",
          "toPeriod": 1
        }
      ],
      "billNumber": "text",
      "businessService": "text",
      "consumerCode": "text",
      "fileStoreId": "text",
      "id": "text",
      "mobileNumber": "text",
      "payerAddress": "text",
      "payerEmail": "text",
      "payerName": "text",
      "status": "ACTIVE",
      "tenantId": "text",
      "totalAmount": 1
    }
  ],
  "RequestInfo": {
    "apiId": "text",
    "ver": "text",
    "ts": 1,
    "action": "text",
    "did": "text",
    "key": "text",
    "msgId": "text",
    "requesterId": "text",
    "authToken": "text",
    "userInfo": {
      "tenantId": "text",
      "id": 1,
      "userName": "text",
      "mobile": "text",
      "email": "text",
      "primaryrole": [
        {
          "name": "text",
          "description": "text"
        }
      ],
      "additionalroles": [
        {
          "tenantId": "text",
          "roles": [
            {
              "name": "text",
              "description": "text"
            }
          ]
        }
      ]
    }
  }
}
{}

fetchBill

post
Query parameters
businessServicestring · max: 256Required
consumerCodestring[]Optional
demandIdstring · max: 64Optional
emailstringOptional
mobileNumberstringOptionalPattern: ^[0-9]{10}$
tenantIdstring · max: 256Required
Body
Responses
200
OK
*/*
Responseobject
201
Created
401
Unauthorized
403
Forbidden
404
Not Found
post
POST /bill/v2/_fetchbill?businessService=text&tenantId=text HTTP/1.1
Host: billing-service
Content-Type: application/json
Accept: */*
Content-Length: 376

{
  "RequestInfo": {
    "apiId": "text",
    "ver": "text",
    "ts": 1,
    "action": "text",
    "did": "text",
    "key": "text",
    "msgId": "text",
    "requesterId": "text",
    "authToken": "text",
    "userInfo": {
      "tenantId": "text",
      "id": 1,
      "userName": "text",
      "mobile": "text",
      "email": "text",
      "primaryrole": [
        {
          "name": "text",
          "description": "text"
        }
      ],
      "additionalroles": [
        {
          "tenantId": "text",
          "roles": [
            {
              "name": "text",
              "description": "text"
            }
          ]
        }
      ]
    }
  }
}
{}

genrateBill

post
Query parameters
businessServicestring · max: 256Required
consumerCodestring[]Optional
demandIdstring · max: 64Optional
emailstringOptional
mobileNumberstringOptionalPattern: ^[0-9]{10}$
tenantIdstring · max: 256Required
Body
Responses
200
OK
*/*
Responseobject
201
Created
401
Unauthorized
403
Forbidden
404
Not Found
post
POST /bill/v2/_generate?businessService=text&tenantId=text HTTP/1.1
Host: billing-service
Content-Type: application/json
Accept: */*
Content-Length: 376

{
  "RequestInfo": {
    "apiId": "text",
    "ver": "text",
    "ts": 1,
    "action": "text",
    "did": "text",
    "key": "text",
    "msgId": "text",
    "requesterId": "text",
    "authToken": "text",
    "userInfo": {
      "tenantId": "text",
      "id": 1,
      "userName": "text",
      "mobile": "text",
      "email": "text",
      "primaryrole": [
        {
          "name": "text",
          "description": "text"
        }
      ],
      "additionalroles": [
        {
          "tenantId": "text",
          "roles": [
            {
              "name": "text",
              "description": "text"
            }
          ]
        }
      ]
    }
  }
}
{}

search

post
Query parameters
billIdstring[]Optional
billNumberstring · max: 256Optional
consumerCodestring[]Optional
emailstringOptional
fromPeriodinteger · int64Optional
isActivebooleanOptional
isCancelledbooleanOptional
mobileNumberstringOptionalPattern: ^[0-9]{10}$
offsetinteger · int64Optional
orderBybooleanOptional
retrieveOldestbooleanOptional
servicestring · max: 256Optional
sizeinteger · int64Optional
statusstring · enumOptionalPossible values:
tenantIdstring · max: 256Required
toPeriodinteger · int64Optional
Body
Responses
200
OK
*/*
Responseobject
201
Created
401
Unauthorized
403
Forbidden
404
Not Found
post
POST /bill/v2/_search?tenantId=text HTTP/1.1
Host: billing-service
Content-Type: application/json
Accept: */*
Content-Length: 376

{
  "RequestInfo": {
    "apiId": "text",
    "ver": "text",
    "ts": 1,
    "action": "text",
    "did": "text",
    "key": "text",
    "msgId": "text",
    "requesterId": "text",
    "authToken": "text",
    "userInfo": {
      "tenantId": "text",
      "id": 1,
      "userName": "text",
      "mobile": "text",
      "email": "text",
      "primaryrole": [
        {
          "name": "text",
          "description": "text"
        }
      ],
      "additionalroles": [
        {
          "tenantId": "text",
          "roles": [
            {
              "name": "text",
              "description": "text"
            }
          ]
        }
      ]
    }
  }
}
{}

search

post
Query parameters
businessServicestring[]Required
idstring[]Optional
tenantIdstringRequired
Body
Responses
200
OK
*/*
Responseobject
201
Created
401
Unauthorized
403
Forbidden
404
Not Found
post
POST /businessservices/_search?businessService=text&tenantId=text HTTP/1.1
Host: billing-service
Content-Type: application/json
Accept: */*
Content-Length: 376

{
  "RequestInfo": {
    "apiId": "text",
    "ver": "text",
    "ts": 1,
    "action": "text",
    "did": "text",
    "key": "text",
    "msgId": "text",
    "requesterId": "text",
    "authToken": "text",
    "userInfo": {
      "tenantId": "text",
      "id": 1,
      "userName": "text",
      "mobile": "text",
      "email": "text",
      "primaryrole": [
        {
          "name": "text",
          "description": "text"
        }
      ],
      "additionalroles": [
        {
          "tenantId": "text",
          "roles": [
            {
              "name": "text",
              "description": "text"
            }
          ]
        }
      ]
    }
  }
}
{}

create

post
Body
Responses
200
OK
*/*
Responseobject
201
Created
401
Unauthorized
403
Forbidden
404
Not Found
post
POST /demand/_create HTTP/1.1
Host: billing-service
Content-Type: application/json
Accept: */*
Content-Length: 1745

{
  "RequestInfo": {
    "apiId": "text",
    "ver": "text",
    "ts": 1,
    "action": "text",
    "did": "text",
    "key": "text",
    "msgId": "text",
    "requesterId": "text",
    "authToken": "text",
    "userInfo": {
      "tenantId": "text",
      "id": 1,
      "userName": "text",
      "mobile": "text",
      "email": "text",
      "primaryrole": [
        {
          "name": "text",
          "description": "text"
        }
      ],
      "additionalroles": [
        {
          "tenantId": "text",
          "roles": [
            {
              "name": "text",
              "description": "text"
            }
          ]
        }
      ]
    }
  },
  "Demand": [
    {
      "id": "text",
      "tenantId": "text",
      "consumerCode": "text",
      "consumerType": "text",
      "businessService": "text",
      "payer": {
        "tenantId": "text",
        "id": 1,
        "userName": "text",
        "authToken": "password",
        "salutation": "text",
        "name": "text",
        "gender": "text",
        "mobileNumber": "text",
        "emailId": "text",
        "aadhaarNumber": "text",
        "active": true,
        "locale": "text",
        "type": "text",
        "accountLocked": true,
        "roles": [
          {
            "name": "text",
            "description": "text"
          }
        ],
        "userDetails": {
          "firstName": "text",
          "middleName": "text",
          "lastName": "text",
          "dob": "2025-05-09",
          "altContactNumber": "text",
          "fatherName": "text",
          "husbandName": "text",
          "bloodGroup": "text",
          "pan": "text",
          "permanentAddress": "text",
          "permanentCity": "text",
          "permanentPincode": "text",
          "correspondenceCity": "text",
          "correspondencePincode": "text",
          "correspondenceAddress": "text",
          "signature": "text",
          "identificationMark": "text",
          "photo": "text"
        },
        "auditDetails": {
          "createdBy": "text",
          "lastModifiedBy": "text",
          "createdTime": 1,
          "lastModifiedTime": 1
        }
      },
      "taxPeriodFrom": 1,
      "taxPeriodTo": 1,
      "demandDetails": [
        {
          "id": "text",
          "demandId": "text",
          "taxHeadMasterCode": "text",
          "taxAmount": 1,
          "collectionAmount": 1,
          "additionalDetails": {},
          "auditDetails": {
            "createdBy": "text",
            "lastModifiedBy": "text",
            "createdTime": 1,
            "lastModifiedTime": 1
          },
          "tenantId": "text"
        }
      ],
      "billExpiryTime": 1,
      "auditDetails": {
        "createdBy": "text",
        "lastModifiedBy": "text",
        "createdTime": 1,
        "lastModifiedTime": 1
      },
      "additionalDetails": {},
      "status": "ACTIVE"
    }
  ]
}
{}

migrate

post
Query parameters
batchStartinteger · int32Optional

batchStart

batchSizeInputinteger · int32Required

batchSizeInput

Body
Responses
200
OK
*/*
Responseobject
201
Created
401
Unauthorized
403
Forbidden
404
Not Found
post
POST /demand/_migratetov1?batchSizeInput=1 HTTP/1.1
Host: billing-service
Content-Type: application/json
Accept: */*
Content-Length: 376

{
  "RequestInfo": {
    "apiId": "text",
    "ver": "text",
    "ts": 1,
    "action": "text",
    "did": "text",
    "key": "text",
    "msgId": "text",
    "requesterId": "text",
    "authToken": "text",
    "userInfo": {
      "tenantId": "text",
      "id": 1,
      "userName": "text",
      "mobile": "text",
      "email": "text",
      "primaryrole": [
        {
          "name": "text",
          "description": "text"
        }
      ],
      "additionalroles": [
        {
          "tenantId": "text",
          "roles": [
            {
              "name": "text",
              "description": "text"
            }
          ]
        }
      ]
    }
  }
}
{}

search

post
Query parameters
businessServicestringOptional
consumerCodestring[]Optional
demandFromnumber · bigdecimalOptional
demandIdstring[]Optional
demandTonumber · bigdecimalOptional
emailstringOptional
isPaymentCompletedbooleanOptional
mobileNumberstringOptional
payerstring[]Optional
periodFrominteger · int64Optional
periodTointeger · int64Optional
receiptRequiredbooleanOptional
statusstringOptional
tenantIdstringRequired
typestring · enumOptionalPossible values:
Body
Responses
200
OK
*/*
Responseobject
201
Created
401
Unauthorized
403
Forbidden
404
Not Found
post
POST /demand/_search?tenantId=text HTTP/1.1
Host: billing-service
Content-Type: application/json
Accept: */*
Content-Length: 376

{
  "RequestInfo": {
    "apiId": "text",
    "ver": "text",
    "ts": 1,
    "action": "text",
    "did": "text",
    "key": "text",
    "msgId": "text",
    "requesterId": "text",
    "authToken": "text",
    "userInfo": {
      "tenantId": "text",
      "id": 1,
      "userName": "text",
      "mobile": "text",
      "email": "text",
      "primaryrole": [
        {
          "name": "text",
          "description": "text"
        }
      ],
      "additionalroles": [
        {
          "tenantId": "text",
          "roles": [
            {
              "name": "text",
              "description": "text"
            }
          ]
        }
      ]
    }
  }
}
{}

update

post
Body
Responses
200
OK
*/*
Responseobject
201
Created
401
Unauthorized
403
Forbidden
404
Not Found
post
POST /demand/_update HTTP/1.1
Host: billing-service
Content-Type: application/json
Accept: */*
Content-Length: 1745

{
  "RequestInfo": {
    "apiId": "text",
    "ver": "text",
    "ts": 1,
    "action": "text",
    "did": "text",
    "key": "text",
    "msgId": "text",
    "requesterId": "text",
    "authToken": "text",
    "userInfo": {
      "tenantId": "text",
      "id": 1,
      "userName": "text",
      "mobile": "text",
      "email": "text",
      "primaryrole": [
        {
          "name": "text",
          "description": "text"
        }
      ],
      "additionalroles": [
        {
          "tenantId": "text",
          "roles": [
            {
              "name": "text",
              "description": "text"
            }
          ]
        }
      ]
    }
  },
  "Demand": [
    {
      "id": "text",
      "tenantId": "text",
      "consumerCode": "text",
      "consumerType": "text",
      "businessService": "text",
      "payer": {
        "tenantId": "text",
        "id": 1,
        "userName": "text",
        "authToken": "password",
        "salutation": "text",
        "name": "text",
        "gender": "text",
        "mobileNumber": "text",
        "emailId": "text",
        "aadhaarNumber": "text",
        "active": true,
        "locale": "text",
        "type": "text",
        "accountLocked": true,
        "roles": [
          {
            "name": "text",
            "description": "text"
          }
        ],
        "userDetails": {
          "firstName": "text",
          "middleName": "text",
          "lastName": "text",
          "dob": "2025-05-09",
          "altContactNumber": "text",
          "fatherName": "text",
          "husbandName": "text",
          "bloodGroup": "text",
          "pan": "text",
          "permanentAddress": "text",
          "permanentCity": "text",
          "permanentPincode": "text",
          "correspondenceCity": "text",
          "correspondencePincode": "text",
          "correspondenceAddress": "text",
          "signature": "text",
          "identificationMark": "text",
          "photo": "text"
        },
        "auditDetails": {
          "createdBy": "text",
          "lastModifiedBy": "text",
          "createdTime": 1,
          "lastModifiedTime": 1
        }
      },
      "taxPeriodFrom": 1,
      "taxPeriodTo": 1,
      "demandDetails": [
        {
          "id": "text",
          "demandId": "text",
          "taxHeadMasterCode": "text",
          "taxAmount": 1,
          "collectionAmount": 1,
          "additionalDetails": {},
          "auditDetails": {
            "createdBy": "text",
            "lastModifiedBy": "text",
            "createdTime": 1,
            "lastModifiedTime": 1
          },
          "tenantId": "text"
        }
      ],
      "billExpiryTime": 1,
      "auditDetails": {
        "createdBy": "text",
        "lastModifiedBy": "text",
        "createdTime": 1,
        "lastModifiedTime": 1
      },
      "additionalDetails": {},
      "status": "ACTIVE"
    }
  ]
}
{}

search

post
Query parameters
categorystringOptional
codestring[]Optional
idstring[]Optional
isActualDemandbooleanOptional
isDebitbooleanOptional
namestringOptional
servicestringRequired
tenantIdstringRequired
Body
Responses
200
OK
*/*
Responseobject
201
Created
401
Unauthorized
403
Forbidden
404
Not Found
post
POST /taxheads/_search?service=text&tenantId=text HTTP/1.1
Host: billing-service
Content-Type: application/json
Accept: */*
Content-Length: 376

{
  "RequestInfo": {
    "apiId": "text",
    "ver": "text",
    "ts": 1,
    "action": "text",
    "did": "text",
    "key": "text",
    "msgId": "text",
    "requesterId": "text",
    "authToken": "text",
    "userInfo": {
      "tenantId": "text",
      "id": 1,
      "userName": "text",
      "mobile": "text",
      "email": "text",
      "primaryrole": [
        {
          "name": "text",
          "description": "text"
        }
      ],
      "additionalroles": [
        {
          "tenantId": "text",
          "roles": [
            {
              "name": "text",
              "description": "text"
            }
          ]
        }
      ]
    }
  }
}
{}

search

post
Query parameters
codestringOptional
dateinteger · int64Optional
fromDateinteger · int64Optional
idstring[]Optional
periodCyclestring · enumOptionalPossible values:
servicestring[]Required
tenantIdstringRequired
toDateinteger · int64Optional
Body
Responses
200
OK
*/*
Responseobject
201
Created
401
Unauthorized
403
Forbidden
404
Not Found
post
POST /taxperiods/_search?service=text&tenantId=text HTTP/1.1
Host: billing-service
Content-Type: application/json
Accept: */*
Content-Length: 376

{
  "RequestInfo": {
    "apiId": "text",
    "ver": "text",
    "ts": 1,
    "action": "text",
    "did": "text",
    "key": "text",
    "msgId": "text",
    "requesterId": "text",
    "authToken": "text",
    "userInfo": {
      "tenantId": "text",
      "id": 1,
      "userName": "text",
      "mobile": "text",
      "email": "text",
      "primaryrole": [
        {
          "name": "text",
          "description": "text"
        }
      ],
      "additionalroles": [
        {
          "tenantId": "text",
          "roles": [
            {
              "name": "text",
              "description": "text"
            }
          ]
        }
      ]
    }
  }
}
{}