POST
/
api
/
service
/
deposit
/
retrieve
Retrieve a deposit
curl --request POST \
  --url https://api.sand.getivy.de/api/service/deposit/retrieve \
  --header 'Content-Type: application/json' \
  --header 'X-Ivy-Api-Key: <api-key>' \
  --data '{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "received",
  "amount": 123,
  "transactionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "currency": "EUR",
  "receivedAt": "2023-11-07T05:31:56Z",
  "payer": {
    "type": "iban",
    "iban": {
      "accountHolderName": "<string>",
      "iban": "<string>",
      "bic": "<string>"
    },
    "sortCode": {
      "accountHolderName": "<string>",
      "sortCode": "<string>",
      "accountNumber": "<string>"
    },
    "bankCode": {
      "accountHolderName": "<string>",
      "code": "<string>",
      "accountNumber": "<string>"
    },
    "bban": {
      "accountHolderName": "<string>",
      "bban": "<string>",
      "bic": "<string>"
    }
  },
  "payee": {
    "type": "iban",
    "iban": {
      "accountHolderName": "<string>",
      "iban": "<string>",
      "bic": "<string>"
    },
    "sortCode": {
      "accountHolderName": "<string>",
      "sortCode": "<string>",
      "accountNumber": "<string>"
    },
    "bankCode": {
      "accountHolderName": "<string>",
      "code": "<string>",
      "accountNumber": "<string>"
    },
    "bban": {
      "accountHolderName": "<string>",
      "bban": "<string>",
      "bic": "<string>"
    }
  },
  "bankStatementReference": "<string>",
  "rail": "<string>",
  "returns": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "depositId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "transactionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "status": "initiated",
      "amount": 123,
      "currency": "EUR",
      "createdAt": "2023-11-07T05:31:56Z",
      "failedAt": "2023-11-07T05:31:56Z",
      "succeededAt": "2023-11-07T05:31:56Z"
    }
  ]
}

Authorizations

X-Ivy-Api-Key
string
header
required

API key for authentication

Body

application/json

Response

200 - application/json

Deposit retrieved successfully

The response is of type object.