--- title: Detailed Endpoint description: "Detailed endpoint: GET /api/data/detailed/find" --- [Skip to content](https://info.ursaspace.com/oil-storage-detailed-endpoint#main-content) English Show submenu for translations ![Default_Ursa Space Logo_For Light BG_Black Red](https://info.ursaspace.com/hs-fs/hubfs/Default_Ursa%20Space%20Logo_For%20Light%20BG_Black%20Red.png?width=75&height=48&name=Default_Ursa%20Space%20Logo_For%20Light%20BG_Black%20Red.png) - [Home](https://ursaspace.com/) - [Blog](https://ursaspace.com/all-news/) Open main navigation Close main navigation - [Home](https://ursaspace.com/) - [Blog](https://ursaspace.com/all-news/) - English Show submenu for translations - Go to ursaspace.com Go to ursaspace.com Hello. How can we help you? - There are no suggestions because the search field is empty. 1. [Info](https://info.ursaspace.com/) 2. [Global Oil Storage](https://info.ursaspace.com/global-oil-storage) # Detailed Endpoint ## Detailed endpoint: GET /api/data/detailed/find Part 1: [Login Endpoint](https://info.ursaspace.com/oil-storage-authentication) Part 2: [Aggregate Endpoint](https://info.ursaspace.com/oil-storage-aggregate-endpoint) Part 3: [Detailed Endpoint](https://info.ursaspace.com/oil-storage-detailed-endpoint) ---   Requests directed at the detailed endpoint will return tank by tank data. #### Request format (detailed endpoint) The basic form for the detailed request is:  > https://platform.ursaspace.com/api/data/detailed/find?qry\_=&qry\_\_start=&qry\_\_end= Timestamp should take the form **YYYY-MM-DDThh:mm:ssZ** based on ISO 8601 standard. No quotes, single or double, are used around any values.  Multiple **qry\_=** pairs can be utilized by appending with an ampersand. A list of queryable fields and valid values is available later in this document.   There are multiple time range options: ReportTime, PublishTime and ResultTime. Only once time range type can be queried on at a time, and the start date must be before the end date.  See the data dictionary for time parameter definitions. To find the queryable values for a field with the API itself, try sending a request to the aggregate endpoint and grouping by the axis you are interested in. E.g., **qry\_SubscriptionType=China and grp\_ValueOf=LocationName** would show you all the valid LocationName values in China.  #### Examples Query for all tank measurements with April report dates: > https://platform.ursaspace.com/api/data/detailed/find?qry\_ReportTime\_start=2020-04-01T14:00:00.000Z&qry\_ReportTime\_end=2020-04-30T14:00:00.000Z Query for China tank measurements published between May 22, 2020 and May 23, 2020 > https://platform.ursaspace.com/api/data/detailed/find?qry\_PublishTime\_start=2020-05-22T00:00:00.000Z&qry\_PublishTime\_end=2020-05-24T00:00:00.000Z&qry\_Country=China Query for refinery tanks in Nigeria from Jan 1, 2020 to Feb 1, 2020 > https://platform.ursaspace.com/api/data/detailed/find?qry\_ReportTime\_start=2020-01-01T00:00:00.000Z&qry\_ReportTime\_end=2020-02-01T00:00:00.000Z&qry\_Country=Nigeria&qry\_StorageType=Refinery #### Response format (detailed endpoint)  ``` {    “queryRequestId”: “”,    “queryTime”: “”,    “queryUrl”: “detailed/find”,    “queryParameters”: {        “qry_Country”: [            “”        ],        “qry_ReportTime_end”: [            “”        ],            “qry_ReportTime_start”: [            “”        ]},     “links”: {},    “queryResult”: {        “records”: [{                “tankEntityId”: null,                “reportTime”: “2020-02-13T14:00:00.000Z”,                “resultTime”: “2020-02-07T03:43:21.000Z”,                “record”: {                    “coordinates”: {“axis_Algorithm”:”V3 Auto Sentinel”,                        “axis_Company”: “Baniyas Refining Company”,                        “axis_Country”: “Syria”,                        “axis_CrudeConfidence”: “Yes”,                        “axis_IsOecd”: “false”,                        “axis_LocationName”: “Baniyas”,                        “axis_Region”: “Middle East”,                        “axis_ReportTime”: “2020-02-13T14:00:00.000Z”,                        “axis_StorageType”: “Refinery”,                        “axis_SubscriptionType”: “All Regions,MENA”,                        “axis_TankEntity”: “BAN001”,                        “axis_TerminalName”: “SCOT (Baniyas)”,                        “axis_Territory”: “Tartus”,“axis_Sensor”: “HIMIAGE”,                    },                    “values”: {                        “capacityBarrels”: 218594,                        “cylinderHeightM”: 17.7,“errorBarrels”: 832,                        “fillBarrels”: 66851,                        “heightDropM”: 12.287,                        “latitude”: 35.2189,                        “longitude”: 35.9657,                        “radiusAverageM”: 25                    }}},}]} ``` - [General](https://info.ursaspace.com/general) - [Analytics](https://info.ursaspace.com/analytics) - [Imagery](https://info.ursaspace.com/imagery) - [Global Oil Storage](https://info.ursaspace.com/global-oil-storage) - [Global Monitoring Service](https://info.ursaspace.com/global-monitoring-service) - [Stockpile Measurement](https://info.ursaspace.com/stockpile-measurement) - [Home](https://ursaspace.com/) - [Blog](https://ursaspace.com/all-news/) [![Default_Ursa Space Logo_For Light BG_Black Red](https://info.ursaspace.com/hs-fs/hubfs/Default_Ursa%20Space%20Logo_For%20Light%20BG_Black%20Red.png?width=75&height=48&name=Default_Ursa%20Space%20Logo_For%20Light%20BG_Black%20Red.png "Default_Ursa Space Logo_For Light BG_Black Red")](http://www.ursaspace.com) Copyright © 2026, Ursa Space Systems Inc. ```json { "@context" : "https://schema.org", "@type" : "VideoObject", "contentUrl" : "https://4160389.fs1.hubspotusercontent-na1.net/hubfs/4160389/Global%20Oil%20Storage%20API%20-%203%20of%203%20-%20Aggregate%20Endpoint%20-%20Daniel%20062823.mp4", "dateModified" : "2024-04-16T18:15:15.233Z", "duration" : "PT5M0.03S", "height" : 678, "name" : "Global Oil Storage API - 3 of 3 - Aggregate Endpoint - Daniel 062823", "thumbnailUrl" : "https://4160389.fs1.hubspotusercontent-na1.net/hubfs/4160389/Global%20Oil%20Storage%20API%20-%203%20of%203%20-%20Aggregate%20Endpoint%20-%20Daniel%20062823.mp4/medium.jpg?t=0", "uploadDate" : "2024-04-16T18:15:15.227Z", "width" : 1280 } ```