Searching for Contractors and Permits

Requests should be initiated to the following url https://permits.himaintenance.io/
Header should contain x-api-key parameter which can be requested here

Contractor Search URL

/POST

https://permits.himaintenance.io/contractor-api/v1/initiate-search

Accepted Parameters for initiate-search API
  • contractor_organization
Status for Searched Contractor URL

/GET

https://permits.himaintenance.io/contractor-api/v1/get-status/

Accepted Parameters for get-status API
  • reference_id
Get Contractor Data for Searched Contractor URL

/GET

https://permits.himaintenance.io/contractor-api/v1/get_contractor_data/

Accepted Parameters for get_contractor_data API
  • contractor_ref_id
Get Permits for Searched Contractor URL

/GET

https://permits.himaintenance.io/contractor-api/v1/get_permits/

Accepted Parameters for get_permits API
  • contractor_ref_id

API Base Result

/POST

https://permits.himaintenance.io/contractor-api/v1/initiate-search

Body
{ "contractor_organization": "SIEMENS" }
Response Body with status code
200
{
    "reference_id": "ccea63edcba84c97a69240e07753e3fe",
     "contractor_organization": "SIEMENS"
    "status": "IN_PROGRESS"
}

/GET

https://permits.himaintenance.io/contractor-api/v1/get-status/?reference_id=ccea63edcba84c97a69240e07753e3fe

Query Param Value
reference_id ccea63edcba84c97a69240e07753e3fe
Response Body with status code
200
{
    "searched_organization": "SIEMENS"
    "search_result": [
        {
          "company_name": "SIEMENS",
          "contractor_ref_id": ccea63edcba84c97a69240e07753e3fe-CCA00012901,
      }
        {
          "company_name": "SIEMENS ENERGY",
          "contractor_ref_id": ccea63edcba84c97a69240e07753e3fe-CWI00001367,
      }
                        ]
    "status": "CONTRACTOR_FOUND"

  }

/GET

https://permits.himaintenance.io/contractor-api/v1/get_contractor_data/?contractor_ref_id=ce6b6fae38f94a22938103b6210ea26b-CCA00012901

Query Param Value
contractor_ref_id ce6b6fae38f94a22938103b6210ea26b-CCA00012901
Response Body with status code
200
    {
        "contractor_ref_id":"ce6b6fae38f94a22938103b6210ea26b-CCA00012901",

        "result": {
            "contractor_id":"CCA00012901",
            "company_name":"SIEMENS",
            "contact_name":"DAN EDWARDS",
            "contractor_email":"EDWARDS@UGSOLUTIONS.COM",
            "contractor_phone":"6786913946.0",
            "contractor_address":"1335 RIDGELAND PKWY ALPHARETTA GA 30004-0728",
            "county":"FORSYTH",
            "sic_code":"171131",
            "number_of_employee":"1 To 4",
            "annual_sales":"$500,000 To $1 Million",
            "contact_role":"MANAGER",
            "industry":"ENERGY MANAGEMENT SYSTEMS & PRODUCTS"
        }
    }

/GET

https://permits.himaintenance.io/contractor-api/v1/get_permits/?contractor_ref_id=ce6b6fae38f94a22938103b6210ea26b-CCA00012901

Query Param Value
contractor_ref_id ce6b6fae38f94a22938103b6210ea26b-CCA00012901
Response Body with status code
200
    {
    "permit_details": [
        {
            "property_address": "1200 DISCOVERY DR BAKERSFIELD CA 93309",
            "property_id": "P0602900073332",
            "permit_number": "03 - 10000057",
            "permit_status": "APPROVED",
            "permit_category": "Fire Protection Permit",
            "permit_type": "Fire Other",
            "work_description": "FIRE ALARM PERMIT",
            "permit_issued_date": "2003-03-21",
            "permit_fees": "$577.5",
            "total_sqft": "22170",
            "permit_id": 164027,
            "owner_details": [
                {
                    "owner_organization": "MONY LIFE INSURANCE CO",
                    "owner_type": "role"
                }
            ],
            "contractor_details": [
                {
                    "contractor_organization": "SIEMENS",
                    "contractor_type": "role"
                }
            ]
        },
        {
            "property_address": "3270 KERNER BLVD SAN RAFAEL CA 94901",
            "property_id": "P0604100031088",
            "permit_number": "F1604-015",
            "permit_status": "FINALED",
            "permit_category": "Fire Protection Permit",
            "permit_type": "Fire Other",
            "work_description": "Fire Alarm "Marin Health & Wellness",
            "permit_issued_date": "2016-04-19",
            "permit_fees": "$322.5",
            "total_sqft": "236530",
            "permit_id": 138457,
            "owner_details": [
                {
                    "owner_organization": "MARIN COUNTY DEPT OF PUBLIC WO",
                    "owner_type": "role"
                }
            ],
            "contractor_details": [
                {
                    "contractor_organization": "Siemens",
                    "contractor_type": "role"
                }
            ]
        }
    ],
    "total_valuation": 0.0,
    "permits_count": 2
    }



Audit Service

/GET

Using Tenant ID
http://permits.himaintenance.io/audit-svc/tenanttransactionscount?tenant_id=tenant4

/GET

Using User ID
http://permits.himaintenance.io/audit-svc/usertransactionscount?user_id=user1

/GET

Using Status
http://permits.himaintenance.io/audit-svc/statustransactionscount?status=SUCCESS

/GET

Using Date Range
http://permits.himaintenance.io/audit-svc/transactionscountbyrequesttime?fromDate=2021-05-04&toDate=2021-05-05
Following are unique parameters that can be used
Query Param Value
tenant_id tenant4
user_id user1
status SUCCESS
fromDate 2021-05-04
toDate 2021-05-05
Response Body with status code
200
{"count":28}

/GET

Verifying the service is up
https://permits.himaintenance.io/search-svc/ping
"success"
©2021 by MessyData Inc. All Rights Reserved.