This is the python wrapper for the lob.com API.
This wrapper works in the object oriented style, that is, to make calls you have to call the method on a class and the
return types are python objects. To get a dict on any object, you can call the to_dict() method of the object.
You can use pip or easy_install for installing the package.
pip install lob
easy_install lob
Install all requirements with pip install -r requirements.txt.
You can run all tests with the command nosetests in the main directory.
To initialize the wrapper, import lob and set the api_key
import lob
lob.api_key = 'your-api-key'Addresses work with the Address class and the objects returned are of this class.
address = lob.Address.create(name='Joe Smith', address_line1='104, Printing Boulevard',
address_city='Boston', address_state='MA', address_country='US',
address_zip='12345')
print address.to_dict()You can pass optional parameters as well while creating an address
print lob.Address.create(name='Joe Smith', address_line1='104, Printing Boulevard',
address_line2='Sunset Town', email='sidchilling@gmail.com',
address_city='Boston', address_state='MA', address_country='US',
address_zip='12345').to_dict()Will return a list of Address objects
lob.Address.list()You can also pass count and offset parameters (or either one of them)
lob.Address.list(count=5, offset=2)Returns an Address object
# You can query an address with its `ID`
print lob.Address.get(id='adr_d46c8c8b67f826d5').to_dict()
# or another way
print lob.Address.get(id=lob.Address.list(count=1)[0].id).to_dict()You can delete an address with its ID
lob.Address.delete(id='adr_d46c8c8b67f826d5')You can verify an Address - this API will call return a LobObject which is
the super-class of all other classes. You can of course do a to_dict() and
get the dict representation of a LobObject as well.
verify = lob.AddressVerify.verify(name='Joe Smith', email='sidchilling@gmail.com',
address_line1='220 William T Morrissey', address_city='Boston',
address_state='MA', address_zip='02125', address_country='US')
print verify.to_dict()Works on the Setting class.
This will return a list of Setting objects.
print lob.Setting.list()print lob.Setting.get(id='<setting-id>').to_dict()
print lob.Setting.get(id=lob.Setting.list()[0].id).to_dict()Works on the Service class.
Returns a list of Service objects
print lob.Service.list()Works on the Packaging class.
Returns a list of Packaging objects
print lob.Packaging.list()Works on the Object class.
lob.Object.list() # Returns a list of Object objects
lob.Object.list(count=4, offset=2) # Can specify count and offset
lob.Object.delete(id='obj_145e602887e61dfd') # Delete an object via it's ID
lob.Object.create(name='Joe Smith', file='https://www.lob.com/goblue.pdf',
setting_id='100', quantity=1) # Will create an object and return its instance
lob.Object.create(name='Local File Object', file=open('/path/to/local/file', 'rb'),
setting_id='100', quantity=1) # Will create an object with a local file and return its instanceWorks on the Job class.
lob.Job.list() # Returns a list of Job objects
lob.Job.list(count=5, offset=1) # Can specify count and offset as well
lob.Job.list(count=5) # Can specify either offset or count as well
lob.Job.get(id='job_52c74737ab41484090df') # Can find a Job based on its ID - Returns a Job instanceWill return a Job instance if creation is successful
print lob.Job.create(name='Joe First Job', to='adr_fa1b063697e25611',
objects=lob.Object.list()[0].id,
from_address=lob.Address.list(count=1, offset=5)[0].id).to_dict()As in the above call, you can see to and from_address are Address IDs and objects is a Object ID. You can specify these differently as well - passsing complete address parameters. Also, objects can be a list specifiying multiple object IDs or object parameters as well. The following code block will show each of these possibilities.
obj = [{'name' : 'My Resume Job Object',
'file' : 'https://www.lob.com/goblue.pdf',
'setting_id' : '101',
'quantity' : 1}] # The objects list can contain both object id as well as parameters
from_address = {'name' : 'Joe Smith',
'address_line1' : '220 William T Morrissey',
'address_line2' : 'Sunset Town',
'address_city' : 'Boston',
'address_state' : 'MA',
'address_country' : 'US',
'address_zip' : '02125'}
print lob.Job.create(name='Joe Second Job', to='adr_fa1b063697e25611',
objects=obj, from_address='adr_fa1b063697e25611',
packaging_id='7').to_dict()The above code block also shows optional parameters that can be passed
You can also pass a local file object when creating a job.
local_obj = [{'name' : 'My Local File Object',
'file' : '/path/to/local/file',
'setting_id' : '100',
'quantity' : 1}]
from_address = {'name' : 'Joe Smith',
'address_line1' : '220 William T Morrissey',
'address_line2' : 'Sunset Town',
'address_city' : 'Boston',
'address_state' : 'MA',
'address_country' : 'US',
'address_zip' : '02125'}
print lob.Job.create(name='Joe Local File Job', to='adr_fa1b063697e25611',
objects=local_obj, from_address='adr_fa1b063697e25611',
packaging_id='7').to_dict()Works on the Postcard class.
lob.Postcard.list() # Returns a list of Postcard objects
lob.Postcard.list(count=5, offset=3) # Can also pass count and offsetYou must either specify the message argument or the back argument (but not both). Both to and from_address addresses can contain Address ID or Address parameters (as in creation of Job).
# Specifying message
print lob.Postcard.create(name='Siddharth Test Postcard', to=lob.Address.list(count=1)[0].id,
message='This is a standard test message',
front='https://www.lob.com/postcardfront.pdf',
from_address=from_address)
# Specifying back and address as parameters (using from_address defined earlier in Job creation)
print lob.Postcard.create(name='Siddharth New Test Postcard', to=lob.Address.list(count=1)[0].id,
front='https://www.lob.com/postcardfront.pdf',
back='https://www.lob.com/postcardback.pdf', from_address=from_address)
# create a postcard using a local file
lob.Postcard.create(name='MY Test Postcard', to={'name' : 'Bon Jovi',
'address_line1' : '220 William T Morrissey',
'address_line2' : 'Sunset Town',
'address_city' : 'Boston',
'address_state' : 'MA',
'address_country' : 'US',
'address_zip' : '02125'},
message='This is a standard test message',
front=open('test.pdf','rb'),
from_address={'name' : 'Michelle Obama',
'address_line1' : '220 William T Morrissey',
'address_line2' : 'Sunset Town',
'address_city' : 'Boston',
'address_state' : 'MA',
'address_country' : 'US',
'address_zip' : '02125'}).to_dict()Works on the BankAccount class.
lob.BankAccount.list() # Returns a list of BankAccount objects
lob.BankAccount.list(count=5, offset=3) # Can also pass count and offset
lob.BankAccount.get(id='<bank-account-id>') # Can find a bank account based on its ID - Returns a BankAccount instance.print lob.BankAccount.create(
routing_number='122100024',
account_number='123456789',
bank_address=lob.Address.list(count=1, offset=4)[0].id,
account_address=lob.Address.list(count=1)[0].id,
bank_code=None).to_dict()routing_number (required): The bank's routing number
account_number (required): The account number at the bank
bank_address (required): The bank branch address. Must either be an address ID or an array with correct address parameters. If an array is used, an address will be created for you and returned with an ID.
account_address (required): The address associated with your account. Must either be an address ID or an array with correct address parameters. If an array is used, an address will be created for you and returned with an ID.
bank_code (optional): The bank code that is printed on your checks. Added for extra security. You can usually find this near the bank address on the check.
Works on the Check class.
lob.Check.list() # Returns a list of Check objects
lob.Check.list(count=5, offset=3) # Can also pass count and offset
lob.Check.get(id='<check-id>') # Can find a check based on its ID - Returns a Check instance.to_address = {
'name': 'Ralph Receiver',
'address_line1': '1234 E Grant St',
'address_line2': None,
'address_city': 'Tucson',
'address_state': 'AZ',
'address_country': 'US',
'address_zip': '85712'
}
print lob.Check.create(
bank_account=lob.BankAccount.list(count=1)[0].id,
to=to_address,
amount=1000.00,
name='Demo Check',
check_number=None,
message='Hi Ralph. Thanks for your work. - Paul',
memo='Services rendered.'
).to_dict()name (optional): Description name for the check. E.g. 'Demo Check'
check_number (optional): Checks will default starting at 10000 and increment accordingly.
bank_account (required): Must be a bank account ID.
to (required): Must either be an address ID or an array with correct address parameters. If an array is used, an address will be created for you and returned with an ID.
amount (required): The payment amount to be sent.
message (optional): Max of 400 characters to be included on the top of the check.
memo (optional): Max of 40 characters to be included on the memo line of the check.