Skip to main content
POST
/
api
/
service
/
payout
/
retrieve
JavaScript
import Ivy from '@getivy/node-sdk';

const client = new Ivy({
  apiKey: process.env['IVY_API_KEY'], // This is the default and can be omitted
});

const payout = await client.payouts.retrieve({ id: 'id' });

console.log(payout.id);
{
  "id": "<string>",
  "destination": {
    "iban": {
      "accountHolderName": "<string>",
      "iban": "<string>",
      "bic": "<string>"
    },
    "aba": {
      "accountHolderName": "<string>",
      "routingNumber": "<string>",
      "accountNumber": "<string>"
    },
    "sortCode": {
      "accountHolderName": "<string>",
      "sortCode": "<string>",
      "accountNumber": "<string>"
    },
    "bankCode": {
      "accountHolderName": "<string>",
      "code": "<string>",
      "accountNumber": "<string>"
    },
    "bban": {
      "accountHolderName": "<string>",
      "bban": "<string>",
      "bic": "<string>"
    },
    "wallet": {
      "address": "<string>"
    }
  },
  "amount": 123,
  "createdAt": "<unknown>",
  "updatedAt": "<unknown>",
  "metadata": {},
  "paymentReference": "<string>",
  "transactionId": "<string>",
  "failure": {
    "message": "<string>",
    "retry": true
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.augustus.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-Ivy-Api-Key
string
header
required

API key for authentication

Body

application/json
​
id
string
required

The payout ID

Response

200 - application/json

Retrieve a payout

​
id
string
required

The payout ID

​
type
enum<string>
required

The payout type

Available options:
beneficiary,
customer
​
destination
object
required

The payout destination

​
status
enum<string>
required

The payout status

Available options:
paid,
pending,
in_transit,
failed,
canceled
​
amount
number
required

The payout amount

​
currency
enum<string>
required

The payout currency

Available options:
EUR,
GBP,
USDC,
USD
​
createdAt
any
required

The payout created at

​
updatedAt
any
required

The payout updated at

​
metadata
object

The payout metadata

​
paymentReference
string

The payout payment reference

​
transactionId
string

The payout transaction ID

​
failure
object

Failure details. Only available if the payout failed.