Cloning a Code Sample

After you explore our API reference and code samples, you can clone one of our code samples to get you started. Our documentation contains a code sample for each resource in four different languages. Whatever language that you are using, you can use our Python code sample below as a model and tweak the parameters to get your desired request.

In the following code sample, we create a code sample for the HoldingsIQ service. We retrieve vendor details from EPKB for a specific vendor ID using the sandbox environment. The process of creating the code sample for the resource is described below. For this particular example, we used windows and installed Python 3.6.0 prior to creating the sample.


If you need to look up the URL or parameters for a resource, refer back to the API reference.

Steps to Create a Code Sample

To Create a Code Sample:

  1. Note the request URL for your desired resource.

  2. Determine the parameters that you would like to use for your request.

    vendorid = {Desired vendor id}
    custid = {EBSCO provided customer id}
    x-api-key = {EBSCO provided API key}
  3. Create a new file for your sample code.

  4. Add the following code to The code below defines your parameters, forms the request URL, forms the request headers, sends the request and gets the response back.

    # File:
    # HTTP Library
    import http.client
    # Parameters
    DUMMYCUSTID = {EBSCO provided customer ID}
    DUMMYVENDORID = {your desired vendor ID}
    DUMMYAPIKEY = {EBSCO provided API key}
    # Form the URL
    url = ''.join(['/rm','/rmaccounts/', DUMMYCUSTID, '/vendors/', DUMMYVENDORID])
    # Create Connection Instance
    conn = http.client.HTTPSConnection("")
    # Create the Request Headers
    headers = {
        'accept': "application/json",
        'x-api-key': DUMMYAPIKEY
    # Send Request 
    conn.request("GET", url, headers=headers)
    # Get Response
    res = conn.getresponse()
    data =
  5. Change {EBSCO provided customer ID}, {your desired vendor ID} and {EBSCO provided API key} in the script to the parameters that you gathered in Step 2.


If you would like to use a different resource, you will need to form the URL in the code to match the resource. Also, you will need to take into account the parameters for the new resource. Refer to our code samples in our service reference for additional guidance.

  1. Save your file.

  2. Run your script by entering python in a Command Prompt. If successful, a JSON response with the requested vendor details will be returned and displayed on the screen.

      "isCustomer": false,
      "packagesSelected": 60,
      "packagesTotal": 645,
      "vendorId": 19,
      "vendorName": "EBSCO",
      "proxy": {
        "id": "",
        "inherited": false
      "vendorToken": null

You have completed your first code sample consuming HoldingsIQ. You are on your way. Have fun!