@lap v0.3
# Machine-readable API spec. Each @endpoint block is one API call.
@api Taxrates.io API
@base https://api.taxrates.io/api
@auth ApiKey Authorization in header
@endpoints 3
@toc tax(3)

@endpoint GET /v3/tax/rates
@desc Get request
@optional {domain: str # Domain name: api.taxrates.io, filter: str # You can filter your taxes by one of following types: 'standard', 'CombinedRate', 'CountyRate', 'CityRate', 'SPDRate' and 'MTARate'., cursor: str # Cursor shows from which record you want to get information. Default value is 0, next value can be retrieved from X-Cursor-Next header., Product_code: str}
@returns(500) {code: str, message: str, fields: str}

@endpoint GET /v1/tax/ip
@desc Get request
@optional {domain: str # Domain name: api.taxrates.io, ip: str # Customer's IP address, filter: str # For US sales tax you can filter the tax type, zip: str # For US sales tax a Zipcode must be proivded, product_code: str # Your can filter your taxes by product code}

@endpoint GET /v1/tax/countrycode
@desc Get request
@optional {domain: str # Domain name: api.taxrates.io, country_code: str # Country code alpha 2, filter: str # You can filter your taxes by one of following types: 'standard', 'reduced', 'second reduced', 'third reduced' and 'super reduced'., zip: str # You must provide a zip code if one of your selected countries is United States and you've had selected a state on your Taxrates.io member's dashboard., product_codes[]: str # Use one or many product code/s., province : str # Use for Canada, date: str}
@returns(200) {country_name: str, taxes: [map]}

@end
