Book Object¶

hash_id <string>:
```
The primary identifier for a book.
```

id <integer>:

Secondary integer identifier for a book.

title <string>:
```
Primary title for the book.
```
subtitle <string>:
```
Subtitle for the book.
```

author <string>:

Author or sequence of contributors for the book.

description <string>:
```
Text description of the book.
```
language <string>:
```
Language the book is published in.
```
publish_year <integer>:
```
Year the book was published.
```
num_pages <integer>:
```
Number of pages in the book.
```

sample_url <string>:

Link to book sample if allowed by publisher

Child Objects¶

Example Complete Book Object¶

Example book with each pricing option type:

{
  'code': 200,
  'success': True,
  'test_mode': False,
  'book': {
    'id': 876,
    'hash_id': 'ccc5a093f5ee30ec749e4909840f0f7b794066bb',
    'title': 'Test Combo Book',
    'subtitle': 'This is a subtitle',
    'description': 'This is a book description.',
    'author': 'Author name or sequence of names',
    'language': 'English',
    'num_pages': 0,
    'publish_year': None,
    'sample_url': '/book/sample/876/',
    'identifiers': {
        'eisbn10': '1234567890',
        'eisbn13': '1234567890123',
        'hash_id': 'ccc5a093f5ee30ec749e4909840f0f7b794066bb',
        'id': 876,
        'isbn10': '',
        'isbn13': '',
        'parent_isbn': '',
        'sku': ''
    },
    'drm': {
        'copy_percent': None,
        'offline_percent': None,
        'offline_range': '',
        'print_allowance_percent': 0.250,
        'print_allowance_range': '',
        'sample_page_end': 0,
        'sample_percent': None
    },
    'files': {
        'cover_image': {
            'filename': 'default_book_cover.jpg',
            'url': 'http://www.redshelf.com/site_media/media/cover_image/default_book_cover.jpg'
        },
        'thumbnail': None
    },
    'digital_pricing': [
        {
           'calculated_expiration_date': '2014-05-29',
           'currency': 'USD',
           'days_until_expiration': '78',
           'deactivation_date': '2014-05-29T05:00:00Z',
           'description': 'Rent eBook (until 2014-05-29)',
           'description_limit': '2014-05-29 05:00:00+00:00',
           'id': 932,
           'is_limited': True,
           'limit_days': 0,
           'other_pricing': 'EXPIRATION',
           'price': '2.99'
        },
        {
           'calculated_expiration_date': '2014-04-12',
           'currency': 'USD',
           'days_until_expiration': '31',
           'deactivation_date': None,
           'description': 'Rent eBook (30 days)',
           'description_limit': '30 days',
           'id': 927,
           'is_limited': True,
           'limit_days': 30,
           'other_pricing': 'LIMITED',
           'price': '5.99'
        },
        {
           'currency': 'USD',
           'deactivation_date': None,
           'description': 'Buy eBook (lifetime)',
           'description_limit': 'lifetime',
           'id': 908,
           'is_limited': False,
           'limit_days': 0,
           'other_pricing': None,
           'price': '20.00'
        }
    ],
    'publisher': {
        'title': 'Some Publisher Title',
        'description': 'Publisher Description',
        'is_active': True
    },
    'status': {
        'is_active': True,
        'is_html': True,
        'is_processed': True,
        'is_public': True,
        'is_published': True,
        'is_queued': True,
        'processed_date': '2014-03-12T16:00:22Z',
        'queued_date': '2014-03-12T16:06:01Z'
    },
    'country_restrictions': [
        {
            'rule': 'ALLOW',
            'code': 'US',
            'name': 'United States'
        },
        {
            'rule': 'DENY',
            'code': 'CA',
            'name': 'Canada'
        },
    ],
    'territory_restrictions': [
        {
            'rule': 'ALLOW',
            'code': 'US-IL',
            'name': 'Illinois'
        },
        {
            'rule': 'DENY',
            'code': 'US-MO',
            'name': 'Missouri'
        }
    ]
  }
}

Note: Additional (or less) data may be returned for each data point depending on your account permissions.