API Documentation

Welcome to the RxUtility API documentation! This API has been designed to provide developers easy access to a wide range of medication coupons, helping users save money on their prescriptions. By integrating our API, you can offer your users real-time, updated discounts on the medicines they need.

Base Url: https://gateway.rxutility.com/api
Support: key@rxutility.com

To apply for an API key, fill out the contact form.

Once you have an API key, you can utilize the "Try it out" feature in the API Specs section.

To fill out a support request, visit the support page.

How to Use

• 1. Obtain Your API Key

  To use the RxUtility API, you need an API key. You can request an API key by filling out the contact form.

• 2. Base URL

  API requests use the following base URL: https://gateway.rxutility.com/api. Any API endpoints will be subpaths from that base URL.

• 3. Authentication

  Present your API key to the gateway using an "Authorization: Bearer " header.

• 4. Making Requests

  The API is organized in a "RESTful" like pattern. For example, to get the coupons available by the medication's brand name you may use the endpoint /coupons/{brand_name} and to access coupons by NDC you may use the endpoint /coupons/ndc/{ndc}.
  
  Check the API Specs section for more capabilities and endpoints available.

• 5. Handling Responses

  The API endpoints will return a HTTP 200, 401, or 500 response code.
  A 200 indicates a valid request/response, 401 indicates an invalid or missing gateway credential, and 500 indicates a server issue.
  Every API endpoint returns a response in JSON format. The resulting JSON format will differ per API endpoint and is documented in the below API Specs.

Example

Here is an example of how to make a request that will get co-pay coupons for abilify using Python:

import requests

def get_coupon_details(api_key, drug_name):
  url = f'https://gateway.rxutility.com/api/coupons/{drug_name}'
  
  headers = {
      'Authorization': f'Bearer {api_key}'
  }
  
  response = requests.get(url, headers=headers)
  if response.status_code == 200:
      return response.json()
  else:
      return {'error': response.status_code, 'message': response.json()}

# Example usage
api_key = 'PUT YOUR API KEY HERE'
drug_name = 'abilify'
coupon_details = get_coupon_details(api_key, drug_name)

if 'error' in coupon_details:
  print('Error:', coupon_details['error'], coupon_details['message'])
else:
  print('Coupon details:', coupon_details)

API Specs