{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition","openapiLink"]},"type":"markdown"},"seo":{"title":"Retrieve Payout Requests for an Account","description":"Tilia Wallet Developer Documentation","siteUrl":"https://thunes-tilia-docs.redocly.app/","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"retrieve-payout-requests-for-an-account","__idx":0},"children":["Retrieve Payout Requests for an Account"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Another version of this information is available"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you're new to Tilia services, a newer version of this information is available in the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/tutorials/transactions"},"children":["Transaction Tutorials"]}," section of these docs, which might be an easier place to start."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To show details for all of the payout requests associated with an account, pass the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["account_id"]}," to the payouts endpoint."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This example requires an API token with the scope ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["read_process_credits"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"curl --location --request GET 'https://invoicing.tilia-inc.com/v2/<account_id>/payouts' \\\n--header 'Authorization: Bearer <Access_Token>' \\\n--header 'Content-Type: application/json' \\\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response includes a payout object for each payout that has been requested. The payout object includes the payout status ID, a status for the payout, the destination payment method, and other information:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"status\": \"Success\",\n  \"messages\": [],\n  \"codes\": [],\n  \"payload\": [\n\t\t{\n\t\t\t\"payout_status_id\": \"682c8d3e-75ad-4d10-8b1a-1e1576888888\",\n\t\t\t\"credit_id\": \"a3c570da-b7f9-4f84-aa3e-7cbd4f555555\",\n\t\t\t\"account_id\": \"98064cfd-de6f-4c48-a195-b52c66003dda\",\n\t\t\t\"status\": \"ESCROW-TRANSFER-INITIATED\",\n\t\t\t\"created\": \"2020-09-10 16:15:42.343045\",\n\t\t\t\"updated\": \"2020-09-10 16:15:42.489163\",\n\t\t\t\"credit\": {\n\t\t\t  \"destination_payment_method_id\": \"4ba04731-9f66-4123-a8a1-7ef815444444\",\n\t\t\t  \"amount\": 250,\n\t\t\t  \"currency\": \"USD\",\n\t\t\t  \"status\": \"CREATED\"\n\t\t\t}\n\t\t},\n\t\t{\n            \"payout_status_id\": \"5771d366-dcbb-4c22-9d60-ecdeacf0d6e4\",\n            \"credit_id\": \"71043c7f-c20c-4ddb-af56-5dde3959e63d\",\n            \"account_id\": \"682c8d3e-75ad-4d10-8b1a-1e15768e5d61\",\n            \"status\": \"SUPPORT-REJECT-TRANSFER-INITIATED\",\n            \"created\": \"2020-08-07 19:16:07.477643\",\n            \"updated\": \"2020-08-07 20:35:21.748722\",\n            \"credit\": {\n                \"destination_payment_method_id\": \"adaeca29-eda4-4bc0-87cc-1b7956420553\",\n                \"amount\": 50,\n                \"currency\": \"USD\",\n                \"status\": \"CANCELED\"\n            }\n        },\n        {\n            \"payout_status_id\": \"e9b9009f-17ca-49c6-a9ba-8415d019d796\",\n            \"credit_id\": \"df4c82ea-f5de-4363-8a41-c641ae04e85c\",\n            \"account_id\": \"682c8d3e-75ad-4d10-8b1a-1e15768e5d61\",\n            \"status\": \"SUCCESS\",\n            \"created\": \"2020-07-04 20:34:26.728047\",\n            \"updated\": \"2020-07-05 12:56:14.910492\",\n            \"credit\": {\n                \"destination_payment_method_id\": \"adaeca29-eda4-4bc0-87cc-1b7956420553\",\n                \"amount\": 10,\n                \"currency\": \"USD\",\n                \"status\": \"EXECUTED\"\n            }\n        }\n\t]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can also retrieve details for a specific payout request by passing the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["account_id"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payout_status_id"]}," to the payout endpoint."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"curl --location --request GET 'https://invoicing.tilia-inc.com/v2/<account_id>/payout/<payout_status_id>' \\\n--header 'Authorization: Bearer <Access_Token>' \\\n--header 'Content-Type: application/json' \\\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response includes the requested payout object."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"status\": \"Success\",\n  \"messages\": [],\n  \"codes\": [],\n  \"payload\": {\n    \"payout_status_id\": \"682c8d3e-75ad-4d10-8b1a-1e1576888888\",\n    \"credit_id\": \"a3c570da-b7f9-4f84-aa3e-7cbd4f555555\",\n    \"account_id\": \"98064cfd-de6f-4c48-a195-b52c66003dda\",\n    \"status\": \"ESCROW-TRANSFER-INITIATED\",\n    \"created\": \"2020-09-16 16:15:42.343045\",\n    \"updated\": \"2020-09-16 16:15:42.489163\",\n    \"credit\": {\n      \"destination_payment_method_id\": \"4ba04731-9f66-4123-a8a1-7ef815444444\",\n      \"amount\": 250,\n      \"currency\": \"USD\",\n      \"status\": \"CREATED\"\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For more information about the payout values, refer to the Payouts section of the ",{"$$mdtype":"Tag","name":"OpenapiLink","attributes":{"link":"invoicing/openapi","text":"Invoicing API"},"children":[]}," reference pages."]}]},"headings":[{"value":"Retrieve Payout Requests for an Account","id":"retrieve-payout-requests-for-an-account","depth":1}],"frontmatter":{"seo":{"title":"Retrieve Payout Requests for an Account"}},"lastModified":"2026-02-05T18:12:30.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/get-payout-requests","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}