{
  "info": {
    "_postman_id": "49ea5eeb-0e40-4891-9458-e94648741473",
    "name": "Upvest Investment Account Transfers Direct Debits API",
    "description": "The Upvest Investment API provides a unified interface for building embedded investment experiences. It supports placing and managing orders, creating portfolios, configuring savings plans, handling securities transfers, and managing user accounts and positions. The API covers the full order lifecycle with asynchronous processing and webhook notifications for real-time event handling. Financial institutions can use the API to offer fractional investing, automated portfolio management, and localized investment products across European and UK markets.\n\nContact Support:\n Name: Upvest Support",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "createdAt": "2026-07-28T03:24:06.000Z",
    "updatedAt": "2026-07-28T03:24:07.000Z",
    "lastUpdatedBy": "35240",
    "uid": "35240-49ea5eeb-0e40-4891-9458-e94648741473"
  },
  "item": [
    {
      "name": "direct_debits",
      "item": [
        {
          "name": "Upvest Create a direct debit",
          "id": "e835c45c-3992-4bd2-b59d-83c5797418e3",
          "protocolProfileBehavior": {
            "disableBodyPruning": true
          },
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"user_id\": \"<uuid>\",\n  \"account_group_id\": \"<uuid>\",\n  \"mandate_id\": \"<uuid>\",\n  \"cash_amount\": \"<string>\",\n  \"currency\": \"CRZ\",\n  \"remittance_information\": \"<string>\"\n}",
              "options": {
                "raw": {
                  "headerFamily": "json",
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{baseUrl}}/direct_debits",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "direct_debits"
              ]
            },
            "description": "Submit a direct debit funding request to transfer funds into an investment account."
          },
          "response": [
            {
              "id": "4994cc77-c7ea-4095-88a7-60c9f5b438b9",
              "name": "Direct debit created",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  },
                  {
                    "key": "Accept",
                    "value": "application/json"
                  },
                  {
                    "description": "Added as a part of security scheme: oauth2",
                    "key": "Authorization",
                    "value": "<token>"
                  }
                ],
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"user_id\": \"<uuid>\",\n  \"account_group_id\": \"<uuid>\",\n  \"mandate_id\": \"<uuid>\",\n  \"cash_amount\": \"<string>\",\n  \"currency\": \"CRZ\",\n  \"remittance_information\": \"<string>\"\n}",
                  "options": {
                    "raw": {
                      "headerFamily": "json",
                      "language": "json"
                    }
                  }
                },
                "url": {
                  "raw": "{{baseUrl}}/direct_debits",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "direct_debits"
                  ]
                }
              },
              "status": "Created",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "cookie": [],
              "responseTime": null,
              "body": "{\n  \"id\": \"<uuid>\",\n  \"user_id\": \"<uuid>\",\n  \"account_group_id\": \"<uuid>\",\n  \"mandate_id\": \"<uuid>\",\n  \"cash_amount\": \"<string>\",\n  \"currency\": \"BQB\",\n  \"remittance_information\": \"<string>\",\n  \"status\": \"REVERSED\",\n  \"created_at\": \"<dateTime>\"\n}",
              "createdAt": "2026-07-28T03:24:07.000Z",
              "updatedAt": "2026-07-28T03:24:07.000Z",
              "uid": "35240-4994cc77-c7ea-4095-88a7-60c9f5b438b9"
            },
            {
              "id": "a09551b6-2ad0-480a-b498-36234cf72644",
              "name": "Invalid request",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  },
                  {
                    "key": "Accept",
                    "value": "application/json"
                  },
                  {
                    "description": "Added as a part of security scheme: oauth2",
                    "key": "Authorization",
                    "value": "<token>"
                  }
                ],
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"user_id\": \"<uuid>\",\n  \"account_group_id\": \"<uuid>\",\n  \"mandate_id\": \"<uuid>\",\n  \"cash_amount\": \"<string>\",\n  \"currency\": \"CRZ\",\n  \"remittance_information\": \"<string>\"\n}",
                  "options": {
                    "raw": {
                      "headerFamily": "json",
                      "language": "json"
                    }
                  }
                },
                "url": {
                  "raw": "{{baseUrl}}/direct_debits",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "direct_debits"
                  ]
                }
              },
              "status": "Bad Request",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "cookie": [],
              "responseTime": null,
              "body": "{\n  \"type\": \"<string>\",\n  \"status\": \"<integer>\",\n  \"title\": \"<string>\",\n  \"detail\": \"<string>\"\n}",
              "createdAt": "2026-07-28T03:24:07.000Z",
              "updatedAt": "2026-07-28T03:24:07.000Z",
              "uid": "35240-a09551b6-2ad0-480a-b498-36234cf72644"
            },
            {
              "id": "486c8915-fdd5-42cd-9412-5bfab2537e1b",
              "name": "Unauthorized",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  },
                  {
                    "key": "Accept",
                    "value": "application/json"
                  },
                  {
                    "description": "Added as a part of security scheme: oauth2",
                    "key": "Authorization",
                    "value": "<token>"
                  }
                ],
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"user_id\": \"<uuid>\",\n  \"account_group_id\": \"<uuid>\",\n  \"mandate_id\": \"<uuid>\",\n  \"cash_amount\": \"<string>\",\n  \"currency\": \"CRZ\",\n  \"remittance_information\": \"<string>\"\n}",
                  "options": {
                    "raw": {
                      "headerFamily": "json",
                      "language": "json"
                    }
                  }
                },
                "url": {
                  "raw": "{{baseUrl}}/direct_debits",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "direct_debits"
                  ]
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "cookie": [],
              "responseTime": null,
              "body": "{\n  \"type\": \"<string>\",\n  \"status\": \"<integer>\",\n  \"title\": \"<string>\",\n  \"detail\": \"<string>\"\n}",
              "createdAt": "2026-07-28T03:24:07.000Z",
              "updatedAt": "2026-07-28T03:24:07.000Z",
              "uid": "35240-486c8915-fdd5-42cd-9412-5bfab2537e1b"
            }
          ],
          "createdAt": "2026-07-28T03:24:07.000Z",
          "updatedAt": "2026-07-28T03:24:07.000Z",
          "uid": "35240-e835c45c-3992-4bd2-b59d-83c5797418e3"
        },
        {
          "name": "Upvest List direct debits",
          "id": "217f1f7f-4b22-4e21-bddd-d1eb97b773c7",
          "protocolProfileBehavior": {
            "disableBodyPruning": true
          },
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/direct_debits?offset=0&limit=20",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "direct_debits"
              ],
              "query": [
                {
                  "description": "The number of items to skip for pagination.",
                  "key": "offset",
                  "value": "0"
                },
                {
                  "description": "The maximum number of items to return per page.",
                  "key": "limit",
                  "value": "20"
                }
              ]
            },
            "description": "Retrieve a list of direct debit funding requests."
          },
          "response": [
            {
              "id": "7286f17c-f17b-4892-9308-cb2f9adb063a",
              "name": "A list of direct debits",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  },
                  {
                    "description": "Added as a part of security scheme: oauth2",
                    "key": "Authorization",
                    "value": "<token>"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/direct_debits?offset=0&limit=20",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "direct_debits"
                  ],
                  "query": [
                    {
                      "description": "The number of items to skip for pagination.",
                      "key": "offset",
                      "value": "0"
                    },
                    {
                      "description": "The maximum number of items to return per page.",
                      "key": "limit",
                      "value": "20"
                    }
                  ]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "cookie": [],
              "responseTime": null,
              "body": "{\n  \"data\": [\n    {\n      \"id\": \"<uuid>\",\n      \"user_id\": \"<uuid>\",\n      \"account_group_id\": \"<uuid>\",\n      \"mandate_id\": \"<uuid>\",\n      \"cash_amount\": \"<string>\",\n      \"currency\": \"NYR\",\n      \"remittance_information\": \"<string>\",\n      \"status\": \"NEW\",\n      \"created_at\": \"<dateTime>\"\n    },\n    {\n      \"id\": \"<uuid>\",\n      \"user_id\": \"<uuid>\",\n      \"account_group_id\": \"<uuid>\",\n      \"mandate_id\": \"<uuid>\",\n      \"cash_amount\": \"<string>\",\n      \"currency\": \"MQE\",\n      \"remittance_information\": \"<string>\",\n      \"status\": \"REVERSED\",\n      \"created_at\": \"<dateTime>\"\n    }\n  ],\n  \"meta\": {\n    \"offset\": \"<integer>\",\n    \"limit\": \"<integer>\",\n    \"count\": \"<integer>\",\n    \"total\": \"<integer>\"\n  }\n}",
              "createdAt": "2026-07-28T03:24:07.000Z",
              "updatedAt": "2026-07-28T03:24:07.000Z",
              "uid": "35240-7286f17c-f17b-4892-9308-cb2f9adb063a"
            },
            {
              "id": "03f68eb8-f6e0-429d-b520-922c05bbd1f1",
              "name": "Unauthorized",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  },
                  {
                    "description": "Added as a part of security scheme: oauth2",
                    "key": "Authorization",
                    "value": "<token>"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/direct_debits?offset=0&limit=20",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "direct_debits"
                  ],
                  "query": [
                    {
                      "description": "The number of items to skip for pagination.",
                      "key": "offset",
                      "value": "0"
                    },
                    {
                      "description": "The maximum number of items to return per page.",
                      "key": "limit",
                      "value": "20"
                    }
                  ]
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "cookie": [],
              "responseTime": null,
              "body": "{\n  \"type\": \"<string>\",\n  \"status\": \"<integer>\",\n  \"title\": \"<string>\",\n  \"detail\": \"<string>\"\n}",
              "createdAt": "2026-07-28T03:24:07.000Z",
              "updatedAt": "2026-07-28T03:24:07.000Z",
              "uid": "35240-03f68eb8-f6e0-429d-b520-922c05bbd1f1"
            }
          ],
          "createdAt": "2026-07-28T03:24:07.000Z",
          "updatedAt": "2026-07-28T03:24:07.000Z",
          "uid": "35240-217f1f7f-4b22-4e21-bddd-d1eb97b773c7"
        }
      ],
      "id": "4ed1f99f-784c-4374-bcc0-4e710073a7dc",
      "createdAt": "2026-07-28T03:24:07.000Z",
      "updatedAt": "2026-07-28T03:24:07.000Z",
      "uid": "35240-4ed1f99f-784c-4374-bcc0-4e710073a7dc"
    }
  ],
  "auth": {
    "type": "oauth2",
    "oauth2": [
      {
        "key": "scope",
        "value": "users:read users:admin accounts:read accounts:admin orders:read orders:admin instruments:read portfolios:read portfolios:admin positions:read payments:read payments:admin reports:read webhooks:read webhooks:admin transactions:read fees:read fees:admin",
        "type": "string"
      },
      {
        "key": "accessTokenUrl",
        "value": "/auth/token",
        "type": "string"
      },
      {
        "key": "grant_type",
        "value": "client_credentials",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.upvest.co"
    }
  ]
}