{ "info": { "_postman_id": "e4b67479-0309-4184-96c8-63437ad77110", "name": "Upvest Investment Account Transfers Users 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:25:04.000Z", "updatedAt": "2026-07-28T03:25:04.000Z", "lastUpdatedBy": "35240", "uid": "35240-e4b67479-0309-4184-96c8-63437ad77110" }, "item": [ { "name": "users", "item": [ { "name": "{user_id}", "item": [ { "name": "Upvest Retrieve a user", "id": "8b245f4a-cb30-40f3-bcd5-7b5af10efa86", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/users/:user_id", "host": [ "{{baseUrl}}" ], "path": [ "users", ":user_id" ], "variable": [ { "id": "51239221-132c-4ebc-a573-667129714114", "key": "user_id", "value": "", "description": "(Required) The unique identifier of the user." } ] }, "description": "Retrieve details for a specific user by their unique identifier." }, "response": [ { "id": "60c567e4-d64d-4ff8-bbb5-3301cebf7299", "name": "User details", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/users/:user_id", "host": [ "{{baseUrl}}" ], "path": [ "users", ":user_id" ], "variable": [ { "key": "user_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"email\": \"\",\n \"date_of_birth\": \"\",\n \"nationality\": \"LS\",\n \"address\": {\n \"street\": \"\",\n \"city\": \"\",\n \"postal_code\": \"\",\n \"country\": \"MD\",\n \"additional_line\": \"\",\n \"state\": \"\"\n },\n \"status\": \"PENDING\",\n \"created_at\": \"\",\n \"updated_at\": \"\"\n}", "createdAt": "2026-07-28T03:25:05.000Z", "updatedAt": "2026-07-28T03:25:05.000Z", "uid": "35240-60c567e4-d64d-4ff8-bbb5-3301cebf7299" }, { "id": "717c7a37-03d7-4f44-b95d-eb21715dcf46", "name": "Unauthorized", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/users/:user_id", "host": [ "{{baseUrl}}" ], "path": [ "users", ":user_id" ], "variable": [ { "key": "user_id" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"type\": \"\",\n \"status\": \"\",\n \"title\": \"\",\n \"detail\": \"\"\n}", "createdAt": "2026-07-28T03:25:05.000Z", "updatedAt": "2026-07-28T03:25:05.000Z", "uid": "35240-717c7a37-03d7-4f44-b95d-eb21715dcf46" }, { "id": "bb23832d-5382-4107-ac62-976538edff64", "name": "User not found", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/users/:user_id", "host": [ "{{baseUrl}}" ], "path": [ "users", ":user_id" ], "variable": [ { "key": "user_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"type\": \"\",\n \"status\": \"\",\n \"title\": \"\",\n \"detail\": \"\"\n}", "createdAt": "2026-07-28T03:25:05.000Z", "updatedAt": "2026-07-28T03:25:05.000Z", "uid": "35240-bb23832d-5382-4107-ac62-976538edff64" } ], "createdAt": "2026-07-28T03:25:05.000Z", "updatedAt": "2026-07-28T03:25:05.000Z", "uid": "35240-8b245f4a-cb30-40f3-bcd5-7b5af10efa86" }, { "name": "Upvest Update a user", "id": "a11ad31e-cac0-4ce5-b6ff-9a04977d6fa9", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"email\": \"\",\n \"address\": {\n \"street\": \"\",\n \"city\": \"\",\n \"postal_code\": \"\",\n \"country\": \"UH\",\n \"additional_line\": \"\",\n \"state\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/users/:user_id", "host": [ "{{baseUrl}}" ], "path": [ "users", ":user_id" ], "variable": [ { "id": "7c7fe3e0-e5e0-44a1-8254-68edea2b1f39", "key": "user_id", "value": "", "description": "(Required) The unique identifier of the user." } ] }, "description": "Update profile information for an existing user." }, "response": [ { "id": "63780c87-e4e1-47fd-b960-2331fe8be200", "name": "User successfully updated", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"email\": \"\",\n \"address\": {\n \"street\": \"\",\n \"city\": \"\",\n \"postal_code\": \"\",\n \"country\": \"UH\",\n \"additional_line\": \"\",\n \"state\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/users/:user_id", "host": [ "{{baseUrl}}" ], "path": [ "users", ":user_id" ], "variable": [ { "key": "user_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"email\": \"\",\n \"date_of_birth\": \"\",\n \"nationality\": \"LS\",\n \"address\": {\n \"street\": \"\",\n \"city\": \"\",\n \"postal_code\": \"\",\n \"country\": \"MD\",\n \"additional_line\": \"\",\n \"state\": \"\"\n },\n \"status\": \"PENDING\",\n \"created_at\": \"\",\n \"updated_at\": \"\"\n}", "createdAt": "2026-07-28T03:25:05.000Z", "updatedAt": "2026-07-28T03:25:05.000Z", "uid": "35240-63780c87-e4e1-47fd-b960-2331fe8be200" }, { "id": "80003851-73d2-45ec-9e62-93c6d13212dc", "name": "Invalid request body", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"email\": \"\",\n \"address\": {\n \"street\": \"\",\n \"city\": \"\",\n \"postal_code\": \"\",\n \"country\": \"UH\",\n \"additional_line\": \"\",\n \"state\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/users/:user_id", "host": [ "{{baseUrl}}" ], "path": [ "users", ":user_id" ], "variable": [ { "key": "user_id" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"type\": \"\",\n \"status\": \"\",\n \"title\": \"\",\n \"detail\": \"\"\n}", "createdAt": "2026-07-28T03:25:05.000Z", "updatedAt": "2026-07-28T03:25:05.000Z", "uid": "35240-80003851-73d2-45ec-9e62-93c6d13212dc" }, { "id": "897af33f-a4d3-41f7-a378-e1cbf773d3de", "name": "Unauthorized", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"email\": \"\",\n \"address\": {\n \"street\": \"\",\n \"city\": \"\",\n \"postal_code\": \"\",\n \"country\": \"UH\",\n \"additional_line\": \"\",\n \"state\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/users/:user_id", "host": [ "{{baseUrl}}" ], "path": [ "users", ":user_id" ], "variable": [ { "key": "user_id" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"type\": \"\",\n \"status\": \"\",\n \"title\": \"\",\n \"detail\": \"\"\n}", "createdAt": "2026-07-28T03:25:05.000Z", "updatedAt": "2026-07-28T03:25:05.000Z", "uid": "35240-897af33f-a4d3-41f7-a378-e1cbf773d3de" }, { "id": "dc6e6030-2dc6-400d-a7f5-681bc3f70967", "name": "User not found", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"email\": \"\",\n \"address\": {\n \"street\": \"\",\n \"city\": \"\",\n \"postal_code\": \"\",\n \"country\": \"UH\",\n \"additional_line\": \"\",\n \"state\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/users/:user_id", "host": [ "{{baseUrl}}" ], "path": [ "users", ":user_id" ], "variable": [ { "key": "user_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"type\": \"\",\n \"status\": \"\",\n \"title\": \"\",\n \"detail\": \"\"\n}", "createdAt": "2026-07-28T03:25:05.000Z", "updatedAt": "2026-07-28T03:25:05.000Z", "uid": "35240-dc6e6030-2dc6-400d-a7f5-681bc3f70967" } ], "createdAt": "2026-07-28T03:25:05.000Z", "updatedAt": "2026-07-28T03:25:05.000Z", "uid": "35240-a11ad31e-cac0-4ce5-b6ff-9a04977d6fa9" } ], "id": "ebdd7375-a6b3-40ef-aba5-5ec61c09f6da", "createdAt": "2026-07-28T03:25:04.000Z", "updatedAt": "2026-07-28T03:25:04.000Z", "uid": "35240-ebdd7375-a6b3-40ef-aba5-5ec61c09f6da" }, { "name": "Upvest List users", "id": "6ef24bad-92e8-458c-9f69-f71721f3bb72", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/users?offset=0&limit=20", "host": [ "{{baseUrl}}" ], "path": [ "users" ], "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 paginated list of all onboarded users. Supports filtering and pagination parameters." }, "response": [ { "id": "ff9630ee-dab5-4c0b-8af3-062bf6554fce", "name": "A paginated list of users", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/users?offset=0&limit=20", "host": [ "{{baseUrl}}" ], "path": [ "users" ], "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\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"email\": \"\",\n \"date_of_birth\": \"\",\n \"nationality\": \"QJ\",\n \"address\": {\n \"street\": \"\",\n \"city\": \"\",\n \"postal_code\": \"\",\n \"country\": \"RM\",\n \"additional_line\": \"\",\n \"state\": \"\"\n },\n \"status\": \"PENDING\",\n \"created_at\": \"\",\n \"updated_at\": \"\"\n },\n {\n \"id\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"email\": \"\",\n \"date_of_birth\": \"\",\n \"nationality\": \"UY\",\n \"address\": {\n \"street\": \"\",\n \"city\": \"\",\n \"postal_code\": \"\",\n \"country\": \"KZ\",\n \"additional_line\": \"\",\n \"state\": \"\"\n },\n \"status\": \"ACTIVE\",\n \"created_at\": \"\",\n \"updated_at\": \"\"\n }\n ],\n \"meta\": {\n \"offset\": \"\",\n \"limit\": \"\",\n \"count\": \"\",\n \"total\": \"\"\n }\n}", "createdAt": "2026-07-28T03:25:05.000Z", "updatedAt": "2026-07-28T03:25:05.000Z", "uid": "35240-ff9630ee-dab5-4c0b-8af3-062bf6554fce" }, { "id": "7b70b773-ddf7-4330-88c5-2a210595fc28", "name": "Unauthorized", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/users?offset=0&limit=20", "host": [ "{{baseUrl}}" ], "path": [ "users" ], "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\": \"\",\n \"status\": \"\",\n \"title\": \"\",\n \"detail\": \"\"\n}", "createdAt": "2026-07-28T03:25:05.000Z", "updatedAt": "2026-07-28T03:25:05.000Z", "uid": "35240-7b70b773-ddf7-4330-88c5-2a210595fc28" } ], "createdAt": "2026-07-28T03:25:05.000Z", "updatedAt": "2026-07-28T03:25:05.000Z", "uid": "35240-6ef24bad-92e8-458c-9f69-f71721f3bb72" }, { "name": "Upvest Create a user", "id": "dd03aa53-bbff-47a2-9715-a2b9dbb71c8a", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"email\": \"\",\n \"date_of_birth\": \"\",\n \"nationality\": \"IS\",\n \"address\": {\n \"street\": \"\",\n \"city\": \"\",\n \"postal_code\": \"\",\n \"country\": \"GS\",\n \"additional_line\": \"\",\n \"state\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/users", "host": [ "{{baseUrl}}" ], "path": [ "users" ] }, "description": "Onboard a new user to the investment platform. The user must pass identity verification and compliance checks before trading is enabled." }, "response": [ { "id": "8f4edf78-dabf-4b4e-b966-826160ad5188", "name": "User successfully 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": "" } ], "body": { "mode": "raw", "raw": "{\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"email\": \"\",\n \"date_of_birth\": \"\",\n \"nationality\": \"IS\",\n \"address\": {\n \"street\": \"\",\n \"city\": \"\",\n \"postal_code\": \"\",\n \"country\": \"GS\",\n \"additional_line\": \"\",\n \"state\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/users", "host": [ "{{baseUrl}}" ], "path": [ "users" ] } }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"email\": \"\",\n \"date_of_birth\": \"\",\n \"nationality\": \"LS\",\n \"address\": {\n \"street\": \"\",\n \"city\": \"\",\n \"postal_code\": \"\",\n \"country\": \"MD\",\n \"additional_line\": \"\",\n \"state\": \"\"\n },\n \"status\": \"PENDING\",\n \"created_at\": \"\",\n \"updated_at\": \"\"\n}", "createdAt": "2026-07-28T03:25:05.000Z", "updatedAt": "2026-07-28T03:25:05.000Z", "uid": "35240-8f4edf78-dabf-4b4e-b966-826160ad5188" }, { "id": "203a255f-b978-4e97-b069-65aa7049a4be", "name": "Invalid request body", "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": "" } ], "body": { "mode": "raw", "raw": "{\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"email\": \"\",\n \"date_of_birth\": \"\",\n \"nationality\": \"IS\",\n \"address\": {\n \"street\": \"\",\n \"city\": \"\",\n \"postal_code\": \"\",\n \"country\": \"GS\",\n \"additional_line\": \"\",\n \"state\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/users", "host": [ "{{baseUrl}}" ], "path": [ "users" ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"type\": \"\",\n \"status\": \"\",\n \"title\": \"\",\n \"detail\": \"\"\n}", "createdAt": "2026-07-28T03:25:05.000Z", "updatedAt": "2026-07-28T03:25:05.000Z", "uid": "35240-203a255f-b978-4e97-b069-65aa7049a4be" }, { "id": "86cf6f2a-3272-4357-ab46-aceba121e90f", "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": "" } ], "body": { "mode": "raw", "raw": "{\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"email\": \"\",\n \"date_of_birth\": \"\",\n \"nationality\": \"IS\",\n \"address\": {\n \"street\": \"\",\n \"city\": \"\",\n \"postal_code\": \"\",\n \"country\": \"GS\",\n \"additional_line\": \"\",\n \"state\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/users", "host": [ "{{baseUrl}}" ], "path": [ "users" ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"type\": \"\",\n \"status\": \"\",\n \"title\": \"\",\n \"detail\": \"\"\n}", "createdAt": "2026-07-28T03:25:05.000Z", "updatedAt": "2026-07-28T03:25:05.000Z", "uid": "35240-86cf6f2a-3272-4357-ab46-aceba121e90f" } ], "createdAt": "2026-07-28T03:25:05.000Z", "updatedAt": "2026-07-28T03:25:05.000Z", "uid": "35240-dd03aa53-bbff-47a2-9715-a2b9dbb71c8a" } ], "id": "abb6c0bf-f0a5-45ce-af85-97d8292a4502", "createdAt": "2026-07-28T03:25:04.000Z", "updatedAt": "2026-07-28T03:25:04.000Z", "uid": "35240-abb6c0bf-f0a5-45ce-af85-97d8292a4502" } ], "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" } ] }