Enzoic API - Developer Documentation
Visit our website
  • Enzoic Website
  • Getting Started
    • .NET Quick Start
    • Java Quick Start
    • JavaScript Quick Start
    • Ruby Quick Start
    • PHP Quick Start
    • Go Quick Start
    • Python Quick Start
  • Using the Enzoic API
  • Libraries
  • API reference
    • Passwords API
    • Credentials API
      • Hashed Credentials API
      • Cleartext Credentials API
        • Query Passwords for an Email Address
        • Query Passwords for a Domain
        • Query Passwords for a Partial Hash of an Email Address
      • Test Accounts
    • Exposures API
      • Get Exposures for an Email Address
      • Get Exposures for a Domain
      • Get Exposures for All Email Addresses in a Domain
      • Get Exposures by Date
      • Retrieve Details for an Exposure
    • Breach Monitoring API
      • Breach Monitoring by User
        • Add Breach Alert Subscriptions for Users
        • Remove Breach Alert Subscriptions for Users
        • Query Breach Alert Subscriptions for Users
      • Breach Monitoring by Domain
        • Add Breach Alert Subscriptions for Domains
        • Remove Breach Alert Subscriptions for Domains
        • Query Breach Alert Subscriptions for Domains
      • Webhooks
        • Managing Webhooks
          • Register a Webhook
          • Update a Webhook
          • Delete a Webhook
          • Query Registered Webhooks
        • Webhook Test API
    • Identity Breach Monitoring API
      • Monitoring Identities
        • Add Identities to Monitoring
        • Update Monitored Identities
        • Remove an Identity from Monitoring
        • Query Monitored Identities
      • Retrieving Identity Exposures
      • Webhooks
        • Managing Webhooks
          • Register a Webhook
          • Update a Webhook
          • Delete a Webhook
          • Query Registered Webhooks
        • Webhook Test API
    • BIN Monitoring API
      • Monitoring BINs
        • Add Bank Identification Numbers to Monitoring
        • Remove Bank Identification Numbers from Monitoring
        • Query Monitored Bank Identification Numbers
      • Retrieving Exposed Payment Cards
      • Webhooks
        • Managing Webhooks
          • Register a Webhook
          • Update a Webhook
          • Delete a Webhook
          • Query Registered Webhooks
        • Webhook Test API
    • Payment Card Exposures API
      • Check a Card Number for Compromise
    • Account Status APIs
      • Account Status
      • Account Usage
    • Password Hash Algorithms
    • OpenAPI Specification
    • View OpenAPI Spec in Swagger UI
    • Postman Collection of API Examples
  • Password Strength Meter
    • Quick Start
    • Example
Powered by GitBook
On this page
  • API Authentication
  • API Responses
  • Firewall IP Whitelist
  • Proxy

Was this helpful?

Using the Enzoic API

PreviousPython Quick StartNextLibraries

Last updated 1 year ago

Was this helpful?

The Enzoic APIs are implemented as a series of RESTful web services with JSON payloads. All APIs must be accessed via HTTPS and require You can request a key.

As is standard for REST APIs, API call parameters for GET requests are submitted in the query string for GET requests. For POST requests, parameters are submitted in the body as a JSON payload. The Content-Type header should always be set to application/json.

The API endpoint is:

https://api.enzoic.com/v1/{service}

API Authentication

All API endpoints require an HTTP basic authentication header. Your API Key is the username and your API Secret is the password portion of the header. The authentication header value is constructed in the standard fashion:

authorization: basic Base64Encode({Your API Key}:{Your Secret})

So, for example, if your API Key is b38f5a609f01442fb8ceb1aa02474903 and your Secret is 8e8a185dfa3e437f85afba165ce407b4, the resultant authentication header would be

authorization: basic YjM4ZjVhNjA5ZjAxNDQyZmI4Y2ViMWFhMDI0NzQ5MDM6OGU4YTE4NWRmYTNlNDM3Zjg1YWZiYTE2NWNlNDA3YjQ=

API Responses

Enzoic uses HTTP status codes to indicate success/failure conditions for API calls. Below is a listing of the response codes used for all Enzoic API calls along with their meaning.

Response
Description

200

Success. Body will contain appropriate response.

400

Required parameters were either missing or invalid.

401

Authentication header either missing or API key/Secret were not valid. Check the response body for more information.

403

Either the rate limit or monthly quota have been exceeded. Check the response body for more information.

404

For GET calls, indicates the requested entity was not found.

500

Unexpected error. Check the response body for more information.

Individual API calls may have additional response codes listed in the documentation for that call.

Firewall IP Whitelist

If your firewall requires explicit rules for outbound traffic on port 443, please whitelist the following IP addresses:

IP

13.235.194.196 13.48.121.56 13.48.96.148 15.206.40.21 18.196.181.48 3.10.99.236 3.124.25.136 3.231.37.171 3.24.50.155 3.24.93.121 3.9.236.117 34.214.110.33 35.153.27.185 35.163.59.86 35.168.85.109 35.180.249.238 35.181.124.196 52.192.30.99 52.199.52.28 52.212.218.163 52.48.142.122 52.51.10.65 52.79.68.108 52.89.197.157 54.172.238.226 54.180.42.79 54.233.211.111 54.233.236.93 75.2.9.104 99.83.177.145

Proxy

There isn’t a facility for specifically setting an HTTP proxy in our Client Libraries, but this can be done via command line parameters. For example :

https://docs.oracle.com/javase/6/docs/technotes/guides/net/proxies.html
trial API
authentication.