{"_id":"56e703e6cb97fd200068ecf2","slug":"getting-started","user":"55fae9d4825d5f19001fa379","body":"For this tutorial, we'll use the Postman client to make API calls. The GBDX Postman collection features a section called \"Getting Started.\" The requests in this collection complement the steps in this guide. Step 2 will explain how to set up Postman.\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Contents\",\n    \"h-1\": \"Resource\",\n    \"0-0\": \"[Step 1: Get your account credentials](#Step 1: Get your account credentials)\",\n    \"0-1\": \"\",\n    \"3-0\": \"[Step 4: Search the catalog](#Step 4: Search the catalog)\",\n    \"3-1\": \"\",\n    \"4-0\": \"[Step 5: Place an order and check its status](#Step 5: Place an order and check its status)\",\n    \"4-1\": \"\",\n    \"5-0\": \"[Step 6: Submit a task and run a workflow](#Step 6: Submit a task and run a workflow)\",\n    \"5-1\": \"\",\n    \"6-0\": \"[Step 7: Access the output data from a workflow](#Step 7: Access the output data from a workflow)\",\n    \"6-1\": \"\",\n    \"1-0\": \"[Step 2: Set up the Postman client](#Step 2: Set up the Postman client)\",\n    \"1-1\": \"\",\n    \"h-2\": \"Description\",\n    \"0-2\": \"Instructions for installing Postman and downloading the GBDX environment and collection files.\",\n    \"1-2\": \"Authentication API\",\n    \"3-2\": \"Catalog Search API\",\n    \"4-2\": \"Ordering API (V2)\",\n    \"2-0\": \"[Step 3: Get a token](#Step 3: Get a token)\"\n  },\n  \"cols\": 1,\n  \"rows\": 7\n}\n[/block]\n\n# <a name=\"Step 1: Get your account credentials\"></a>Step 1: Get your account credentials\n\nBefore we start, you'll need your GBDX username, password, and API key to set up your Postman environment variables (step 2). This table explains how to find these values.\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Credentials\",\n    \"h-1\": \"How to locate\",\n    \"0-0\": \"GBDX username\",\n    \"0-1\": \"youremailaddress:::at:::digitalglobe.com\",\n    \"1-0\": \"GBDX Password\",\n    \"1-1\": \"The password you set when you activated your account. \\n\\nThe password can be reset using the \\n<a href=\\\"https://gbdx.geobigdata.io/account/login/\\\" target=\\\"_blank\\\">GBDX web application.</a>\",\n    \"2-0\": \"API Key\",\n    \"2-1\": \"<a href=\\\"http://gbdxdocs.digitalglobe.com/docs/lessonfind-your-api-key\\\">Find your API key from the GBDX web application. </a>\"\n  },\n  \"cols\": 2,\n  \"rows\": 3\n}\n[/block]\n# <a name=\"Step 2: Set up the Postman client\"></a>Step 2: Set up the Postman client\n\nWe've created a \"Getting Started\" Postman collection that exercises the examples in this guide. \n\nPlease use the [Postman Instructions & Collections](doc:postman-instructions-collections) tutorial to install Postman, set up the GBDX environment, and download the GBDX Postman collection. (You don't need the GBDX Vector collection for this tutorial).\n\n# <a name=\"Step 3: Get a token\"></a>Step 3: Get a token\n\nTo use GBDX APIs, you'll need an OAuth2 token. \n\n1. Once you've set up your environment variables in Postman and imported the GBDX collection, select the collection to open it.\n2. Under \"Getting Started\", select Get user token\n3. Select \"send\"\n\nExample response:\n\n     {\n       \"access_token\": \"rEhLS5GM75OzkCWm0zRWekijMRhQSy\",\n      \"token_type\": \"Bearer\",\n       \"expires_in\": 604800,\n      \"refresh_token\": \"rMzRGhdaz7elJtiYilAerFVh8Mygdu\",\n       \"scope\": \"read write\"\n     }\n\n\nThe value for \"access_token\" is your user token. Copy it to your clipboard (do not include the quotes).\n\n4. In Postman, add your token to the environment variables. \n     * Click \"GBDX\" in the top right corner of the Postman client\n     * Under \"manage environments\", click \"GBDX\"\n     * Paste the token value to the \"token\" key.\n     * Select update\n\nYour token is good for 7 days (604800 seconds).\n\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Be sure the GBDX environment is selected before running an API call.\",\n  \"body\": \"Choose GBDX from othe dropdown in the top right corner if it's not already selected.\"\n}\n[/block]\n# <a name=\"Step 4: Search the catalog\"></a>Step 4: Search the catalog\n\nYou can search the GBDX catalog by spatial area, by date range,  or by both. Use filters to refine your data set. \n\nLet's search for acquisitions in a subsection of San Francisco, taken between March 1, 2015  and March 1, 2016, with low cloud cover of less than 10, and off-nadir angle of less than 20.\n\nIn Postman, find the folder for Catalog V2. Then choose \"Cat V2 search by spatial area\". \n\n1. Determine the criteria you want to search by. \n2. Send a POST request to https://geobigdata.io/catalog/v2/search. If you're using the Postman collection, the url is already there. \n3. Create the search request body. For this exercise, the body is preset in Postman. \n\nFor this example, your search request looks like this:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{  \\n    \\\"searchAreaWkt\\\": \\\"POLYGON ((-122.41189956665039 37.59415685597818, -122.41189956665039 37.64460175855099, -122.34529495239259 37.64460175855099, -122.34529495239259 37.59415685597818, -122.41189956665039 37.59415685597818))\\\",\\n     \\\"startDate\\\":\\\"2015-03-01T00:00:00.000Z\\\",\\n    \\\"endDate\\\":\\\"2016-03-01T23:59:59.999Z\\\",\\n    \\\"filters\\\":[\\\"cloudCover < 10\\\",\\n    \\\"offNadirAngle < 20\\\"],  \\n    \\\"types\\\":[\\\"DigitalGlobeAcquisition\\\"]\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\nThe response will be a JSON body that lists each resulting acquisition (image) and its properties. Each acquisition will list a catalogID. This is the ID you'll use to place an order in step 2.\n\nExample:\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/RCnt5MXSTaOeuWsWNggv_CatIDinResponse.png\",\n        \"CatIDinResponse.png\",\n        \"646\",\n        \"259\",\n        \"#b85f47\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n To see a sample request and response body, go to [Catalog V2 Search by Spatial Area](doc:catalog-v2-search-by-spatial-area).\n\n# <a name=\"Step 5: Place an order and check its status\"></a>Step 5: Place an order and check its status\n\n## Place an order\n\nThe Ordering API lets you order imagery and check your order's status. To place an order, you'll need a list of one or more acquisition catalog IDs. You can get the catalog IDs from the search executed in the previous step.\n\n     1. Send a POST request to https://geobigdta.io/orders/v2/order\n     2. Include the list of acquisition catalog IDs  you want to order in the request\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"[\\n    103001005275AC00,\\n    103001004046DC00,\\n    10504100106AA800,\\n    1020010030936B00,\\n    104001000680BA00,\\n    102001003648FC00,\\n    1010010012956800\\n]\\n\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n3. This request will return an order ID, and order information about each catalog ID. Save the order_id. You'll use it to check the status of your order. \n\nExample response:\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"order_id\\\": \\\"35a91755-059f-4e14-94a1-b96e05f05fb9\\\",\\n  \\\"acquisitions\\\": [\\n    {\\n      \\\"acquisition_id\\\": \\\"103001004046DC00\\\",\\n      \\\"state\\\": \\\"delivered\\\",\\n      \\\"location\\\": \\\"s3://receiving-dgcs-tdgplatform-com/055166274010_01_003\\\"\\n    },\\n    {\\n      \\\"acquisition_id\\\": \\\"1020010030936B00\\\",\\n      \\\"state\\\": \\\"submitted\\\",\\n      \\\"location\\\": \\\"not_delivered\\\"\\n    },\\n\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\nIf the acquisition has been delivered to the GBDX catalog, the state will be \"delivered\" and the S3 receiving bucket location will be displayed. Some tasks require this location as an input.\n\n## Check order status\n\nTo check the status of your order, \nSend a GET request to https://geobigdata.io/orders/v2/order/<order_id> . Use the order_ID you saved when you placed the order.\n\nExample:\nhttps://geobigdata.io/orders/v2/order/35a91755-059f-4e14-94a1-b96e05f05fb9\n\nWhen the order has been fulfilled, all acquisitions will have a state of \"delivered\" and an s3 receiving bucket location will be displayed.\n\n# <a name=\"Step 6: Submit a task and run a workflow\"></a>Step 6: Submit a task and run a workflow\nA workflow chains together a series of tasks and runs them in the specified order. Running a workflow means sending a POST request to the workflow endpoint, with the tasks described in a JSON document.\n\n\n[block:callout]\n{\n  \"type\": \"danger\",\n  \"title\": \"All tasks require inputs.\",\n  \"body\": \"When a task requires an S3 bucket location as an input, find the location in the Order response. Location will only be displayed when the state = delivered.\"\n}\n[/block]\nFor this tutorial, we'll create and run a workflow with the following tasks:\n\n1. Getting_Started: a simple task that only requires \"your_name\" as an input, and outputs a .txt file. \n\n2. Stagedata_to_S3: takes the output data from the Getting_started\" task and puts in in the S3 bucket.\n\nTo create and run a workflow:\n\n1. View the Getting_Started task definition\nTo view the task definition of the Getting_Started task, use the Postman collection to send a GET request to https://geobigdata.io/workflows/v1/tasks/Getting_Started\n\nThis is for informational purposes only. You will not change any values in the task definition.  Values will be set in the Workflow definition.\n\n2. Define and run your workflow\nTo run a workflow, send a request to the https://geobigdata.io/workflows/v1/workflows endpoint, with a JSON body that describes the tasks and sets the run order. Workflows run tasks from the first listed to the last.\n\nThis workflow example shows the input and output values the Getting_Started and Stagedata_to_S3 tasks. You can try this using the Getting Started \"run a workflow\" request in the GBDX Postman collection.\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"\\n{\\n        \\\"name\\\": \\\"Getting_Started_Workflow\\\",\\n        \\\"tasks\\\": [\\n            {\\n                \\\"name\\\": \\\"show_getting_started\\\",\\n                \\\"outputs\\\": [\\n                    {\\n                        \\\"name\\\": \\\"data\\\"\\n                    }\\n                ],\\n                \\\"inputs\\\": [\\n                    {\\n                        \\\"name\\\": \\\"your_name\\\",\\n                        \\\"value\\\": \\\"GBDX U\\\"\\n                    }\\n                   \\n                ],\\n                \\\"taskType\\\": \\\"Getting_Started\\\"\\n            },\\n            {\\n                \\\"name\\\": \\\"getting_started_output\\\",\\n                \\\"inputs\\\": [\\n                    {\\n                        \\\"name\\\": \\\"data\\\",\\n                        \\\"source\\\": \\\"show_getting_started:data\\\"\\n                    },\\n                    {\\n                       \\\"name\\\": \\\"destination\\\",\\n                        \\\"value\\\": \\\"https://gbd-customer-data/YOUR_ACCOUNT_ID_PREFIX_HERE/getting_started_output/\\\"\\n                    }\\n                ],\\n                \\\"taskType\\\": \\\"StageDataToS3\\\"\\n            }\\n        ]\\n    }\\n\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n#### How to find your account ID/prefix\n\nGBDX uses your account ID as the prefix for your S3 bucket. The quickest way to find this value is to log into the S3 browser with your GBDX username (email address) and password. \n\nThe path with your account ID will look like this:  s3://gbd-customer-data/731835da-2059-42de-ad91-03e6e5198fc6/ \n\nUse a name that's easy to recognize. You'll use this name to find your output data in the next step. \n\nFor example:\"name\": \"getting_started_output\",\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"The \\\"TaskType\\\" must match the name of the task in the task registry.\",\n  \"body\": \"For example, \\\"StageDataToS3\\\" is the task type. This matches the name of the task in the task registry.\"\n}\n[/block]\n# <a name=\"Step 7: Access the output data from a workflow\"></a>Step 7: Access the output data from a workflow\n\nUse the S3 Browser to view the output of the workflow. You can also  download a single file.\n\nYou'll need your GBDX username and password to log in.\nTry the <a href=\"http://s3browser.geobigdata.io\" target=\"_blank\">S3 Browser</a> \n\nThe S3 browser will show all the files under your S3 bucket and prefix (account ID). Look for the folder with the name you gave here:\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/3k2kk8RlaedYfpvaFTAk_s3%20directory.PNG\",\n        \"s3 directory.PNG\",\n        \"593\",\n        \"315\",\n        \"#da4d25\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\nInside this folder, you'll find a txt file called Hello_World.txt. Open the file to see this successful result:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"Welcome to GBDX, [your name]!\\n\\n==> You just completed your first workflow!\",\n      \"language\": \"text\"\n    }\n  ]\n}\n[/block]\n# That's it!\n\nNow that you've seen what you can do with GBDX, use our Guides to find more comprehensive information.","hidden":false,"link_url":"","order":0,"project":"55faeacad0e22017005b8265","isReference":false,"title":"Get Started with GBDX APIs","type":"basic","version":"55faeacad0e22017005b8268","__v":153,"createdAt":"2016-03-14T18:33:10.766Z","excerpt":"Learn how to use GBDX APIs and services using this quick tutorial.","next":{"description":"","pages":[]},"parentDoc":null,"sync_unique":"","updates":["59383c8e3ef25b001bb17aaa"],"api":{"settings":"","url":"","auth":"required","params":[],"results":{"codes":[]}},"category":"561d4c78281aec0d00eb27b6","githubsync":"","link_external":false,"childrenPages":[]}

Get Started with GBDX APIs

Learn how to use GBDX APIs and services using this quick tutorial.

For this tutorial, we'll use the Postman client to make API calls. The GBDX Postman collection features a section called "Getting Started." The requests in this collection complement the steps in this guide. Step 2 will explain how to set up Postman. [block:parameters] { "data": { "h-0": "Contents", "h-1": "Resource", "0-0": "[Step 1: Get your account credentials](#Step 1: Get your account credentials)", "0-1": "", "3-0": "[Step 4: Search the catalog](#Step 4: Search the catalog)", "3-1": "", "4-0": "[Step 5: Place an order and check its status](#Step 5: Place an order and check its status)", "4-1": "", "5-0": "[Step 6: Submit a task and run a workflow](#Step 6: Submit a task and run a workflow)", "5-1": "", "6-0": "[Step 7: Access the output data from a workflow](#Step 7: Access the output data from a workflow)", "6-1": "", "1-0": "[Step 2: Set up the Postman client](#Step 2: Set up the Postman client)", "1-1": "", "h-2": "Description", "0-2": "Instructions for installing Postman and downloading the GBDX environment and collection files.", "1-2": "Authentication API", "3-2": "Catalog Search API", "4-2": "Ordering API (V2)", "2-0": "[Step 3: Get a token](#Step 3: Get a token)" }, "cols": 1, "rows": 7 } [/block] # <a name="Step 1: Get your account credentials"></a>Step 1: Get your account credentials Before we start, you'll need your GBDX username, password, and API key to set up your Postman environment variables (step 2). This table explains how to find these values. [block:parameters] { "data": { "h-0": "Credentials", "h-1": "How to locate", "0-0": "GBDX username", "0-1": "youremailaddress@digitalglobe.com", "1-0": "GBDX Password", "1-1": "The password you set when you activated your account. \n\nThe password can be reset using the \n<a href=\"https://gbdx.geobigdata.io/account/login/\" target=\"_blank\">GBDX web application.</a>", "2-0": "API Key", "2-1": "<a href=\"http://gbdxdocs.digitalglobe.com/docs/lessonfind-your-api-key\">Find your API key from the GBDX web application. </a>" }, "cols": 2, "rows": 3 } [/block] # <a name="Step 2: Set up the Postman client"></a>Step 2: Set up the Postman client We've created a "Getting Started" Postman collection that exercises the examples in this guide. Please use the [Postman Instructions & Collections](doc:postman-instructions-collections) tutorial to install Postman, set up the GBDX environment, and download the GBDX Postman collection. (You don't need the GBDX Vector collection for this tutorial). # <a name="Step 3: Get a token"></a>Step 3: Get a token To use GBDX APIs, you'll need an OAuth2 token. 1. Once you've set up your environment variables in Postman and imported the GBDX collection, select the collection to open it. 2. Under "Getting Started", select Get user token 3. Select "send" Example response: { "access_token": "rEhLS5GM75OzkCWm0zRWekijMRhQSy", "token_type": "Bearer", "expires_in": 604800, "refresh_token": "rMzRGhdaz7elJtiYilAerFVh8Mygdu", "scope": "read write" } The value for "access_token" is your user token. Copy it to your clipboard (do not include the quotes). 4. In Postman, add your token to the environment variables. * Click "GBDX" in the top right corner of the Postman client * Under "manage environments", click "GBDX" * Paste the token value to the "token" key. * Select update Your token is good for 7 days (604800 seconds). [block:callout] { "type": "info", "title": "Be sure the GBDX environment is selected before running an API call.", "body": "Choose GBDX from othe dropdown in the top right corner if it's not already selected." } [/block] # <a name="Step 4: Search the catalog"></a>Step 4: Search the catalog You can search the GBDX catalog by spatial area, by date range, or by both. Use filters to refine your data set. Let's search for acquisitions in a subsection of San Francisco, taken between March 1, 2015 and March 1, 2016, with low cloud cover of less than 10, and off-nadir angle of less than 20. In Postman, find the folder for Catalog V2. Then choose "Cat V2 search by spatial area". 1. Determine the criteria you want to search by. 2. Send a POST request to https://geobigdata.io/catalog/v2/search. If you're using the Postman collection, the url is already there. 3. Create the search request body. For this exercise, the body is preset in Postman. For this example, your search request looks like this: [block:code] { "codes": [ { "code": "{ \n \"searchAreaWkt\": \"POLYGON ((-122.41189956665039 37.59415685597818, -122.41189956665039 37.64460175855099, -122.34529495239259 37.64460175855099, -122.34529495239259 37.59415685597818, -122.41189956665039 37.59415685597818))\",\n \"startDate\":\"2015-03-01T00:00:00.000Z\",\n \"endDate\":\"2016-03-01T23:59:59.999Z\",\n \"filters\":[\"cloudCover < 10\",\n \"offNadirAngle < 20\"], \n \"types\":[\"DigitalGlobeAcquisition\"]\n}", "language": "json" } ] } [/block] The response will be a JSON body that lists each resulting acquisition (image) and its properties. Each acquisition will list a catalogID. This is the ID you'll use to place an order in step 2. Example: [block:image] { "images": [ { "image": [ "https://files.readme.io/RCnt5MXSTaOeuWsWNggv_CatIDinResponse.png", "CatIDinResponse.png", "646", "259", "#b85f47", "" ] } ] } [/block] To see a sample request and response body, go to [Catalog V2 Search by Spatial Area](doc:catalog-v2-search-by-spatial-area). # <a name="Step 5: Place an order and check its status"></a>Step 5: Place an order and check its status ## Place an order The Ordering API lets you order imagery and check your order's status. To place an order, you'll need a list of one or more acquisition catalog IDs. You can get the catalog IDs from the search executed in the previous step. 1. Send a POST request to https://geobigdta.io/orders/v2/order 2. Include the list of acquisition catalog IDs you want to order in the request [block:code] { "codes": [ { "code": "[\n 103001005275AC00,\n 103001004046DC00,\n 10504100106AA800,\n 1020010030936B00,\n 104001000680BA00,\n 102001003648FC00,\n 1010010012956800\n]\n", "language": "json" } ] } [/block] 3. This request will return an order ID, and order information about each catalog ID. Save the order_id. You'll use it to check the status of your order. Example response: [block:code] { "codes": [ { "code": "{\n \"order_id\": \"35a91755-059f-4e14-94a1-b96e05f05fb9\",\n \"acquisitions\": [\n {\n \"acquisition_id\": \"103001004046DC00\",\n \"state\": \"delivered\",\n \"location\": \"s3://receiving-dgcs-tdgplatform-com/055166274010_01_003\"\n },\n {\n \"acquisition_id\": \"1020010030936B00\",\n \"state\": \"submitted\",\n \"location\": \"not_delivered\"\n },\n", "language": "json" } ] } [/block] If the acquisition has been delivered to the GBDX catalog, the state will be "delivered" and the S3 receiving bucket location will be displayed. Some tasks require this location as an input. ## Check order status To check the status of your order, Send a GET request to https://geobigdata.io/orders/v2/order/<order_id> . Use the order_ID you saved when you placed the order. Example: https://geobigdata.io/orders/v2/order/35a91755-059f-4e14-94a1-b96e05f05fb9 When the order has been fulfilled, all acquisitions will have a state of "delivered" and an s3 receiving bucket location will be displayed. # <a name="Step 6: Submit a task and run a workflow"></a>Step 6: Submit a task and run a workflow A workflow chains together a series of tasks and runs them in the specified order. Running a workflow means sending a POST request to the workflow endpoint, with the tasks described in a JSON document. [block:callout] { "type": "danger", "title": "All tasks require inputs.", "body": "When a task requires an S3 bucket location as an input, find the location in the Order response. Location will only be displayed when the state = delivered." } [/block] For this tutorial, we'll create and run a workflow with the following tasks: 1. Getting_Started: a simple task that only requires "your_name" as an input, and outputs a .txt file. 2. Stagedata_to_S3: takes the output data from the Getting_started" task and puts in in the S3 bucket. To create and run a workflow: 1. View the Getting_Started task definition To view the task definition of the Getting_Started task, use the Postman collection to send a GET request to https://geobigdata.io/workflows/v1/tasks/Getting_Started This is for informational purposes only. You will not change any values in the task definition. Values will be set in the Workflow definition. 2. Define and run your workflow To run a workflow, send a request to the https://geobigdata.io/workflows/v1/workflows endpoint, with a JSON body that describes the tasks and sets the run order. Workflows run tasks from the first listed to the last. This workflow example shows the input and output values the Getting_Started and Stagedata_to_S3 tasks. You can try this using the Getting Started "run a workflow" request in the GBDX Postman collection. [block:code] { "codes": [ { "code": "\n{\n \"name\": \"Getting_Started_Workflow\",\n \"tasks\": [\n {\n \"name\": \"show_getting_started\",\n \"outputs\": [\n {\n \"name\": \"data\"\n }\n ],\n \"inputs\": [\n {\n \"name\": \"your_name\",\n \"value\": \"GBDX U\"\n }\n \n ],\n \"taskType\": \"Getting_Started\"\n },\n {\n \"name\": \"getting_started_output\",\n \"inputs\": [\n {\n \"name\": \"data\",\n \"source\": \"show_getting_started:data\"\n },\n {\n \"name\": \"destination\",\n \"value\": \"https://gbd-customer-data/YOUR_ACCOUNT_ID_PREFIX_HERE/getting_started_output/\"\n }\n ],\n \"taskType\": \"StageDataToS3\"\n }\n ]\n }\n", "language": "json" } ] } [/block] #### How to find your account ID/prefix GBDX uses your account ID as the prefix for your S3 bucket. The quickest way to find this value is to log into the S3 browser with your GBDX username (email address) and password. The path with your account ID will look like this: s3://gbd-customer-data/731835da-2059-42de-ad91-03e6e5198fc6/ Use a name that's easy to recognize. You'll use this name to find your output data in the next step. For example:"name": "getting_started_output", [block:callout] { "type": "info", "title": "The \"TaskType\" must match the name of the task in the task registry.", "body": "For example, \"StageDataToS3\" is the task type. This matches the name of the task in the task registry." } [/block] # <a name="Step 7: Access the output data from a workflow"></a>Step 7: Access the output data from a workflow Use the S3 Browser to view the output of the workflow. You can also download a single file. You'll need your GBDX username and password to log in. Try the <a href="http://s3browser.geobigdata.io" target="_blank">S3 Browser</a> The S3 browser will show all the files under your S3 bucket and prefix (account ID). Look for the folder with the name you gave here: [block:image] { "images": [ { "image": [ "https://files.readme.io/3k2kk8RlaedYfpvaFTAk_s3%20directory.PNG", "s3 directory.PNG", "593", "315", "#da4d25", "" ] } ] } [/block] Inside this folder, you'll find a txt file called Hello_World.txt. Open the file to see this successful result: [block:code] { "codes": [ { "code": "Welcome to GBDX, [your name]!\n\n==> You just completed your first workflow!", "language": "text" } ] } [/block] # That's it! Now that you've seen what you can do with GBDX, use our Guides to find more comprehensive information.