{"_id":"59fa7858c17ff100384074aa","project":"556cd8aec14029190092d292","version":{"_id":"556cd8aec14029190092d295","__v":14,"project":"556cd8aec14029190092d292","createdAt":"2015-06-01T22:11:58.756Z","releaseDate":"2015-06-01T22:11:58.756Z","categories":["556cd8afc14029190092d296","55ca5a55241e790d004f47ea","55dc9fdb4f535537007da1b2","55dc9fdfc755b63700dc843c","55fdb08c4bebdf17004130d4","560ef4c2a36c610d00e7013e","5613db296a092921004c30c2","56156581dc8aea0d002475e8","56169d1ee98f5517005627a8","5622fde7de7dc01700c6dd5f","56cf75f3336aa60b0086a495","5818f3c02093901b00bcf91a","582f7ff88ea0800f0035639a","583f30c110448a2500dd990f"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"category":{"_id":"55fdb08c4bebdf17004130d4","project":"556cd8aec14029190092d292","version":"556cd8aec14029190092d295","__v":11,"pages":["55fdb124b652110d00758b70","55fdb2a956d6990d00a6caca","55fdb38856d6990d00a6cacc","55ff6c519e7ccf0d000a1d7f","5613db97acd4343500088079","5616d7b9cf2a1e0d00247971","56196204fa2a6d0d002a1352","5622f2c906481c0d00e5315c","569526b8caa32519009c411e","569fbbcbbeb79a17009f8f89","56aac68aac665d0d00af76b0"],"sync":{"url":"","isSync":false},"reference":true,"createdAt":"2015-09-19T18:59:24.105Z","from_sync":false,"order":4,"slug":"how-to","title":"How To..."},"user":"566efeab7ffa002300c3cd06","__v":0,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-11-02T01:43:52.863Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":true,"order":999,"body":"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.\n[block:api-header]\n{\n  \"title\": \"Fetching Payouts periodically\"\n}\n[/block]\nYour 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.\n\nFirst, we'll fetch the payouts for a given date range. Note that the dates are in [ISO8601 format](https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"curl -XGET -H \\\"Authorization: Bearer [oauth_token]\\\" -H \\\"Content-Type: application/hal+json\\\" 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\",\n      \"language\": \"curl\"\n    }\n  ]\n}\n[/block]\nThe 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 or reverb bucks.\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n    \\\"total\\\": 8,\\n    \\\"current_page\\\": 1,\\n    \\\"per_page\\\": 5,\\n    \\\"total_pages\\\": 2,\\n    \\\"_links\\\": {\\n        \\\"next\\\": {\\n            \\\"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\\\"\\n        }\\n    },\\n    \\\"payouts\\\": [\\n        {\\n            \\\"total\\\": {\\n                \\\"amount\\\": \\\"11.88\\\",\\n                \\\"amount_cents\\\": 1188,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"$11.88\\\"\\n            },\\n            \\\"created_at\\\": \\\"2017-10-27T11:56:08-05:00\\\",\\n            \\\"updated_at\\\": \\\"2017-10-30T10:46:59-05:00\\\",\\n            \\\"_links\\\": {\\n                \\\"line_items\\\": {\\n                    \\\"href\\\": \\\"https://api.reverb.com/api/my/payouts/54/line_items\\\"\\n                }\\n            }\\n        },\\n        {\\n            \\\"total\\\": {\\n                \\\"amount\\\": \\\"57.07\\\",\\n                \\\"amount_cents\\\": 5707,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"$57.07\\\"\\n            },\\n            \\\"created_at\\\": \\\"2017-10-26T11:39:23-05:00\\\",\\n            \\\"updated_at\\\": \\\"2017-10-30T10:46:59-05:00\\\",\\n            \\\"_links\\\": {\\n                \\\"line_items\\\": {\\n                    \\\"href\\\": \\\"https://api.reverb.com/api/my/payouts/52/line_items\\\"\\n                }\\n            }\\n        },\\n        {\\n            \\\"total\\\": {\\n                \\\"amount\\\": \\\"193.40\\\",\\n                \\\"amount_cents\\\": 19340,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"$193.40\\\"\\n            },\\n            \\\"created_at\\\": \\\"2017-10-25T11:51:13-05:00\\\",\\n            \\\"updated_at\\\": \\\"2017-10-30T10:46:59-05:00\\\",\\n            \\\"_links\\\": {\\n                \\\"line_items\\\": {\\n                    \\\"href\\\": \\\"https://api.reverb.com/api/my/payouts/51/line_items\\\"\\n                }\\n            }\\n        },\\n        {\\n            \\\"total\\\": {\\n                \\\"amount\\\": \\\"602.86\\\",\\n                \\\"amount_cents\\\": 60286,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"$602.86\\\"\\n            },\\n            \\\"created_at\\\": \\\"2017-10-24T11:57:20-05:00\\\",\\n            \\\"updated_at\\\": \\\"2017-10-30T10:46:59-05:00\\\",\\n            \\\"_links\\\": {\\n                \\\"line_items\\\": {\\n                    \\\"href\\\": \\\"https://api.reverb.com/api/my/payouts/48/line_items\\\"\\n                }\\n            }\\n        },\\n        {\\n            \\\"total\\\": {\\n                \\\"amount\\\": \\\"324.96\\\",\\n                \\\"amount_cents\\\": 32496,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"$324.96\\\"\\n            },\\n            \\\"created_at\\\": \\\"2017-10-20T11:03:55-05:00\\\",\\n            \\\"updated_at\\\": \\\"2017-10-30T10:46:59-05:00\\\",\\n            \\\"_links\\\": {\\n                \\\"line_items\\\": {\\n                    \\\"href\\\": \\\"https://api.reverb.com/api/my/payouts/47/line_items\\\"\\n                }\\n            }\\n        }\\n    ]\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\nBy themselves, payouts do not give you much. To peek into each line item for the payout, follow the line item links.\n[block:api-header]\n{\n  \"title\": \"Payout Line Items\"\n}\n[/block]\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"curl -XGET -H \\\"Authorization: Bearer [oauth_token]\\\" -H \\\"Content-Type: application/hal+json\\\" https://api.reverb.com/api/my/payouts/54/line_items?per_page=5\",\n      \"language\": \"curl\"\n    }\n  ]\n}\n[/block]\nThe response will contain a list of payout line item objects, which represent a the line item for each order in that payout.\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n    \\\"total\\\": 7,\\n    \\\"current_page\\\": 1,\\n    \\\"per_page\\\": 5,\\n    \\\"total_pages\\\": 2,\\n    \\\"_links\\\": {\\n        \\\"next\\\": {\\n            \\\"href\\\": \\\"https://api.reverb.com/api/my/payouts/54/line_items?page=2&per_page=5\\\"\\n        }\\n    },\\n    \\\"payout_line_items\\\": [\\n        {\\n            \\\"order_id\\\": 4945,\\n            \\\"payout_currency\\\": \\\"USD\\\",\\n            \\\"sale_date\\\": \\\"2017-10-27T15:20:24-05:00\\\",\\n            \\\"sale_price\\\": {\\n                \\\"amount\\\": \\\"15.83\\\",\\n                \\\"amount_cents\\\": 1583,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"$15.83\\\"\\n            },\\n            \\\"sale_currency\\\": \\\"USD\\\",\\n            \\\"processing_fee\\\": {\\n                \\\"amount\\\": \\\"0.68\\\",\\n                \\\"amount_cents\\\": 68,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"$0.68\\\"\\n            },\\n            \\\"selling_fee\\\": {\\n                \\\"amount\\\": \\\"0.50\\\",\\n                \\\"amount_cents\\\": 50,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"$0.50\\\"\\n            },\\n            \\\"affirm_promotion_fee\\\": {\\n                \\\"amount\\\": \\\"0.00\\\",\\n                \\\"amount_cents\\\": 0,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"FREE\\\"\\n            },\\n            \\\"bump_fee\\\": {\\n                \\\"amount\\\": \\\"0.00\\\",\\n                \\\"amount_cents\\\": 0,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"FREE\\\"\\n            },\\n            \\\"shipping_label_fee\\\": {\\n                \\\"amount\\\": \\\"0.00\\\",\\n                \\\"amount_cents\\\": 0,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"FREE\\\"\\n            },\\n            \\\"applied_bucks\\\": {\\n                \\\"amount\\\": \\\"0.00\\\",\\n                \\\"amount_cents\\\": 0,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"FREE\\\"\\n            },\\n            \\\"subtotal\\\": {\\n                \\\"amount\\\": \\\"14.65\\\",\\n                \\\"amount_cents\\\": 1465,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"$14.65\\\"\\n            },\\n            \\\"payout_currency_exchange_fee\\\": {\\n                \\\"amount\\\": \\\"0.00\\\",\\n                \\\"amount_cents\\\": 0,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"FREE\\\"\\n            },\\n            \\\"total\\\": {\\n                \\\"amount\\\": \\\"14.65\\\",\\n                \\\"amount_cents\\\": 1465,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"$14.65\\\"\\n            },\\n            \\\"total_payout\\\": {\\n                \\\"amount\\\": \\\"14.65\\\",\\n                \\\"amount_cents\\\": 1465,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"$14.65\\\"\\n            },\\n            \\\"description\\\": \\\"Mi-T-Mist Mouthpiece Cleaner Economy Size\\\"\\n        },\\n        {\\n            \\\"order_id\\\": 4944,\\n            \\\"payout_currency\\\": \\\"USD\\\",\\n            \\\"sale_date\\\": \\\"2017-10-27T15:20:24-05:00\\\",\\n            \\\"sale_price\\\": {\\n                \\\"amount\\\": \\\"16.24\\\",\\n                \\\"amount_cents\\\": 1624,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"$16.24\\\"\\n            },\\n            \\\"sale_currency\\\": \\\"USD\\\",\\n            \\\"processing_fee\\\": {\\n                \\\"amount\\\": \\\"0.69\\\",\\n                \\\"amount_cents\\\": 69,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"$0.69\\\"\\n            },\\n            \\\"selling_fee\\\": {\\n                \\\"amount\\\": \\\"0.50\\\",\\n                \\\"amount_cents\\\": 50,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"$0.50\\\"\\n            },\\n            \\\"affirm_promotion_fee\\\": {\\n                \\\"amount\\\": \\\"0.00\\\",\\n                \\\"amount_cents\\\": 0,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"FREE\\\"\\n            },\\n            \\\"bump_fee\\\": {\\n                \\\"amount\\\": \\\"0.00\\\",\\n                \\\"amount_cents\\\": 0,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"FREE\\\"\\n            },\\n            \\\"shipping_label_fee\\\": {\\n                \\\"amount\\\": \\\"0.00\\\",\\n                \\\"amount_cents\\\": 0,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"FREE\\\"\\n            },\\n            \\\"applied_bucks\\\": {\\n                \\\"amount\\\": \\\"0.00\\\",\\n                \\\"amount_cents\\\": 0,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"FREE\\\"\\n            },\\n            \\\"subtotal\\\": {\\n                \\\"amount\\\": \\\"15.05\\\",\\n                \\\"amount_cents\\\": 1505,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"$15.05\\\"\\n            },\\n            \\\"payout_currency_exchange_fee\\\": {\\n                \\\"amount\\\": \\\"0.00\\\",\\n                \\\"amount_cents\\\": 0,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"FREE\\\"\\n            },\\n            \\\"total\\\": {\\n                \\\"amount\\\": \\\"15.05\\\",\\n                \\\"amount_cents\\\": 1505,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"$15.05\\\"\\n            },\\n            \\\"total_payout\\\": {\\n                \\\"amount\\\": \\\"15.05\\\",\\n                \\\"amount_cents\\\": 1505,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"$15.05\\\"\\n            },\\n            \\\"description\\\": \\\"EXP11 Coated 80/20 Bronze Light Acoustic Guitar Strings Level 1\\\"\\n        },\\n        {\\n            \\\"order_id\\\": 4943,\\n            \\\"payout_currency\\\": \\\"USD\\\",\\n            \\\"sale_date\\\": \\\"2017-10-27T13:51:57-05:00\\\",\\n            \\\"sale_price\\\": {\\n                \\\"amount\\\": \\\"16.46\\\",\\n                \\\"amount_cents\\\": 1646,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"$16.46\\\"\\n            },\\n            \\\"sale_currency\\\": \\\"USD\\\",\\n            \\\"processing_fee\\\": {\\n                \\\"amount\\\": \\\"0.69\\\",\\n                \\\"amount_cents\\\": 69,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"$0.69\\\"\\n            },\\n            \\\"selling_fee\\\": {\\n                \\\"amount\\\": \\\"0.50\\\",\\n                \\\"amount_cents\\\": 50,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"$0.50\\\"\\n            },\\n            \\\"affirm_promotion_fee\\\": {\\n                \\\"amount\\\": \\\"0.00\\\",\\n                \\\"amount_cents\\\": 0,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"FREE\\\"\\n            },\\n            \\\"bump_fee\\\": {\\n                \\\"amount\\\": \\\"0.00\\\",\\n                \\\"amount_cents\\\": 0,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"FREE\\\"\\n            },\\n            \\\"shipping_label_fee\\\": {\\n                \\\"amount\\\": \\\"0.00\\\",\\n                \\\"amount_cents\\\": 0,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"FREE\\\"\\n            },\\n            \\\"applied_bucks\\\": {\\n                \\\"amount\\\": \\\"0.00\\\",\\n                \\\"amount_cents\\\": 0,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"FREE\\\"\\n            },\\n            \\\"subtotal\\\": {\\n                \\\"amount\\\": \\\"15.27\\\",\\n                \\\"amount_cents\\\": 1527,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"$15.27\\\"\\n            },\\n            \\\"payout_currency_exchange_fee\\\": {\\n                \\\"amount\\\": \\\"0.00\\\",\\n                \\\"amount_cents\\\": 0,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"FREE\\\"\\n            },\\n            \\\"total\\\": {\\n                \\\"amount\\\": \\\"15.27\\\",\\n                \\\"amount_cents\\\": 1527,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"$15.27\\\"\\n            },\\n            \\\"total_payout\\\": {\\n                \\\"amount\\\": \\\"15.27\\\",\\n                \\\"amount_cents\\\": 1527,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"$15.27\\\"\\n            },\\n            \\\"description\\\": \\\"EXP11 Coated 80/20 Bronze Light Acoustic Guitar Strings Level 1\\\"\\n        },\\n        {\\n            \\\"order_id\\\": 4935,\\n            \\\"payout_currency\\\": \\\"USD\\\",\\n            \\\"sale_date\\\": \\\"2017-10-27T11:58:36-05:00\\\",\\n            \\\"sale_price\\\": {\\n                \\\"amount\\\": \\\"-15.24\\\",\\n                \\\"amount_cents\\\": -1524,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"FREE\\\"\\n            },\\n            \\\"sale_currency\\\": \\\"USD\\\",\\n            \\\"processing_fee\\\": {\\n                \\\"amount\\\": \\\"-0.66\\\",\\n                \\\"amount_cents\\\": -66,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"FREE\\\"\\n            },\\n            \\\"selling_fee\\\": {\\n                \\\"amount\\\": \\\"-0.50\\\",\\n                \\\"amount_cents\\\": -50,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"FREE\\\"\\n            },\\n            \\\"affirm_promotion_fee\\\": {\\n                \\\"amount\\\": \\\"0.00\\\",\\n                \\\"amount_cents\\\": 0,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"FREE\\\"\\n            },\\n            \\\"bump_fee\\\": {\\n                \\\"amount\\\": \\\"0.00\\\",\\n                \\\"amount_cents\\\": 0,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"FREE\\\"\\n            },\\n            \\\"shipping_label_fee\\\": {\\n                \\\"amount\\\": \\\"0.00\\\",\\n                \\\"amount_cents\\\": 0,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"FREE\\\"\\n            },\\n            \\\"applied_bucks\\\": {\\n                \\\"amount\\\": \\\"0.00\\\",\\n                \\\"amount_cents\\\": 0,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"FREE\\\"\\n            },\\n            \\\"subtotal\\\": {\\n                \\\"amount\\\": \\\"-14.08\\\",\\n                \\\"amount_cents\\\": -1408,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"FREE\\\"\\n            },\\n            \\\"payout_currency_exchange_fee\\\": {\\n                \\\"amount\\\": \\\"0.00\\\",\\n                \\\"amount_cents\\\": 0,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"FREE\\\"\\n            },\\n            \\\"total\\\": {\\n                \\\"amount\\\": \\\"-14.08\\\",\\n                \\\"amount_cents\\\": -1408,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"FREE\\\"\\n            },\\n            \\\"total_payout\\\": {\\n                \\\"amount\\\": \\\"-14.08\\\",\\n                \\\"amount_cents\\\": -1408,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"FREE\\\"\\n            },\\n            \\\"description\\\": \\\"Mi-T-Mist Mouthpiece Cleaner Economy Size\\\"\\n        },\\n        {\\n            \\\"order_id\\\": 4932,\\n            \\\"payout_currency\\\": \\\"USD\\\",\\n            \\\"sale_date\\\": \\\"2017-10-27T11:40:29-05:00\\\",\\n            \\\"sale_price\\\": {\\n                \\\"amount\\\": \\\"-30.48\\\",\\n                \\\"amount_cents\\\": -3048,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"FREE\\\"\\n            },\\n            \\\"sale_currency\\\": \\\"USD\\\",\\n            \\\"processing_fee\\\": {\\n                \\\"amount\\\": \\\"-1.07\\\",\\n                \\\"amount_cents\\\": -107,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"FREE\\\"\\n            },\\n            \\\"selling_fee\\\": {\\n                \\\"amount\\\": \\\"-0.50\\\",\\n                \\\"amount_cents\\\": -50,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"FREE\\\"\\n            },\\n            \\\"affirm_promotion_fee\\\": {\\n                \\\"amount\\\": \\\"0.00\\\",\\n                \\\"amount_cents\\\": 0,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"FREE\\\"\\n            },\\n            \\\"bump_fee\\\": {\\n                \\\"amount\\\": \\\"0.00\\\",\\n                \\\"amount_cents\\\": 0,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"FREE\\\"\\n            },\\n            \\\"shipping_label_fee\\\": {\\n                \\\"amount\\\": \\\"0.00\\\",\\n                \\\"amount_cents\\\": 0,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"FREE\\\"\\n            },\\n            \\\"applied_bucks\\\": {\\n                \\\"amount\\\": \\\"0.00\\\",\\n                \\\"amount_cents\\\": 0,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"FREE\\\"\\n            },\\n            \\\"subtotal\\\": {\\n                \\\"amount\\\": \\\"-28.91\\\",\\n                \\\"amount_cents\\\": -2891,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"FREE\\\"\\n            },\\n            \\\"payout_currency_exchange_fee\\\": {\\n                \\\"amount\\\": \\\"0.00\\\",\\n                \\\"amount_cents\\\": 0,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"FREE\\\"\\n            },\\n            \\\"total\\\": {\\n                \\\"amount\\\": \\\"-28.91\\\",\\n                \\\"amount_cents\\\": -2891,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"FREE\\\"\\n            },\\n            \\\"total_payout\\\": {\\n                \\\"amount\\\": \\\"-28.91\\\",\\n                \\\"amount_cents\\\": -2891,\\n                \\\"currency\\\": \\\"USD\\\",\\n                \\\"symbol\\\": \\\"$\\\",\\n                \\\"display\\\": \\\"FREE\\\"\\n            },\\n            \\\"description\\\": \\\"Mi-T-Mist Mouthpiece Cleaner Economy Size\\\"\\n        }\\n    ]\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]","excerpt":"","slug":"read-payouts","type":"basic","title":"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. [block:api-header] { "title": "Fetching Payouts periodically" } [/block] 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](https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations). [block:code] { "codes": [ { "code": "curl -XGET -H \"Authorization: Bearer [oauth_token]\" -H \"Content-Type: application/hal+json\" 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", "language": "curl" } ] } [/block] 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 or reverb bucks. [block:code] { "codes": [ { "code": "{\n \"total\": 8,\n \"current_page\": 1,\n \"per_page\": 5,\n \"total_pages\": 2,\n \"_links\": {\n \"next\": {\n \"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\"\n }\n },\n \"payouts\": [\n {\n \"total\": {\n \"amount\": \"11.88\",\n \"amount_cents\": 1188,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"$11.88\"\n },\n \"created_at\": \"2017-10-27T11:56:08-05:00\",\n \"updated_at\": \"2017-10-30T10:46:59-05:00\",\n \"_links\": {\n \"line_items\": {\n \"href\": \"https://api.reverb.com/api/my/payouts/54/line_items\"\n }\n }\n },\n {\n \"total\": {\n \"amount\": \"57.07\",\n \"amount_cents\": 5707,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"$57.07\"\n },\n \"created_at\": \"2017-10-26T11:39:23-05:00\",\n \"updated_at\": \"2017-10-30T10:46:59-05:00\",\n \"_links\": {\n \"line_items\": {\n \"href\": \"https://api.reverb.com/api/my/payouts/52/line_items\"\n }\n }\n },\n {\n \"total\": {\n \"amount\": \"193.40\",\n \"amount_cents\": 19340,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"$193.40\"\n },\n \"created_at\": \"2017-10-25T11:51:13-05:00\",\n \"updated_at\": \"2017-10-30T10:46:59-05:00\",\n \"_links\": {\n \"line_items\": {\n \"href\": \"https://api.reverb.com/api/my/payouts/51/line_items\"\n }\n }\n },\n {\n \"total\": {\n \"amount\": \"602.86\",\n \"amount_cents\": 60286,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"$602.86\"\n },\n \"created_at\": \"2017-10-24T11:57:20-05:00\",\n \"updated_at\": \"2017-10-30T10:46:59-05:00\",\n \"_links\": {\n \"line_items\": {\n \"href\": \"https://api.reverb.com/api/my/payouts/48/line_items\"\n }\n }\n },\n {\n \"total\": {\n \"amount\": \"324.96\",\n \"amount_cents\": 32496,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"$324.96\"\n },\n \"created_at\": \"2017-10-20T11:03:55-05:00\",\n \"updated_at\": \"2017-10-30T10:46:59-05:00\",\n \"_links\": {\n \"line_items\": {\n \"href\": \"https://api.reverb.com/api/my/payouts/47/line_items\"\n }\n }\n }\n ]\n}", "language": "json" } ] } [/block] By themselves, payouts do not give you much. To peek into each line item for the payout, follow the line item links. [block:api-header] { "title": "Payout Line Items" } [/block] [block:code] { "codes": [ { "code": "curl -XGET -H \"Authorization: Bearer [oauth_token]\" -H \"Content-Type: application/hal+json\" https://api.reverb.com/api/my/payouts/54/line_items?per_page=5", "language": "curl" } ] } [/block] The response will contain a list of payout line item objects, which represent a the line item for each order in that payout. [block:code] { "codes": [ { "code": "{\n \"total\": 7,\n \"current_page\": 1,\n \"per_page\": 5,\n \"total_pages\": 2,\n \"_links\": {\n \"next\": {\n \"href\": \"https://api.reverb.com/api/my/payouts/54/line_items?page=2&per_page=5\"\n }\n },\n \"payout_line_items\": [\n {\n \"order_id\": 4945,\n \"payout_currency\": \"USD\",\n \"sale_date\": \"2017-10-27T15:20:24-05:00\",\n \"sale_price\": {\n \"amount\": \"15.83\",\n \"amount_cents\": 1583,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"$15.83\"\n },\n \"sale_currency\": \"USD\",\n \"processing_fee\": {\n \"amount\": \"0.68\",\n \"amount_cents\": 68,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"$0.68\"\n },\n \"selling_fee\": {\n \"amount\": \"0.50\",\n \"amount_cents\": 50,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"$0.50\"\n },\n \"affirm_promotion_fee\": {\n \"amount\": \"0.00\",\n \"amount_cents\": 0,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"FREE\"\n },\n \"bump_fee\": {\n \"amount\": \"0.00\",\n \"amount_cents\": 0,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"FREE\"\n },\n \"shipping_label_fee\": {\n \"amount\": \"0.00\",\n \"amount_cents\": 0,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"FREE\"\n },\n \"applied_bucks\": {\n \"amount\": \"0.00\",\n \"amount_cents\": 0,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"FREE\"\n },\n \"subtotal\": {\n \"amount\": \"14.65\",\n \"amount_cents\": 1465,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"$14.65\"\n },\n \"payout_currency_exchange_fee\": {\n \"amount\": \"0.00\",\n \"amount_cents\": 0,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"FREE\"\n },\n \"total\": {\n \"amount\": \"14.65\",\n \"amount_cents\": 1465,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"$14.65\"\n },\n \"total_payout\": {\n \"amount\": \"14.65\",\n \"amount_cents\": 1465,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"$14.65\"\n },\n \"description\": \"Mi-T-Mist Mouthpiece Cleaner Economy Size\"\n },\n {\n \"order_id\": 4944,\n \"payout_currency\": \"USD\",\n \"sale_date\": \"2017-10-27T15:20:24-05:00\",\n \"sale_price\": {\n \"amount\": \"16.24\",\n \"amount_cents\": 1624,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"$16.24\"\n },\n \"sale_currency\": \"USD\",\n \"processing_fee\": {\n \"amount\": \"0.69\",\n \"amount_cents\": 69,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"$0.69\"\n },\n \"selling_fee\": {\n \"amount\": \"0.50\",\n \"amount_cents\": 50,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"$0.50\"\n },\n \"affirm_promotion_fee\": {\n \"amount\": \"0.00\",\n \"amount_cents\": 0,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"FREE\"\n },\n \"bump_fee\": {\n \"amount\": \"0.00\",\n \"amount_cents\": 0,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"FREE\"\n },\n \"shipping_label_fee\": {\n \"amount\": \"0.00\",\n \"amount_cents\": 0,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"FREE\"\n },\n \"applied_bucks\": {\n \"amount\": \"0.00\",\n \"amount_cents\": 0,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"FREE\"\n },\n \"subtotal\": {\n \"amount\": \"15.05\",\n \"amount_cents\": 1505,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"$15.05\"\n },\n \"payout_currency_exchange_fee\": {\n \"amount\": \"0.00\",\n \"amount_cents\": 0,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"FREE\"\n },\n \"total\": {\n \"amount\": \"15.05\",\n \"amount_cents\": 1505,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"$15.05\"\n },\n \"total_payout\": {\n \"amount\": \"15.05\",\n \"amount_cents\": 1505,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"$15.05\"\n },\n \"description\": \"EXP11 Coated 80/20 Bronze Light Acoustic Guitar Strings Level 1\"\n },\n {\n \"order_id\": 4943,\n \"payout_currency\": \"USD\",\n \"sale_date\": \"2017-10-27T13:51:57-05:00\",\n \"sale_price\": {\n \"amount\": \"16.46\",\n \"amount_cents\": 1646,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"$16.46\"\n },\n \"sale_currency\": \"USD\",\n \"processing_fee\": {\n \"amount\": \"0.69\",\n \"amount_cents\": 69,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"$0.69\"\n },\n \"selling_fee\": {\n \"amount\": \"0.50\",\n \"amount_cents\": 50,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"$0.50\"\n },\n \"affirm_promotion_fee\": {\n \"amount\": \"0.00\",\n \"amount_cents\": 0,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"FREE\"\n },\n \"bump_fee\": {\n \"amount\": \"0.00\",\n \"amount_cents\": 0,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"FREE\"\n },\n \"shipping_label_fee\": {\n \"amount\": \"0.00\",\n \"amount_cents\": 0,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"FREE\"\n },\n \"applied_bucks\": {\n \"amount\": \"0.00\",\n \"amount_cents\": 0,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"FREE\"\n },\n \"subtotal\": {\n \"amount\": \"15.27\",\n \"amount_cents\": 1527,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"$15.27\"\n },\n \"payout_currency_exchange_fee\": {\n \"amount\": \"0.00\",\n \"amount_cents\": 0,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"FREE\"\n },\n \"total\": {\n \"amount\": \"15.27\",\n \"amount_cents\": 1527,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"$15.27\"\n },\n \"total_payout\": {\n \"amount\": \"15.27\",\n \"amount_cents\": 1527,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"$15.27\"\n },\n \"description\": \"EXP11 Coated 80/20 Bronze Light Acoustic Guitar Strings Level 1\"\n },\n {\n \"order_id\": 4935,\n \"payout_currency\": \"USD\",\n \"sale_date\": \"2017-10-27T11:58:36-05:00\",\n \"sale_price\": {\n \"amount\": \"-15.24\",\n \"amount_cents\": -1524,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"FREE\"\n },\n \"sale_currency\": \"USD\",\n \"processing_fee\": {\n \"amount\": \"-0.66\",\n \"amount_cents\": -66,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"FREE\"\n },\n \"selling_fee\": {\n \"amount\": \"-0.50\",\n \"amount_cents\": -50,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"FREE\"\n },\n \"affirm_promotion_fee\": {\n \"amount\": \"0.00\",\n \"amount_cents\": 0,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"FREE\"\n },\n \"bump_fee\": {\n \"amount\": \"0.00\",\n \"amount_cents\": 0,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"FREE\"\n },\n \"shipping_label_fee\": {\n \"amount\": \"0.00\",\n \"amount_cents\": 0,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"FREE\"\n },\n \"applied_bucks\": {\n \"amount\": \"0.00\",\n \"amount_cents\": 0,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"FREE\"\n },\n \"subtotal\": {\n \"amount\": \"-14.08\",\n \"amount_cents\": -1408,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"FREE\"\n },\n \"payout_currency_exchange_fee\": {\n \"amount\": \"0.00\",\n \"amount_cents\": 0,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"FREE\"\n },\n \"total\": {\n \"amount\": \"-14.08\",\n \"amount_cents\": -1408,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"FREE\"\n },\n \"total_payout\": {\n \"amount\": \"-14.08\",\n \"amount_cents\": -1408,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"FREE\"\n },\n \"description\": \"Mi-T-Mist Mouthpiece Cleaner Economy Size\"\n },\n {\n \"order_id\": 4932,\n \"payout_currency\": \"USD\",\n \"sale_date\": \"2017-10-27T11:40:29-05:00\",\n \"sale_price\": {\n \"amount\": \"-30.48\",\n \"amount_cents\": -3048,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"FREE\"\n },\n \"sale_currency\": \"USD\",\n \"processing_fee\": {\n \"amount\": \"-1.07\",\n \"amount_cents\": -107,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"FREE\"\n },\n \"selling_fee\": {\n \"amount\": \"-0.50\",\n \"amount_cents\": -50,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"FREE\"\n },\n \"affirm_promotion_fee\": {\n \"amount\": \"0.00\",\n \"amount_cents\": 0,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"FREE\"\n },\n \"bump_fee\": {\n \"amount\": \"0.00\",\n \"amount_cents\": 0,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"FREE\"\n },\n \"shipping_label_fee\": {\n \"amount\": \"0.00\",\n \"amount_cents\": 0,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"FREE\"\n },\n \"applied_bucks\": {\n \"amount\": \"0.00\",\n \"amount_cents\": 0,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"FREE\"\n },\n \"subtotal\": {\n \"amount\": \"-28.91\",\n \"amount_cents\": -2891,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"FREE\"\n },\n \"payout_currency_exchange_fee\": {\n \"amount\": \"0.00\",\n \"amount_cents\": 0,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"FREE\"\n },\n \"total\": {\n \"amount\": \"-28.91\",\n \"amount_cents\": -2891,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"FREE\"\n },\n \"total_payout\": {\n \"amount\": \"-28.91\",\n \"amount_cents\": -2891,\n \"currency\": \"USD\",\n \"symbol\": \"$\",\n \"display\": \"FREE\"\n },\n \"description\": \"Mi-T-Mist Mouthpiece Cleaner Economy Size\"\n }\n ]\n}", "language": "json" } ] } [/block]