Pricing API
===========

The pricing API is a read only method for retrieving current pricing information for an eligible ISBN.  It is accessed
by performing a GET request to /v1/book/isbn/<ISBN>/pricing/ with your authentication information.

Example Request
---------------

| GET /v1/book/isbn/9780874202120/pricing/
|
| **Headers**
| Authorization: SharedKey
| Api-User: <username>
| Api-Key: <key>
|


Success response
----------------

The endpoint will return a 200 response on success with pricing options separated into three categories.

    - Standard Pricing (standard)
    - Sale Pricing (sale)
    - Institutional Pricing (inst)

Example response::

    {
        'digital_pricing':
            {
                'inst': [],
                'sale': [],
                'standard': [
                    {
                        'id': 6933,
                        'price': '23.33',
                        'currency': 'USD',
                        'description': 'Buy eBook (lifetime)',
                        'description_limit': 'lifetime',
                        'deactivation_date': None,
                        'limit_days': 0,
                        'is_limited': False
                    }
                ]
            },
        'test_mode': False,
        'success': True,
        'code': 200
    }


.. seealso::

    See `Pricing object structure <data/pricing.html>`_ for information on the fields in a digital pricing object.

Error response
--------------

The endpoint will return a 404 response if the ISBN is not available and may return a 403 response if authentication fails.


Next Steps
----------

If you're using ShareASale use their URL format to create the sale.  Otherwise you can use the cart API to make a sale.