{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-dataStudio/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["partial"]},"type":"markdown"},"seo":{"title":"Developer Documentation"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"__idx":0,"id":"quick-start"},"children":["Quick Start"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All API calls require a Bearer token in the request header."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Token validity: 1 hour"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Testing: reauthenticate when required"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Production: implement a refresh token mechanism"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"__idx":1,"id":"step-1-download-the-api-definition"},"children":["Step 1: Download the API Definition"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Open the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://doc.creditsafe.com/connect-catalog","target":"_blank","rel":"noopener noreferrer"},"children":["API catalog"]},", select your product, and go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API Documentation"]},". Download the OpenAPI definition in YAML or JSON from the top of the page."]},{"$$mdtype":"Tag","name":"Image","attributes":{"srcSet":"/assets/apidownloadbuttons.4e9acb9494203363a063857396455c82eff57027845135275b25e5da82560365.e20e6b26.png light, /assets/apidownloadbuttons.4e9acb9494203363a063857396455c82eff57027845135275b25e5da82560365.e20e6b26.png dark","alt":"YAML and JSON download buttons at the top of the API definition page","withLightbox":true,"style":{"border":"10px solid white","borderRadius":"30px","marginTop":"20px","marginBottom":"20px"}},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/assets/apidownloadbuttons.4e9acb9494203363a063857396455c82eff57027845135275b25e5da82560365.e20e6b26.png"},"children":["View full-size image — YAML and JSON download buttons"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can test with the in-portal Try It flow or import the definition into an external API client such as ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://learning.postman.com/docs/introduction/overview","target":"_blank","rel":"noopener noreferrer"},"children":["Postman"]}," or ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.usebruno.com/introduction/what-is-bruno","target":"_blank","rel":"noopener noreferrer"},"children":["Bruno"]},". In external tools, create a persistent token variable and pass it in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization"]}," header for subsequent endpoint calls. Refresh or replace the token after 1 hour."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"__idx":2,"id":"step-2-authenticate"},"children":["Step 2: Authenticate"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This example uses the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Sandbox"]}," environment."]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authenticate"]}," endpoint."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Try it"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select your environment in the top-right corner."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["username"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["password"]}," in the request body."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Send"]}," and copy the returned bearer token."]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"srcSet":"/assets/tryitbutton.aeb0191c716d37eb8d92cea8f1b42d2d8b1400501f1df8571903daec335feeda.e20e6b26.png light, /assets/tryitbutton.aeb0191c716d37eb8d92cea8f1b42d2d8b1400501f1df8571903daec335feeda.e20e6b26.png dark","alt":"The Try it button on an endpoint","withLightbox":true,"style":{"border":"10px solid white","borderRadius":"30px","marginTop":"20px","marginBottom":"20px"}},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/assets/tryitbutton.aeb0191c716d37eb8d92cea8f1b42d2d8b1400501f1df8571903daec335feeda.e20e6b26.png"},"children":["View full-size image — Try it button"]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"srcSet":"/assets/authenticateendpoint.ad8e3164dc5f5c7e0ed231bfe8f315236fbbb95422bd7330b8cb8d001edb5c05.e20e6b26.png light, /assets/authenticateendpoint.ad8e3164dc5f5c7e0ed231bfe8f315236fbbb95422bd7330b8cb8d001edb5c05.e20e6b26.png dark","alt":"Authenticate endpoint response showing the returned bearer token","withLightbox":true,"style":{"border":"10px solid white","borderRadius":"30px","marginTop":"20px","marginBottom":"20px"}},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/assets/authenticateendpoint.ad8e3164dc5f5c7e0ed231bfe8f315236fbbb95422bd7330b8cb8d001edb5c05.e20e6b26.png"},"children":["View full-size image — Authenticate endpoint response"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"__idx":3,"id":"step-3-send-your-first-request"},"children":["Step 3: Send Your First Request"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open the endpoint you want to test."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Try it"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Security"]}," and confirm ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization"]}," is set to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["JWT"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bearerToken_token"]}," with your bearer token value."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If the variable does not exist, create one and reference it as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{{variable_name}}"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Add all required endpoint parameters before sending the request."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Try it"]}," console shows the available parameters for the selected endpoint. Complete any required fields to ensure a valid request."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Send the request."]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"srcSet":"/assets/authenticatevariable.c231873bb620f87f2239f4482c8b82b52a3a5d4480c89bfaf2505da1afa863ba.e20e6b26.png light, /assets/authenticatevariable.c231873bb620f87f2239f4482c8b82b52a3a5d4480c89bfaf2505da1afa863ba.e20e6b26.png dark","alt":"Security tab showing where to set the bearer token variable","withLightbox":true,"style":{"border":"10px solid white","borderRadius":"30px","marginTop":"20px","marginBottom":"20px"}},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/assets/authenticatevariable.c231873bb620f87f2239f4482c8b82b52a3a5d4480c89bfaf2505da1afa863ba.e20e6b26.png"},"children":["View full-size image — Bearer token variable setup"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"__idx":4,"id":"resources"},"children":["Resources"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["API errors: ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/connect-apis-catalog/information/errorcodes"},"children":["Error Responses"]}]}]}]},"headings":[{"value":"Quick Start","id":"quick-start","depth":1},{"value":"Step 1: Download the API Definition","id":"step-1-download-the-api-definition","depth":2},{"value":"Step 2: Authenticate","id":"step-2-authenticate","depth":2},{"value":"Step 3: Send Your First Request","id":"step-3-send-your-first-request","depth":2},{"value":"Resources","id":"resources","depth":2}],"frontmatter":{"seo":{"title":""}},"lastModified":"2025-07-30T13:46:16.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/datastudio/gettingstarted","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}