Read Payouts

If you're looking to integrate payout information with your existing eCommerce, inventory, or financial system, you can pull down payouts from the Reverb API and make equivalent entries for bookkeeping in your application.

Fetching Payouts periodically

Your app pulls payouts from Reverb on a timer. You can set up a cron job to do this nightly, or run a manual script to do so.

First, we'll fetch the payouts for a given date range. Note that the dates are in ISO8601 format.

curl -XGET 
-H "Content-Type: application/hal+json" 
-H "Accept: application/hal+json" 
-H "Accept-Version: 3.0" 
-H "Authorization: Bearer [personal_token]"
https://api.reverb.com/api/my/payouts?created_start_date=2017-10-15T12:00-00:00&created_end_date=2017-10-30T12:00-00:00&per_page=5

The response will contain a list of payout objects, which represent a group of transactions that was sent to your bank account. You will have one payout each time we send money to your bank account.

*Please note, each payout item can contain one or multiple orders.

{
    "total": 8,
    "current_page": 1,
    "per_page": 5,
    "total_pages": 2,
    "_links": {
        "next": {
            "href": "https://api.reverb.com/api/my/payouts?created_end_date=2017-10-30T12%3A00-00%3A00&created_start_date=2017-10-15T12%3A00-00%3A00&page=2&per_page=5"
        }
    },
    "payouts": [
        {
            "total": {
                "amount": "11.88",
                "amount_cents": 1188,
                "currency": "USD",
                "symbol": "$",
                "display": "$11.88"
            },
            "created_at": "2017-10-27T11:56:08-05:00",
            "updated_at": "2017-10-30T10:46:59-05:00",
            "_links": {
                "line_items": {
                    "href": "https://api.reverb.com/api/my/payouts/54/line_items"
                }
            }
        },
        {
            "total": {
                "amount": "57.07",
                "amount_cents": 5707,
                "currency": "USD",
                "symbol": "$",
                "display": "$57.07"
            },
            "created_at": "2017-10-26T11:39:23-05:00",
            "updated_at": "2017-10-30T10:46:59-05:00",
            "_links": {
                "line_items": {
                    "href": "https://api.reverb.com/api/my/payouts/52/line_items"
                }
            }
        },
        {
            "total": {
                "amount": "193.40",
                "amount_cents": 19340,
                "currency": "USD",
                "symbol": "$",
                "display": "$193.40"
            },
            "created_at": "2017-10-25T11:51:13-05:00",
            "updated_at": "2017-10-30T10:46:59-05:00",
            "_links": {
                "line_items": {
                    "href": "https://api.reverb.com/api/my/payouts/51/line_items"
                }
            }
        },
        {
            "total": {
                "amount": "602.86",
                "amount_cents": 60286,
                "currency": "USD",
                "symbol": "$",
                "display": "$602.86"
            },
            "created_at": "2017-10-24T11:57:20-05:00",
            "updated_at": "2017-10-30T10:46:59-05:00",
            "_links": {
                "line_items": {
                    "href": "https://api.reverb.com/api/my/payouts/48/line_items"
                }
            }
        },
        {
            "total": {
                "amount": "324.96",
                "amount_cents": 32496,
                "currency": "USD",
                "symbol": "$",
                "display": "$324.96"
            },
            "created_at": "2017-10-20T11:03:55-05:00",
            "updated_at": "2017-10-30T10:46:59-05:00",
            "_links": {
                "line_items": {
                    "href": "https://api.reverb.com/api/my/payouts/47/line_items"
                }
            }
        }
    ]
}

By themselves, payouts do not give you much. To peek into each line item for the payout, follow the line_items links.

Payout Line Items

How to get information within a Payout using the line_items links:

curl -XGET 
-H "Content-Type: application/hal+json" 
-H "Accept: application/hal+json" 
-H "Accept-Version: 3.0" 
-H "Authorization: Bearer [personal_token]"
https://api.reverb.com/api/my/payouts/54/line_items?per_page=5

The response will contain a list of payout line item objects, each of which will represent an order within that payout.

