{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"73a5823d-be1b-4fbf-8919-d85153310801","name":"TARA","description":"\n\nThe purpose of this Tasking Archive API, **TARA**, is to provide a REST API for external partners to integrate into their own custom applications for the ordering of earth observation data via EUSI.\n\nUsers of TARA may order _Archive Productions_ (previously captured data) or quote and request a _Tasking Order_ (request for data capture) programmatically via REST endpoints. In addition, users can manage orders, i.e. request a status update or cancel the order through the same endpoints.\n\n# API Features\n\nTARA has been designed to allow users full control and visibility across their ordering journey. \nAvailable features include, but are not limited to:\n\n- Archive Data\n \n - STAC interface\n \n - Archive ordering\n \n- Tasking\n \n - Feasibility study generation\n \n - Order submission\n \n - Order tracking\n \n - Order cancellation\n \n - Order scheduling\n \n- Ordering\n \n - Delivery notification via email\n \n - Order retrieval via:\n \n - EUSI S3 bucket\n \n - Customer provided delivery options (e.g. SFTP)\n \n\n# Collection Setup\n\nSetting up your Postman collection for TARA takes three easy steps:\n\n1. Register your account with our identify provider. **Please** [contact us](https://www.euspaceimaging.com/contact/) **for the details**.\n \n2. Add your **username** and **password** to the **body** of the `POST` \"**Login**\" request under the collections \"**User management**\" folder.\n \n3. Send the request; this will populate the collections \"**Bearer token**\" variable automatically by creating it if absent, or by overwriting it.\n \n\n# Key Concepts\n\nRemote Sensing has significant amounts of industry and field specific nomenclature, which at times can be difficult to decipher. Some key concepts are defined below in layman's terms.\n\n| Term | Definition |\n| --- | --- |\n| User | Users are associated with an entity and must be created by the entity themselves. They manage end-users and orders. |\n| End-User | Persons who will use the final product |\n| Product | What you receive at the end of the ordering process. Typically a processed image. |\n| Image | Unprocessed picture from a satellite |\n| Task / Tasking | Request for a satellite to capture new data |\n| Archive | Catalogue of previously captured data |\n| Delivery (Tasking) | Time taken from the moment of capture from the satellite to the provision of the product. |\n| Delivery (Archive) | Time taken from the moment of order ingestion to the provision of the product. |\n| Near Real Time / NRT Delivery (Tasking) | 30 minute delivery of certain tasked products. |\n| Feasibility (Tasking) | A report on the likelihood of an order being executed given a set of user criteria (sensor, datetime, off-nadir angle, ect.) |\n\nFor inexperienced users we recommend reaching out to discuss your request so we can aid in tailoring a product to your needs. You can reach us at [https://www.euspaceimaging.com/contact/](https://www.euspaceimaging.com/contact/)\n\n# Band Mapping\n\nFor customers looking to match their orders against our previous band categories see the below mapping for how to reach those products from the bands we provide:\n\n| **TARA Product Types** | **Traditional Product Types** |\n| --- | --- |\n| **4BB** | PAN + 4MS |\n| **8BB** | PAN + 8MS |\n| **RGB** | PSH 321 |\n| **PSH** | PSH 4321 |\n\nNote that we do not support ordering multispectral (MS) products individually, they must come with PAN. The pricing does not differ between MS only and PAN + PS, so this is at no added cost.\n\n# Order Types\n\nThe type of order a user can place will be defined by whether it is _existing data_ (archive), _new data_ to be captured by a satellite on their behalf (tasking), and the _timeliness of the data delivery_, be it in the standard delivery timeframe or expedited.\n\nThe table below provides an overview of the specific order types.\n\n| **Category** | **Type** | **Description** |\n| --- | --- | --- |\n| Archive | Image Library | Standard time frame with max. 3 days processing time |\n| Archive | Rush Image Library | Expedited time frame with max. 1 day processing time.
Actual delivery time is dependent on individual image ID, size and type.
In average, expectation for most order types to be completed will be one
hour. |\n| Tasking | Select | Standard lead time and delivery time.
Standard collection time window with optional extension. |\n| Tasking | Select+ (Near Real Time) | Late and high priority order entries.
Cut Off Times: Min. 4 hour cut off time for satellite passes as latest entry
point; 26-hour time frame for order entry recommended.
Delivery according to NRT guidelines. |\n\n### Test Environment Ordering\n\nThe TARA test environment has a restricted amount of access compared to the \nproduction environment. See the table below for specifics:\n\n| **Category** | **Type** | **Restriction** |\n| --- | --- | --- |\n| Archive | All | Limited inventoryIds are available. [Click here](https://bitbucket.org/eusidev/tara-info/src/master/testenv_archive_inventoryIds) for the current list. |\n| Tasking | All | Orders currently halt at \"Submitted\" and sub-orders at \"Processing\". This will remain the case until the tasking delivery pipeline is operational. |\n\n# TARA Workflows\n\nBelow you can find a series of flowcharts that will guide you through the searching and ordering pipeline behind TARA. Some endpoints are open and do not required login, they are denoted by the symbol below. Any endpoints without this symbol require authentication.\n\n\"No%20Auth%20Required\"\n\n## **Step 0: Schemas**\n\nThose unfamiliar with TARA will need to reference the following **Schemas** alongside the Postman collection to ensure the validity of their requests.\n\n\"Available%20Schemas\"\n\n## **Step 1: User Management**\n\nWith the newly generated token, access is granted to the **User Info** endpoint, along with other restricted endpoints.\n\nFor this Postman collection the token is automatically set after a successful to the **Login** endpoint.\n\n\"Authentication\"\n\n## **Step 2: End User Management**\n\nA **User** will contain a set of **End Users**, these are critical for ordering as every order must have at least one **End User** assigned to it. This is both to ensure the correct pricing is applied for certain licencing agreements, and to secure against unauthorised dissemination of data from our partners.\n\nWhen a **User** is first registered they have a default **End User** created which contains their signup details and can be used immediately for ordering. Subsequent **End Users** must be approved and undergo an internal background check alongside the Postman collection to ensure the validity of their requests.\n\n\"Managing%20End%20Users\"\n\n## **Step 3: Delivery**\n\nTo collect your ordered data at least one delivery site will need to be setup. Delivery is possible either through **S3** or a \"**Designated Delivery Site**\", such as an SFTP server.\n\nIt is recommended that after adding a site that you check that it is present in the **Delivery Sites** list via one of the `GET` endpoints, and then perform a verification `POST` request on your new **Delivery Site** to ensure a connection is possible from TARA.\n\nPlease ensure your delivery site has been successfully verified as a precaution to save yourself integration time.\n\n\"Delivery%20Site%20Setup%20Process\"\n\n## **Step 4: Archive Search**\n\nOur **Archive** search endpoints permits searching our historic catalogue of previously **Tasked** orders, dating back to 2007.\n\nWe have a self-documenting **STAC** interface available for search, with documentation available here: \n**reDoc**: [https://apps.euspaceimaging.com/test/internal/catalogue/openapi?f=html&ui=redoc
](https://apps.euspaceimaging.com/test/internal/catalogue/openapi?f=html&ui=redoc)**Swagger**: [https://apps.euspaceimaging.com/test/internal/catalogue/openapi?f=html](https://apps.euspaceimaging.com/test/internal/catalogue/openapi?f=html)\n\nAfter performing a **Search** and locating your item of interest a **User** can retrieve a **Browse** (low-resolution preview), as well as any **Metadata** associated with it.\n\n\"Archive%20Search%20Pipeline\"\n\n## **Step 5: Ordering**\n\n**Quotation** for an **Archive** or **Tasking Orders** can be accomplished through TARA's **Quotation** and **Ordering** endpoints. **Quoting** for **Archive** or **Tasking** can be done separately, though should a mix be required there is the **Mixed Quote** endpoint available.\n\nRetrieving the **Status** will be necessary to review the feasibility studies and pricing. Once the feasibility studies have completed with their associated **\"Sucecss Rate %**\" the order can then be placed.\n\nOnce placed, by **Accepting a Quote**, an **Order** can be tracked via the same **Status** endpoint.\n\n**Cancelling an Order** is also possible before acquisition for Tasking, and before delivery for Archive.\n\n\"Order%20Management%20Pipeline\"\n\n# TARA Order Lifecycle\n\nThe diagram below delinates the series of steps in the ordering pipeline for Archive or Tasking images. This can be considered a minimal step workflow, your requirements may involve more endpoints.\n\n**Note**: The \"callback url\" is an optional parameter for use with customers that have an address for handling callbacks. Status updates can otherwise be retrieved by checking the \"GET Order Status\" endpoint. See _Further notes_ for more details.\n\n\"Order%20Lifecycle\"\n\n## Further Notes\n\n### Callback URL\n\nEach order, when creating a quote, can be accompanied by a callback url, accepted under the `callbackurl` parameter of the quote body. This will send through a body with the same content retrieved from the response of `GET Order By ID` (under the \"Ordering\" section).\n\nA request is sent each time the status of the order changes.","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"30569271","team":5695031,"collectionId":"73a5823d-be1b-4fbf-8919-d85153310801","publishedId":"2s9YR84tQj","public":true,"publicUrl":"https://documenter-api.postman.tech/view/30569271/2s9YR84tQj","privateUrl":"https://go.postman.co/documentation/30569271-73a5823d-be1b-4fbf-8919-d85153310801","customColor":{"top-bar":"FFFFFF","right-sidebar":"282828","highlight":"E3832B"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":"Our Tasking Archive API (TARA) allows users to order satellite imagery from our existing archive or request new imagery to be taken via a constellation of partner satellites."},{"name":"title","value":"EUSI TARA"}],"appearance":{"default":"system_default","themes":[{"name":"dark","logo":"https://content.pstmn.io/0132f26e-7d1e-4cc1-9c0b-0e6d470847b2/RVVTSV9CbG9ja19Pbmx5X0xvb19XaGl0ZV9mZmZmZmYucG5n","colors":{"top-bar":"212121","right-sidebar":"282828","highlight":"E3832B"}},{"name":"light","logo":"https://content.pstmn.io/a006bfc0-c56b-4817-b073-d6bc0c2c2cf2/RVVTSV9CbG9ja19Pbmx5X0xvZ29fQmx1ZV8xNTMwNTUucG5n","colors":{"top-bar":"FFFFFF","right-sidebar":"282828","highlight":"E3832B"}}]}},"version":"8.10.1","publishDate":"2025-03-07T13:19:14.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"EUSI TARA","description":"Our Tasking Archive API (TARA) allows users to order satellite imagery from our existing archive or request new imagery to be taken via a constellation of partner satellites."},"logos":{"logoLight":"https://content.pstmn.io/a006bfc0-c56b-4817-b073-d6bc0c2c2cf2/RVVTSV9CbG9ja19Pbmx5X0xvZ29fQmx1ZV8xNTMwNTUucG5n","logoDark":"https://content.pstmn.io/0132f26e-7d1e-4cc1-9c0b-0e6d470847b2/RVVTSV9CbG9ja19Pbmx5X0xvb19XaGl0ZV9mZmZmZmYucG5n"}},"statusCode":200},"environments":[{"name":"example","id":"11e737cc-9fe5-4ff4-b596-c5c90286def9","owner":"30569271","values":[{"key":"baseurl","value":" https://apps.euspaceimaging.com/tara","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/dbf60f69c94f90890d5c7ddc18940f9ffdf1bb221943631a1a719ece9df697d4","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":"example","value":"30569271-11e737cc-9fe5-4ff4-b596-c5c90286def9"}],"canonicalUrl":"https://documenter.gw.postman.com/view/metadata/2s9YR84tQj"}