{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"3c6058c3-97c9-4d06-905e-642f0ece8387","name":"API Reference","description":"Financial Cents OAuth Documentations\n\nObtain a client ID and client secret. Contact us to generate one for you if you don’t have one already.  \nRedirect your users to /oauth/authorize using the following query parameters\n\n``` javascript\nconst url = \"https://app.financial-cents.com/oauth/authorize\";\nconst params = {\n  'client_id': 'YOUR_CLIENT_ID',\n  'redirect_uri' => 'http://third-party-app.com/callback', // This URI should provided by you when you request an OAuth client.\n  'response_type' => 'code',\n  'scope' => '',\n  'state' => 'RANDOM_STRING', // A random string that will be included in the request when the user is returned to your app\n  // 'prompt': 'none', 'consent' or 'login'\n}\n// The final URL would look similar to https://app.financial-cents.com/oauth/authorize?client_id=ID&redirect_uri=URI&response_type=code&scope=&state=STATE&prompt=consent\n\n ```\n\nOnce the user approves the request, they will be redirected back to your app with authorization code in addition to the state string that you included in the request\n\n[https://REDIRECT_URI/?code=AUTHORIZATION_CODE&state=YOUR_STATE](https://REDIRECT_URI/?code=AUTHORIZATION_CODE&state=YOUR_STATE)\n\nVerify that the state matches the one you shared to verify that the request had come from your application\n\nExtract the authorization “code” and use it to generate an authorization token by sending the code along with your client ID and secret to /oauth/token\n\n``` javascript\n// Send a POST request to\nlet url = \"https://app.financial-cents.com/oauth/token?\"\n          + \"grant_type=authorization_code\"\n          + \"client_id=YOUR_CLIENT_ID\"\n          + \"client_secret=YOUR_CLIENT_SECRET\"\n          + \"redirect_uri=YOUR_REDIRECT_URL\"\n          + \"code=AUTHORIZATION_CODE\"\n\n ```\n\nWhen successful, you will receive an access code that you can use for all subsequent requests\n\n``` javascript\n{\n  'access_token': string,\n  'refresh_token': string,\n  'expires_in': number // number of seconds until the access token expires\n}\n\n ```\n\nUtilize the access token in subsequent requests by adding it into the header of each request as “Authorization: Bearer ACCESS_TOKEN”\n\nTo refresh a token send a POST request to /oauth/token with the following query parameters\n\n``` javascript\n{\n   'grant_type': 'refresh_token',\n   'refresh_token': 'the-refresh-token',\n   'client_id': 'client-id',\n   'client_secret': 'client-secret',\n   'scope': '',\n}\n\n ```\n\nThe response would contain the new access token\n\n``` javascript\n{\n  'access_token': string,\n  'refresh_token': string,\n  'expires_in': number // number of seconds until the access token expires\n}\n\n ```","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"17010261","team":2325185,"collectionId":"3c6058c3-97c9-4d06-905e-642f0ece8387","publishedId":"2s9Y5bQ1UV","public":true,"publicUrl":"https://documenter-api.postman.tech/view/17010261/2s9Y5bQ1UV","privateUrl":"https://go.postman.co/documentation/17010261-3c6058c3-97c9-4d06-905e-642f0ece8387","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":""},{"name":"title","value":""}],"appearance":{"default":"light","themes":[{"name":"dark","logo":null,"colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"FF6C37"}},{"name":"light","logo":null,"colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"}}]}},"version":"8.11.6","publishDate":"2023-10-27T11:50:41.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":""},"logos":{"logoLight":null,"logoDark":null}},"statusCode":200},"environments":[{"name":"Production","id":"f55aad22-e9ef-4298-a1cd-f58070908f06","owner":"17010261","values":[{"key":"base_url","value":"https://app.financial-cents.com/api/v1","enabled":true,"type":"default"},{"key":"access_token","value":"eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiIyIiwianRpIjoiMjQxNWNiYjNlNjgzYzdkMzRhZmM1ZjM2NDYxZjFlMGM5ZWM2YjI3ODIzMGMzNGVmYWY4ZDM1ZWM1ZTE4ZDA2Mzc0Y2E3MzBkYWQ2NmNhMjIiLCJpYXQiOjE2OTM0MDY0NTIuMjg2NDk3LCJuYmYiOjE2OTM0MDY0NTIuMjg2NDk5LCJleHAiOjE3MDkzMDQwNTIuMjc3MDA5LCJzdWIiOiIxIiwic2NvcGVzIjpbXX0.Aeq1-V9swgozsoqEHNM9TtcxOfD2e8ZhlQ-exR4XWkOMd9tchBAmBBBo7D5RjRFGaynjZmTA6OVDwuVqxEcRPC6UqYnjXDuYf_lCLVzDEpYZG8IwNsIfgWTAzNuaEv8ygo7HHEX-CBFhoJ6lmn8Lh4kCvruGYJv-nhSXRtkejb3ppey3iCuE9Uom7iEG3ep5MbcPANp-HcCLKqRlH0SQdgh0y8Hs3SXtWRsRullZHRoUQ2VMv1hWZ9b6cAqztlrpqPVvh-jBWY93tL_3yw0ssf8XLEnEJ5_RIvFNk0L7490osDI801pdtTYgZXt4iY50_F4UU_lnyv6sOsKBXX7P4tC7V7l0cc1sSmc1_g-oQBRG0AbeubqJk8Ym1AyRv12EIZsJmDrosEpeeiT1VkX6aSNF_y5rQO3rv9BWcTKJDW5FdRtjmjv-MjoGcJIXpORuNk1fjq_nQ1py9Vr3b45QfmaIVccVzaxd81ngTNk1XYGzFg0jdNlWE7seTXqf5Pc5EpY322tnXLwjgj4iG3DD8_GblQmIyLJ1AMxgSo_sJWBHZaukLoOFtIf5lW2-kSC3pi2Cxx_7e3yb6fmGtph9trD2V6OixjVbP8hUAQwD8izkyBnTKQ4TCWtjTvfFejHqAdZ65r7pkNofx1sAMseN5zGeuWusOdh_KOMIXT-Eero","enabled":true,"type":"secret"},{"key":"client_id","value":"7956","enabled":true},{"key":"contact_id","value":"2934","enabled":true},{"key":"user_id","value":"1","enabled":true,"type":"default"},{"key":"template_id","value":"6328","enabled":true,"type":"default"},{"key":"project_id","value":"8017","enabled":true,"type":"default"}],"published":true}],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/411298786bdb168830d3b9276ea0e5f96c6921d576c586fbb73335c46f59d779","favicon":""},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"},{"label":"Production","value":"17010261-f55aad22-e9ef-4298-a1cd-f58070908f06"}],"canonicalUrl":"https://documenter.gw.postman.com/view/metadata/2s9Y5bQ1UV"}