{
    "total": 7,
    "current_page": 1,
    "per_page": 5,
    "total_pages": 2,
    "_links": {
        "next": {
            "href": "https://api.reverb.com/api/my/payouts/54/line_items?page=2&per_page=5"
        }
    },
    "payout_line_items": [
        {
            "order_id": 4945,
            "payout_currency": "USD",
            "sale_date": "2017-10-27T15:20:24-05:00",
            "sale_price": {
                "amount": "15.83",
                "amount_cents": 1583,
                "currency": "USD",
                "symbol": "$",
                "display": "$15.83"
            },
            "sale_currency": "USD",
            "processing_fee": {
                "amount": "0.68",
                "amount_cents": 68,
                "currency": "USD",
                "symbol": "$",
                "display": "$0.68"
            },
            "selling_fee": {
                "amount": "0.50",
                "amount_cents": 50,
                "currency": "USD",
                "symbol": "$",
                "display": "$0.50"
            },
            "affirm_promotion_fee": {
                "amount": "0.00",
                "amount_cents": 0,
                "currency": "USD",
                "symbol": "$",
                "display": "FREE"
            },
            "bump_fee": {
                "amount": "0.00",
                "amount_cents": 0,
                "currency": "USD",
                "symbol": "$",
                "display": "FREE"
            },
            "shipping_label_fee": {
                "amount": "0.00",
                "amount_cents": 0,
                "currency": "USD",
                "symbol": "$",
                "display": "FREE"
            },
            "applied_bucks": {
                "amount": "0.00",
                "amount_cents": 0,
                "currency": "USD",
                "symbol": "$",
                "display": "FREE"
            },
            "subtotal": {
                "amount": "14.65",
                "amount_cents": 1465,
                "currency": "USD",
                "symbol": "$",
                "display": "$14.65"
            },
            "payout_currency_exchange_fee": {
                "amount": "0.00",
                "amount_cents": 0,
                "currency": "USD",
                "symbol": "$",
                "display": "FREE"
            },
            "reverb_remitted_tax": {
                "amount": "0.00",
                "amount_cents": 0,
                "currency": "USD",
                "symbol": "$",
                "display": "FREE"
            },
            "total": {
                "amount": "14.65",
                "amount_cents": 1465,
                "currency": "USD",
                "symbol": "$",
                "display": "$14.65"
            },
            "total_payout": {
                "amount": "14.65",
                "amount_cents": 1465,
                "currency": "USD",
                "symbol": "$",
                "display": "$14.65"
            },
            "description": "Mi-T-Mist Mouthpiece Cleaner Economy Size"
            "state": "paid_to_shop",
            "tax_on_fees": {                  # This property is only applicable to select users. More information for qualifying sellers: https://help.reverb.com/hc/en-us/articles/15478400563603 
                "amount": "0.00",
                "amount_cents": 0,
                "currency": "USD",
                "symbol": "$",
                "display": "$0.00"
        },
        {
            "order_id": 4944,
            "payout_currency": "USD",
            "sale_date": "2017-10-27T15:20:24-05:00",
            "sale_price": {
                "amount": "16.24",
                "amount_cents": 1624,
                "currency": "USD",
                "symbol": "$",
                "display": "$16.24"
            },
            "sale_currency": "USD",
            "processing_fee": {
                "amount": "0.69",
                "amount_cents": 69,
                "currency": "USD",
                "symbol": "$",
                "display": "$0.69"
            },
            "selling_fee": {
                "amount": "0.50",
                "amount_cents": 50,
                "currency": "USD",
                "symbol": "$",
                "display": "$0.50"
            },
            "affirm_promotion_fee": {
                "amount": "0.00",
                "amount_cents": 0,
                "currency": "USD",
                "symbol": "$",
                "display": "FREE"
            },
            "bump_fee": {
                "amount": "0.00",
                "amount_cents": 0,
                "currency": "USD",
                "symbol": "$",
                "display": "FREE"
            },
            "shipping_label_fee": {
                "amount": "0.00",
                "amount_cents": 0,
                "currency": "USD",
                "symbol": "$",
                "display": "FREE"
            },
            "applied_bucks": {
                "amount": "0.00",
                "amount_cents": 0,
                "currency": "USD",
                "symbol": "$",
                "display": "FREE"
            },
            "subtotal": {
                "amount": "15.05",
                "amount_cents": 1505,
                "currency": "USD",
                "symbol": "$",
                "display": "$15.05"
            },
            "payout_currency_exchange_fee": {
                "amount": "0.00",
                "amount_cents": 0,
                "currency": "USD",
                "symbol": "$",
                "display": "FREE"
            },
            "reverb_remitted_tax": {
                "amount": "0.00",
                "amount_cents": 0,
                "currency": "USD",
                "symbol": "$",
                "display": "FREE"
            },
            "total": {
                "amount": "15.05",
                "amount_cents": 1505,
                "currency": "USD",
                "symbol": "$",
                "display": "$15.05"
            },
            "total_payout": {
                "amount": "15.05",
                "amount_cents": 1505,
                "currency": "USD",
                "symbol": "$",
                "display": "$15.05"
            },
            "description": "EXP11 Coated 80/20 Bronze Light Acoustic Guitar Strings Level 1"
            "state": "paid_to_shop",
            "tax_on_fees": {
                "amount": "0.00",
                "amount_cents": 0,
                "currency": "GBP",
                "symbol": "£",
                "display": "£0.00"
        },
        {
            "order_id": 4943,
            "payout_currency": "USD",
            "sale_date": "2017-10-27T13:51:57-05:00",
            "sale_price": {
                "amount": "16.46",
                "amount_cents": 1646,
                "currency": "USD",
                "symbol": "$",
                "display": "$16.46"
            },
            "sale_currency": "USD",
            "processing_fee": {
                "amount": "0.69",
                "amount_cents": 69,
                "currency": "USD",
                "symbol": "$",
                "display": "$0.69"
            },
            "selling_fee": {
                "amount": "0.50",
                "amount_cents": 50,
                "currency": "USD",
                "symbol": "$",
                "display": "$0.50"
            },
            "affirm_promotion_fee": {
                "amount": "0.00",
                "amount_cents": 0,
                "currency": "USD",
                "symbol": "$",
                "display": "FREE"
            },
            "bump_fee": {
                "amount": "0.00",
                "amount_cents": 0,
                "currency": "USD",
                "symbol": "$",
                "display": "FREE"
            },
            "shipping_label_fee": {
                "amount": "0.00",
                "amount_cents": 0,
                "currency": "USD",
                "symbol": "$",
                "display": "FREE"
            },
            "applied_bucks": {
                "amount": "0.00",
                "amount_cents": 0,
                "currency": "USD",
                "symbol": "$",
                "display": "FREE"
            },
            "subtotal": {
                "amount": "15.27",
                "amount_cents": 1527,
                "currency": "USD",
                "symbol": "$",
                "display": "$15.27"
            },
            "payout_currency_exchange_fee": {
                "amount": "0.00",
                "amount_cents": 0,
                "currency": "USD",
                "symbol": "$",
                "display": "FREE"
            },
            "reverb_remitted_tax": {
                "amount": "0.00",
                "amount_cents": 0,
                "currency": "USD",
                "symbol": "$",
                "display": "FREE"
            },
            "total": {
                "amount": "15.27",
                "amount_cents": 1527,
                "currency": "USD",
                "symbol": "$",
                "display": "$15.27"
            },
            "total_payout": {
                "amount": "15.27",
                "amount_cents": 1527,
                "currency": "USD",
                "symbol": "$",
                "display": "$15.27"
            },
            "description": "EXP11 Coated 80/20 Bronze Light Acoustic Guitar Strings Level 1"
       			"state": "paid_to_shop",
            "tax_on_fees": {
                "amount": "0.00",
                "amount_cents": 0,
                "currency": "USD",
                "symbol": "$",
                "display": "$0.00"
        },
        {
            "order_id": 4935,
            "payout_currency": "USD",
            "sale_date": "2017-10-27T11:58:36-05:00",
            "sale_price": {
                "amount": "-15.24",
                "amount_cents": -1524,
                "currency": "USD",
                "symbol": "$",
                "display": "FREE"
            },
            "sale_currency": "USD",
            "processing_fee": {
                "amount": "-0.66",
                "amount_cents": -66,
                "currency": "USD",
                "symbol": "$",
                "display": "FREE"
            },
            "selling_fee": {
                "amount": "-0.50",
                "amount_cents": -50,
                "currency": "USD",
                "symbol": "$",
                "display": "FREE"
            },
            "affirm_promotion_fee": {
                "amount": "0.00",
                "amount_cents": 0,
                "currency": "USD",
                "symbol": "$",
                "display": "FREE"
            },
            "bump_fee": {
                "amount": "0.00",
                "amount_cents": 0,
                "currency": "USD",
                "symbol": "$",
                "display": "FREE"
            },
            "shipping_label_fee": {
                "amount": "0.00",
                "amount_cents": 0,
                "currency": "USD",
                "symbol": "$",
                "display": "FREE"
            },
            "applied_bucks": {
                "amount": "0.00",
                "amount_cents": 0,
                "currency": "USD",
                "symbol": "$",
                "display": "FREE"
            },
            "subtotal": {
                "amount": "-14.08",
                "amount_cents": -1408,
                "currency": "USD",
                "symbol": "$",
                "display": "FREE"
            },
            "payout_currency_exchange_fee": {
                "amount": "0.00",
                "amount_cents": 0,
                "currency": "USD",
                "symbol": "$",
                "display": "FREE"
            },
            "reverb_remitted_tax": {
                "amount": "0.00",
                "amount_cents": 0,
                "currency": "USD",
                "symbol": "$",
                "display": "FREE"
            },
            "total": {
                "amount": "-14.08",
                "amount_cents": -1408,
                "currency": "USD",
                "symbol": "$",
                "display": "FREE"
            },
            "total_payout": {
                "amount": "-14.08",
                "amount_cents": -1408,
                "currency": "USD",
                "symbol": "$",
                "display": "FREE"
            },
            "description": "Mi-T-Mist Mouthpiece Cleaner Economy Size"
        		"state": "paid_to_shop",
            "tax_on_fees": {
                "amount": "0.00",
                "amount_cents": 0,
                "currency": "GBP",
                "symbol": "£",
                "display": "£0.00"
        },
        {
            "order_id": 4932,
            "payout_currency": "USD",
            "sale_date": "2017-10-27T11:40:29-05:00",
            "sale_price": {
                "amount": "-30.48",
                "amount_cents": -3048,
                "currency": "USD",
                "symbol": "$",
                "display": "FREE"
            },
            "sale_currency": "USD",
            "processing_fee": {
                "amount": "-1.07",
                "amount_cents": -107,
                "currency": "USD",
                "symbol": "$",
                "display": "FREE"
            },
            "selling_fee": {
                "amount": "-0.50",
                "amount_cents": -50,
                "currency": "USD",
                "symbol": "$",
                "display": "FREE"
            },
            "affirm_promotion_fee": {
                "amount": "0.00",
                "amount_cents": 0,
                "currency": "USD",
                "symbol": "$",
                "display": "FREE"
            },
            "bump_fee": {
                "amount": "0.00",
                "amount_cents": 0,
                "currency": "USD",
                "symbol": "$",
                "display": "FREE"
            },
            "shipping_label_fee": {
                "amount": "0.00",
                "amount_cents": 0,
                "currency": "USD",
                "symbol": "$",
                "display": "FREE"
            },
            "applied_bucks": {
                "amount": "0.00",
                "amount_cents": 0,
                "currency": "USD",
                "symbol": "$",
                "display": "FREE"
            },
            "subtotal": {
                "amount": "-28.91",
                "amount_cents": -2891,
                "currency": "USD",
                "symbol": "$",
                "display": "FREE"
            },
            "payout_currency_exchange_fee": {
                "amount": "0.00",
                "amount_cents": 0,
                "currency": "USD",
                "symbol": "$",
                "display": "FREE"
            },
            "reverb_remitted_tax": {
                "amount": "0.00",
                "amount_cents": 0,
                "currency": "USD",
                "symbol": "$",
                "display": "FREE"
            },
            "total": {
                "amount": "-28.91",
                "amount_cents": -2891,
                "currency": "USD",
                "symbol": "$",
                "display": "FREE"
            },
            "total_payout": {
                "amount": "-28.91",
                "amount_cents": -2891,
                "currency": "USD",
                "symbol": "$",
                "display": "FREE"
            },
            "description": "Mi-T-Mist Mouthpiece Cleaner Economy Size"
        		"state": "paid_to_shop",
            "tax_on_fees": {
                "amount": "0.00",
                "amount_cents": 0,
                "currency": "GBP",
                "symbol": "£",
                "display": "£0.00"
        }
    ]
}