BigCommerce
Management API
Order Taxes

Orders V2

Get All Order Taxes

GET /orders/{order_id}/taxes

Request

Gets all order taxes using order_id. Each tax applied to an order. This information can be useful for reporting purposes. Pass in the query parameter ?details=true to return extra details about order taxes. order_product_id and line_item_type are also returned.

All values are read-only.

Authentication

  • X-Auth-Token in header - required

Parameters

  • store_hash in path - string
  • page in query - number

    The page to return in the response.

  • limit in query - number

    Number of results to return.

  • details in query with default of true - string

    To return detailed tax information, pass in the details query.

example

Response

Body

array | application/json
  • id
    integer

    The unique numeric identifier of the taxes object.

    Example: 1

  • order_id
    integer

    The unique numeric identifier of the order to which the tax was applied. NOTE: Not included if the store was using the automatic tax feature.

    Example: 129

  • order_address_id
    integer

    The unique numeric identifier of the order address object associated with the order. NOTE: Not included if the store was using the automatic tax feature.

    Example: 29

  • tax_rate_id
    integer

    The unique numeric identifier of the tax rate.

    Example: 1

  • tax_class_id
    integer

    The unique numeric identifier of the tax class object. NOTE: Will be 0 if automatic tax was enabled, or if the default tax class was used.

    Example: 0

  • name
    string

    The name of the tax class object.

    Example: State Tax

  • class
    string

    The name of the type of tax that was applied. NOTE: It will be "Automatic Tax" if automatic tax was enabled. It will be "API Tax Override" if the order was created with V2 Orders API.

    Example: Gift Wrapping

  • rate
    string

    The tax rate. The priority order in which the tax is applied (Float, Float-As-String, Integer)

    Example: 8.0000

  • priority
    number

    The order in which the tax is applied.

    Example: 0

  • priority_amount
    string

    The amount of tax calculated on the order. (Float, Float-As-String, Integer)

    Example: 1.5200

  • line_amount
    string

    (Float, Float-As-String, Integer)

    Example: 1.5200

  • order_product_id
    string

    If the line_item_type is item or handling then this field will be the order product id. Otherwise the field will return as null.

  • line_item_type
    string

    Type of tax on item.

    Allowed: item | shipping | handling | gift-wrapping

response

Did you find what you were looking for?