\n\nPrototyping your API in Postman streamlines the development process by enabling you to design and test front- and back-end API-driven functionalities within a shared workspace.
\n
This collection serves as a place for teams from the Intergalactic Bank to collaborate on the design of the soon-to-be-developed Intergalactic Bank API. This prototype collection outlines how the service's requests and responses should function. Stakeholders should provide their thoughts and suggestions before we begin development.
\n![](\"https://lh7-us.googleusercontent.com/eNxPYjGNGALmKSzZvdhlMuy_XK3C_iQ3rK7tCDiPvr6nePMyggp9NTIAjcZYs7oIy8PU_NCGFKtcBPRZrfplfPyrKsO5SCMRX6OuBpzsL_HuOHxW2DwA3FH2-o0uFJgAZOr7JaQTiIvkayUSrPdsxQQ\")
\n\nThis collection is meant to be used alongside a Postman Mock Server. Since we are still in the planning phase of the API, we have included several example responses for each request, laying out how we think each possible response will look. Including these example responses also has the added benefit of powering a mock server. By following the instructions, you can set up your own mock server and simulate the behavior of this API by returning the predefined data.
\nTo set up a mock server:
\nSelect Mock collection from the collection's actions menu.
\nOn the Create a mock server page, add a name for your mock server, and select to Save the mock server URL as a new environment variable. This will create a new environment with the mock’s URL pre-populated.
\nSelect the New Environment from the Environment dropdown list.
\nComplete the process by clicking Create Mock Server.
\nSend the request! You should now see that the {{url}} variable is using the mock server you set up previously.
Try editing fields in the mocked responses to see your changes reflected in the mock server.
\nEach request in the collection includes tests to check the response structure. These tests check that all of the properties that other systems rely on are present and of the expected data type. Once you have the fully built-out service in place, you can swap the mock server URL for the live URL and test that your implementation follows the same guidelines as your prototype. This gives you confidence that you can start integrating this service into your systems.
\nIf you are adding a new proposed endpoint for this request, try asking Postbot to generate tests for it.
\nThe Bank Services team wants your team’s input on our API design. Add an inline comment to this collection with your ideas, questions, and suggestions, or reach out to us on our internal Slack by tagging @bank-services.
Api aciklamasi burada olacak
\n","urlObject":{"path":["api","v1","accounts"],"host":["okulyo","com"],"query":[{"disabled":true,"description":{"content":"(Optional) filter by full name of the account owner
\n","type":"text/plain"},"key":"owner","value":"Nova Newman"},{"key":"createdAt","value":"2023-04-10"}],"variable":[]}},"response":[{"id":"40aae1da-8d52-4891-9c07-986e4ef61c5f","name":"Successful Response (filter by date)","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{url}}/api/v1/accounts?createdAt=2023-04-10","host":["{{url}}"],"path":["api","v1","accounts"],"query":[{"key":"owner","value":"Nova Newman","disabled":true},{"key":"createdAt","value":"2023-04-10"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","name":"Content-Type","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"accounts\": [\n {\n \"id\": \"1\",\n \"owner\": \"Nova Newman\",\n \"createdAt\": \"2024-01-10T14:54:29.739Z\",\n \"balance\": 10000,\n \"currency\" : \"COSMIC_COINS\"\n },\n {\n \"id\": \"2\",\n \"owner\": \"Gary Galaxy\",\n \"createdAt\": \"2024-01-10T14:54:29.739Z\",\n \"balance\": 237,\n \"currency\" : \"COSMIC_COINS\"\n }\n ]\n}"},{"id":"18102fa1-8277-47fc-a29e-91a37a41dbfc","name":"Successful Response (filter by owner)","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{url}}/api/v1/accounts?owner=Nova Newman","host":["{{url}}"],"path":["api","v1","accounts"],"query":[{"key":"owner","value":"Nova Newman"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","name":"Content-Type","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"accounts\": [\n {\n \"id\": \"1\",\n \"owner\": \"Nova Newman\",\n \"createdAt\": \"2023-04-10\",\n \"balance\": 10000,\n \"currency\" : \"COSMIC_COINS\"\n }\n ]\n}"},{"id":"f414222f-ecee-4853-92c2-c69ea279d1dc","name":"No matching accounts found","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{url}}/api/v1/accounts?owner=Norman Nobody&createdAt=2023-04-10","host":["{{url}}"],"path":["api","v1","accounts"],"query":[{"key":"owner","value":"Norman Nobody"},{"key":"createdAt","value":"2023-04-10"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","name":"Content-Type","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"accounts\": []\n}"},{"id":"1ba9176a-d73f-4147-bf76-3401bf0ba394","name":"Forbidden","originalRequest":{"method":"GET","header":[],"url":"{{url}}/api/v1/accounts"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sat, 17 Feb 2024 13:21:35 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"95"},{"key":"Connection","value":"keep-alive"},{"key":"uWebSockets","value":"20"}],"cookie":[],"responseTime":null,"body":"{\n \"name\": \"invalidAuth\",\n \"message\": \"Please provide a valid API key in the header of the request.\"\n}"}],"_postman_id":"dfff44e3-8ac4-491f-b347-4a6165dfcc7a"},{"name":"List Accounts","event":[{"listen":"test","script":{"type":"text/javascript","exec":["// Test to check the structure of the successful response","pm.test(\"Response body structure is valid\", function () {"," var responseJSON = pm.response.json();"," pm.expect(responseJSON).to.have.property('accounts').that.is.an('array');"," if (responseJSON.accounts.length > 0) {"," responseJSON.accounts.forEach(function(account) {"," pm.expect(account).to.have.property('id');"," pm.expect(account).to.have.property('owner');"," pm.expect(account).to.have.property('createdAt');"," pm.expect(account).to.have.property('balance');"," pm.expect(account).to.have.property('currency');"," });"," }","});"]}}],"id":"9ce012a7-30ef-4691-9454-f868dfedc6cd","request":{"method":"GET","header":[],"url":"{{url}}/api/v1/accounts?createdAt=2023-04-10","description":"This endpoint will list all accounts that exist at the Intergalactic Bank. Optionally, filter by owner (using a full name), or the createdAt date (using YYYY-MM-DD format).
(Optional) filter by full name of the account owner
\n","type":"text/plain"},"key":"owner","value":"Nova Newman"},{"description":{"content":"(Optional) filter for accounts created on or after date (YYYY-MM-DD)
\n","type":"text/plain"},"key":"createdAt","value":"2023-04-10"}],"variable":[]}},"response":[{"id":"f43007d3-c6ba-4855-91d6-36b22cfa218f","name":"Successful Response (filter by date)","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{url}}/api/v1/accounts?createdAt=2023-04-10","host":["{{url}}"],"path":["api","v1","accounts"],"query":[{"key":"owner","value":"Nova Newman","disabled":true},{"key":"createdAt","value":"2023-04-10"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","name":"Content-Type","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"accounts\": [\n {\n \"id\": \"1\",\n \"owner\": \"Nova Newman\",\n \"createdAt\": \"2024-01-10T14:54:29.739Z\",\n \"balance\": 10000,\n \"currency\" : \"COSMIC_COINS\"\n },\n {\n \"id\": \"2\",\n \"owner\": \"Gary Galaxy\",\n \"createdAt\": \"2024-01-10T14:54:29.739Z\",\n \"balance\": 237,\n \"currency\" : \"COSMIC_COINS\"\n }\n ]\n}"},{"id":"ca48e7c1-39c5-4d04-9611-79fc60e9b3c4","name":"Successful Response (filter by owner)","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{url}}/api/v1/accounts?owner=Nova Newman","host":["{{url}}"],"path":["api","v1","accounts"],"query":[{"key":"owner","value":"Nova Newman"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","name":"Content-Type","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"accounts\": [\n {\n \"id\": \"1\",\n \"owner\": \"Nova Newman\",\n \"createdAt\": \"2023-04-10\",\n \"balance\": 10000,\n \"currency\" : \"COSMIC_COINS\"\n }\n ]\n}"},{"id":"fcc15d48-5865-44db-a797-2f895a31315c","name":"No matching accounts found","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{url}}/api/v1/accounts?owner=Norman Nobody&createdAt=2023-04-10","host":["{{url}}"],"path":["api","v1","accounts"],"query":[{"key":"owner","value":"Norman Nobody"},{"key":"createdAt","value":"2023-04-10"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","name":"Content-Type","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"accounts\": []\n}"},{"id":"65d15daa-894f-4594-92aa-de31ff34a2eb","name":"Forbidden","originalRequest":{"method":"GET","header":[],"url":"{{url}}/api/v1/accounts"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sat, 17 Feb 2024 13:21:35 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"95"},{"key":"Connection","value":"keep-alive"},{"key":"uWebSockets","value":"20"}],"cookie":[],"responseTime":null,"body":"{\n \"name\": \"invalidAuth\",\n \"message\": \"Please provide a valid API key in the header of the request.\"\n}"}],"_postman_id":"9ce012a7-30ef-4691-9454-f868dfedc6cd"},{"name":"Get Account","event":[{"listen":"test","script":{"type":"text/javascript","exec":["// Test the response body structure and values","pm.test(\"Response body structure is valid\", function () {"," var responseJSON = pm.response.json();"," pm.expect(responseJSON).to.have.property('account').that.is.an('object');"," pm.expect(responseJSON.account).to.have.property('id').that.is.a('number');"," pm.expect(responseJSON.account).to.have.property('owner').that.is.a('string');"," pm.expect(responseJSON.account).to.have.property('balance').that.is.a('number');"," pm.expect(responseJSON.account).to.have.property('currency').that.is.a('string');","});"]}}],"id":"3e71b79c-c528-4362-a4f5-6ff183b1fe6d","request":{"method":"GET","header":[],"url":"{{url}}/api/v1/accounts/:id","description":"This endpoint will retrieve information about an account by passing the account id as a path parameter.
(Required) ID of account
\n","type":"text/plain"},"type":"any","value":"17","key":"id"}]}},"response":[{"id":"6da4fe38-80d7-4492-9b68-ebe702a7945c","name":"Succesful Response","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{url}}/api/v1/accounts/:id","host":["{{url}}"],"path":["api","v1","accounts",":id"],"variable":[{"key":"id","value":"26","description":"(Required) ID of account"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sat, 17 Feb 2024 14:46:30 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"84"},{"key":"Connection","value":"keep-alive"},{"key":"uWebSockets","value":"20"}],"cookie":[],"responseTime":null,"body":"{\n \"account\": {\n \"id\": 26,\n \"owner\": \"Nova Newman\",\n \"balance\": 5100,\n \"currency\": \"COSMIC_COINS\"\n }\n}"},{"id":"4332c01c-808b-427a-a7c0-bb7aa318b130","name":"Not found","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{url}}/api/v1/accounts/:id","host":["{{url}}"],"path":["api","v1","accounts",":id"],"variable":[{"key":"id","value":"999"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sat, 17 Feb 2024 13:18:51 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"63"},{"key":"Connection","value":"keep-alive"},{"key":"uWebSockets","value":"20"}],"cookie":[],"responseTime":null,"body":"{\n \"name\": \"instanceNotFound\",\n \"message\": \"Account does not exist.\"\n}"},{"id":"4a8502bb-96f2-458f-a33e-c25a8f786621","name":"Forbidden","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{url}}/api/v1/accounts/:id","host":["{{url}}"],"path":["api","v1","accounts",":id"],"variable":[{"key":"id","value":"22"}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sat, 17 Feb 2024 13:21:35 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"95"},{"key":"Connection","value":"keep-alive"},{"key":"uWebSockets","value":"20"}],"cookie":[],"responseTime":null,"body":"{\n \"name\": \"invalidAuth\",\n \"message\": \"Please provide a valid API key in the header of the request.\"\n}"}],"_postman_id":"3e71b79c-c528-4362-a4f5-6ff183b1fe6d"},{"name":"Update Account","event":[{"listen":"test","script":{"type":"text/javascript","exec":["// Test to check the structure of the successful response","pm.test(\"Successful response has the correct structure\", function () {"," var responseData = pm.response.json();",""," // Check if the response contains the account object"," pm.expect(responseData).to.have.property('account');"," pm.expect(responseData.account).to.be.an('object');",""," // Check the properties of the account object"," pm.expect(responseData.account).to.have.property('id');"," pm.expect(responseData.account).to.have.property('owner');"," pm.expect(responseData.account).to.have.property('balance');"," pm.expect(responseData.account).to.have.property('currency');"," pm.expect(responseData.account).to.have.property('createdAt');","});"]}}],"id":"20b5f762-5c6e-4a93-8f94-afc81c530dcc","request":{"method":"PATCH","header":[],"body":{"mode":"raw","raw":"{\n \"owner\": \"Paul Stars\",\n \t\"balance\" : 57000,\n \"currency\" : \"COSMIC_COINS\"\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/api/v1/accounts/:id","description":"This endpoint will update information about an account by passing the accountId as a path parameter and additional information through the Request Body.
Only Bank Admins have permission to update an account. You may encounter a 403 Forbidden Error if you try to update an account without the correct permissions.
This endpoint will delete an account by passing in the account id as a path parameter.
Once an account is deleted, it cannot be restored, so please use this endpoint with caution.
\nAdditionally, only bank admins have permission to update an account. You may encounter a 403 Forbidden error if you try to update an account without the correct permissions.
This endpoint will create a new account at the Intergalactic Bank.
\nAn Account at the Intergalactic Bank allows you to store funds. Account endpoints return information about accounts and account holders at the Intergalactic Bank. They should not return information about transactions. Instead, all transaction information should be accessed by requests in the Transactions folder.
This endpoint will retrieve transactions for a given account, optionally filtering on the date created (createdAt) and the account receiving the transaction (toAccountId).
(Optional) filter for transactions created on or after date (YYYY-MM-DD)
\n","type":"text/plain"},"key":"createdAt","value":"2024-01-10"},{"disabled":true,"description":{"content":"(Optional) filter for the account that initiated the transaction
\n","type":"text/plain"},"key":"toAccountID","value":"19"},{"disabled":true,"description":{"content":"(Optional) filter for the account that received the transaction
\n","type":"text/plain"},"key":"fromAccountID","value":"17"}],"variable":[]}},"response":[{"id":"050a80d3-6bbb-469c-a9fa-70de2d52b4cf","name":"Successful Response","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{url}}/api/v1/transactions","host":["{{url}}"],"path":["api","v1","transactions"],"query":[{"key":"createdAt","value":"2024-01-10","description":"(Optional) filter for transactions created on or after date (YYYY-MM-DD)","disabled":true},{"key":"toAccountId","value":"19","description":"(Optional) filter for the account that initiated the transaction","disabled":true},{"key":"fromAccountId","value":"17","description":"(Optional) filter for the account that received the transaction","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sat, 17 Feb 2024 13:47:41 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"759"},{"key":"Connection","value":"keep-alive"},{"key":"uWebSockets","value":"20"}],"cookie":[],"responseTime":null,"body":"{\n \"transactions\": [\n {\n \"id\": 9,\n \"createdAt\": \"2024-02-17T13:41:26.000Z\",\n \"fromAccountId\": 17,\n \"toAccountId\": 19,\n \"currency\": \"COSMIC_COINS\",\n \"amount\": 1000\n },\n {\n \"id\": 8,\n \"createdAt\": \"2024-02-17T13:39:10.000Z\",\n \"fromAccountId\": 17,\n \"toAccountId\": 19,\n \"currency\": \"COSMIC_COINS\",\n \"amount\": 1000\n },\n {\n \"id\": 7,\n \"createdAt\": \"2024-02-17T13:12:40.000Z\",\n \"fromAccountId\": 22,\n \"toAccountId\": 23,\n \"currency\": \"COSMIC_COINS\",\n \"amount\": 250\n },\n {\n \"id\": 6,\n \"createdAt\": \"2024-02-17T13:12:10.000Z\",\n \"fromAccountId\": 18,\n \"toAccountId\": 19,\n \"currency\": \"COSMIC_COINS\",\n \"amount\": 250\n },\n {\n \"id\": 4,\n \"createdAt\": \"2024-02-16T22:30:32.000Z\",\n \"fromAccountId\": 17,\n \"toAccountId\": 19,\n \"currency\": \"COSMIC_COINS\",\n \"amount\": 1000\n },\n {\n \"id\": 3,\n \"createdAt\": \"2024-02-16T22:22:22.000Z\",\n \"fromAccountId\": 18,\n \"toAccountId\": 19,\n \"currency\": \"COSMIC_COINS\",\n \"amount\": 250\n }\n ]\n}"},{"id":"899076ce-2ba1-4965-8e19-6fcdb5198114","name":"No matching transactions found","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{url}}/api/v1/transactions?createdAt=2024-01-10&toAccountID=18974440&fromAccountId=9999999","host":["{{url}}"],"path":["api","v1","transactions"],"query":[{"key":"createdAt","value":"2024-01-10","description":"(Optional) filter for transactions created on or after date (YYYY-MM-DD)"},{"key":"toAccountID","value":"18974440","description":"(Optional) filter for the account that initiated the transaction"},{"key":"fromAccountId","value":"9999999","description":"(Optional) filter for the account that initiated the transaction"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","name":"Content-Type","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"transactions\": []\n}"},{"id":"3d4824be-82e2-4cc2-8b61-2bea063af66c","name":"Forbidden","originalRequest":{"method":"GET","header":[],"url":"{{url}}/api/v1/transactions"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sat, 17 Feb 2024 13:21:35 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"95"},{"key":"Connection","value":"keep-alive"},{"key":"uWebSockets","value":"20"}],"cookie":[],"responseTime":null,"body":"{\n \"name\": \"invalidAuth\",\n \"message\": \"Please provide a valid API key in the header of the request.\"\n}"}],"_postman_id":"aafb05db-d672-4979-87a9-846676c1b09c"},{"name":"List Transactions Copy","event":[{"listen":"test","script":{"type":"text/javascript","exec":["var responseData = pm.response.json();","","// Test to check if the response is an object with a transactions property","pm.test(\"Response is an object with transactions property\", function () {"," pm.expect(responseData).to.be.an('object').that.has.property('transactions');","});","","// Test to check the structure and data types of the transactions array","pm.test(\"Transactions array structure and data types are valid\", function () {"," responseData.transactions.forEach(function(transaction) {"," pm.expect(transaction).to.be.an('object').that.has.property('id').to.be.a('number');"," pm.expect(transaction).to.have.property('createdAt').to.be.a('string');"," pm.expect(transaction).to.have.property('fromAccountId').to.be.a('number');"," pm.expect(transaction).to.have.property('toAccountId').to.be.a('number');"," pm.expect(transaction).to.have.property('currency').to.be.a('string');"," pm.expect(transaction).to.have.property('amount').to.be.a('number');"," });","});"]}}],"id":"b75ab041-7b9a-4908-bafc-1a9a6dc364ed","request":{"method":"GET","header":[],"url":"{{url}}/api/v1/transactions","description":"This endpoint will retrieve transactions for a given account, optionally filtering on the date created (createdAt) and the account receiving the transaction (toAccountId).
(Optional) filter for transactions created on or after date (YYYY-MM-DD)
\n","type":"text/plain"},"key":"createdAt","value":"2024-01-10"},{"disabled":true,"description":{"content":"(Optional) filter for the account that initiated the transaction
\n","type":"text/plain"},"key":"toAccountID","value":"19"},{"disabled":true,"description":{"content":"(Optional) filter for the account that received the transaction
\n","type":"text/plain"},"key":"fromAccountID","value":"17"}],"variable":[]}},"response":[{"id":"811232e0-5e09-414d-8cf4-c38afdfd6088","name":"Successful Response","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{url}}/api/v1/transactions","host":["{{url}}"],"path":["api","v1","transactions"],"query":[{"key":"createdAt","value":"2024-01-10","description":"(Optional) filter for transactions created on or after date (YYYY-MM-DD)","disabled":true},{"key":"toAccountId","value":"19","description":"(Optional) filter for the account that initiated the transaction","disabled":true},{"key":"fromAccountId","value":"17","description":"(Optional) filter for the account that received the transaction","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sat, 17 Feb 2024 13:47:41 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"759"},{"key":"Connection","value":"keep-alive"},{"key":"uWebSockets","value":"20"}],"cookie":[],"responseTime":null,"body":"{\n \"transactions\": [\n {\n \"id\": 9,\n \"createdAt\": \"2024-02-17T13:41:26.000Z\",\n \"fromAccountId\": 17,\n \"toAccountId\": 19,\n \"currency\": \"COSMIC_COINS\",\n \"amount\": 1000\n },\n {\n \"id\": 8,\n \"createdAt\": \"2024-02-17T13:39:10.000Z\",\n \"fromAccountId\": 17,\n \"toAccountId\": 19,\n \"currency\": \"COSMIC_COINS\",\n \"amount\": 1000\n },\n {\n \"id\": 7,\n \"createdAt\": \"2024-02-17T13:12:40.000Z\",\n \"fromAccountId\": 22,\n \"toAccountId\": 23,\n \"currency\": \"COSMIC_COINS\",\n \"amount\": 250\n },\n {\n \"id\": 6,\n \"createdAt\": \"2024-02-17T13:12:10.000Z\",\n \"fromAccountId\": 18,\n \"toAccountId\": 19,\n \"currency\": \"COSMIC_COINS\",\n \"amount\": 250\n },\n {\n \"id\": 4,\n \"createdAt\": \"2024-02-16T22:30:32.000Z\",\n \"fromAccountId\": 17,\n \"toAccountId\": 19,\n \"currency\": \"COSMIC_COINS\",\n \"amount\": 1000\n },\n {\n \"id\": 3,\n \"createdAt\": \"2024-02-16T22:22:22.000Z\",\n \"fromAccountId\": 18,\n \"toAccountId\": 19,\n \"currency\": \"COSMIC_COINS\",\n \"amount\": 250\n }\n ]\n}"},{"id":"782c5123-796b-45b3-8a44-0edeedfc8744","name":"No matching transactions found","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{url}}/api/v1/transactions?createdAt=2024-01-10&toAccountID=18974440&fromAccountId=9999999","host":["{{url}}"],"path":["api","v1","transactions"],"query":[{"key":"createdAt","value":"2024-01-10","description":"(Optional) filter for transactions created on or after date (YYYY-MM-DD)"},{"key":"toAccountID","value":"18974440","description":"(Optional) filter for the account that initiated the transaction"},{"key":"fromAccountId","value":"9999999","description":"(Optional) filter for the account that initiated the transaction"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","name":"Content-Type","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"transactions\": []\n}"},{"id":"010d2928-9905-4419-97fd-5fb17b95b485","name":"Forbidden","originalRequest":{"method":"GET","header":[],"url":"{{url}}/api/v1/transactions"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sat, 17 Feb 2024 13:21:35 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"95"},{"key":"Connection","value":"keep-alive"},{"key":"uWebSockets","value":"20"}],"cookie":[],"responseTime":null,"body":"{\n \"name\": \"invalidAuth\",\n \"message\": \"Please provide a valid API key in the header of the request.\"\n}"}],"_postman_id":"b75ab041-7b9a-4908-bafc-1a9a6dc364ed"},{"name":"Get a transaction","event":[{"listen":"test","script":{"type":"text/javascript","exec":["// Test the response body structure and values","pm.test(\"Response body structure is valid\", function () {"," var responseJSON = pm.response.json();"," pm.expect(responseJSON).has.property('transaction');"," pm.expect(responseJSON.transaction).to.be.an('object').that.has.all.keys('id', 'createdAt', 'fromAccountId', 'toAccountId', 'currency', 'amount');","});"]}}],"id":"628d5add-cbcc-4d0a-9d0b-ce94865d2dad","request":{"method":"GET","header":[],"url":"{{url}}/api/v1/transactions/:id","description":"This endpoint will retrieve details of a specific transaction by providing the transaction ID as a path parameter.
\n","urlObject":{"path":["api","v1","transactions",":id"],"host":["{{url}}"],"query":[],"variable":[{"id":"9d045cd9-4b05-4747-8f9f-b35fb14f67a1","description":{"content":"(Required) ID of transaction
\n","type":"text/plain"},"type":"any","value":"4","key":"id"}]}},"response":[{"id":"c48fbc40-ac12-4a4c-9936-e3f5cd767c28","name":"Successful Response","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{url}}/api/v1/transactions/:id","host":["{{url}}"],"path":["api","v1","transactions",":id"],"variable":[{"key":"id","value":"4","description":"(Required) transaction ID"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sat, 17 Feb 2024 13:48:21 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"139"},{"key":"Connection","value":"keep-alive"},{"key":"uWebSockets","value":"20"}],"cookie":[],"responseTime":null,"body":"{\n \"transaction\": {\n \"id\": 4,\n \"createdAt\": \"2024-02-16T22:30:32.000Z\",\n \"fromAccountId\": 17,\n \"toAccountId\": 19,\n \"currency\": \"COSMIC_COINS\",\n \"amount\": 1000\n }\n}"},{"id":"e8d32753-70a6-4518-8976-bbf5cad1cde8","name":"Not found","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{url}}/api/v1/transactions/:id","host":["{{url}}"],"path":["api","v1","transactions",":id"],"variable":[{"key":"id","value":"999","description":"(Required) transaction id"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sat, 17 Feb 2024 13:33:28 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"67"},{"key":"Connection","value":"keep-alive"},{"key":"uWebSockets","value":"20"}],"cookie":[],"responseTime":null,"body":"{\n \"name\": \"instanceNotFound\",\n \"message\": \"Transaction does not exist.\"\n}"},{"id":"92996c33-7e90-448f-ae5a-36a378b59ffb","name":"Forbidden","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{url}}/api/v1/transactions/:id","host":["{{url}}"],"path":["api","v1","transactions",":id"],"variable":[{"key":"id","value":"999"}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sat, 17 Feb 2024 13:21:35 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"95"},{"key":"Connection","value":"keep-alive"},{"key":"uWebSockets","value":"20"}],"cookie":[],"responseTime":null,"body":"{\n \"name\": \"invalidAuth\",\n \"message\": \"Please provide a valid API key in the header of the request.\"\n}"}],"_postman_id":"628d5add-cbcc-4d0a-9d0b-ce94865d2dad"},{"name":"Create New Transaction","event":[{"listen":"test","script":{"type":"text/javascript","exec":["var responseJSON = pm.response.json();","","// Test the response body structure and values","pm.test(\"Response body structure is valid\", function () {"," pm.expect(responseJSON).to.be.an('object').that.has.property('success', true);"," pm.expect(responseJSON).to.have.property('transaction').that.is.an('object').and.has.property('id');","});"]}}],"id":"d5fdadd7-9444-4935-bd7b-fd519bda4899","request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"fromAccountId\" : 28,\n \"toAccountId\" : 27,\n \"amount\" : 1000,\n \"currency\" : \"COSMIC_COINS\"\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/api/v1/transactions","description":"This endpoint will create a new transaction. Funds will be transferred between accounts by providing two account IDs in the fromAccountId and toAccountId fields.
Transactions cannot be edited once created, so use this endpoint with caution.
\n","urlObject":{"path":["api","v1","transactions"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"999dcba2-681b-4e22-88a8-592555a11b96","name":"Successful Response","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"fromAccountId\" : 28,\n \"toAccountId\" : 27,\n \"amount\" : 1000,\n \"currency\" : \"COSMIC_COINS\"\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/api/v1/transactions"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","name":"Content-Type","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"transaction\": {\n \"id\": 8\n }\n}"},{"id":"5191a3c1-6356-4667-ad19-148ade8b6afe","name":"Insufficient funds","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"fromAccountId\" : 17,\n \"toAccountId\" : 19,\n \"amount\" : 1000000000000000000000,\n \"currency\" : \"COSMIC_COINS\"\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/api/v1/transactions"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sat, 17 Feb 2024 13:16:53 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"101"},{"key":"Connection","value":"keep-alive"},{"key":"uWebSockets","value":"20"}],"cookie":[],"responseTime":null,"body":"{\n \"name\": \"invalidBody\",\n \"message\": \"Insufficient balance in fromAccountId to initiate the transaction.\"\n}"},{"id":"675f5a09-3512-4ddc-aedf-eb730f0bb4be","name":"Forbidden","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"fromAccountId\" : 1,\n \"toAccountId\" : 2,\n \"amount\" : 1000,\n \"currency\" : \"COSMIC_COINS\"\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/api/v1/transactions"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","name":"Content-Type","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"name\": \"invalidAuth\",\n \"message\": \"Please provide a valid API key in the header of the request.\"\n}"}],"_postman_id":"d5fdadd7-9444-4935-bd7b-fd519bda4899"}],"id":"c36e8114-bdbf-403e-b1c1-f601ef58e053","description":"A transaction records money moving in or out of an account. Transactions at the Intergalactic Bank should follow a blockchain-like approach. Once created, they cannot be updated or deleted, so we will have only endpoints to get or create transactions.
\n","_postman_id":"c36e8114-bdbf-403e-b1c1-f601ef58e053"}],"event":[{"listen":"prerequest","script":{"type":"text/javascript","exec":[""]}},{"listen":"test","script":{"type":"text/javascript","exec":[""]}}]}