# Requesting a Hazard’s Products

To request the list of products associated to a hazard:

{% openapi src="/files/wYQaKpPZEdPb68ZWOF6w" path="/hazards/{hazard-id}/products" method="get" %}
[openapi.yaml](https://3664004773-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbwQ2AvqpbIy1hD3QFTQG%2Fuploads%2Fgit-blob-9d646f1681dee35f7dc1c0638c3b2af1bcd498f5%2Fopenapi.yaml?alt=media)
{% endopenapi %}

{% hint style="info" %}
See [Authorizing Requests](/authentication/authorizing-requests.md#get-accesstoken-and-refreshtoken) page to get your accessToken.

Below is an example request with path parameters *hazard-id=134583*
{% endhint %}

The response will include an array of product objects. Each element in the array will include the following properties:

| Properties                | Definitions                                                                                                                                                                                                                        |
| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **app\_IDs**              | The identifier for the application that created this product                                                                                                                                                                       |
| **comment\_Text**         | A human readable comment attached to the document.                                                                                                                                                                                 |
| **create\_Date**          | The time this product was created. The value is a unix timestamp.                                                                                                                                                                  |
| **data**                  | If this product is of type "text", this value will be the product's message. If the product is of type "url", this value will be the hyperlink associated with the product.                                                        |
| **filename**              | If this product is of type "file", this value will be the filename of the file that was assigned to the product.                                                                                                                   |
| **geo\_Locations**        | An optional location on the earth that has been assigned to the product. The value is in WKT.                                                                                                                                      |
| **hazard\_ID**            | The ID of the hazard that owns this product.                                                                                                                                                                                       |
| **is\_Hidden**            | This boolean flag indicates whether or not this products will be hidden from the user interface.                                                                                                                                   |
| **org\_ID**               | Users of a DisasterAWARE system must belong to an organization. The products automatically assigned to the organization of the user who created the product.                                                                       |
| **org\_IDs**              | An optional comma separated list of organizations who owns this product. Products can be assigned to one or more organizations. Products that are assigned to an organization(s) are only visible to members of that organization. |
| **organization\_acronym** | Deprecated. Safe to ignore.                                                                                                                                                                                                        |
| **parent\_ID**            | The ID of the folder product in which this product is contained. A value of zero indicates that this product is on the root of the hierarchy.                                                                                      |
| **product\_ID**           | the primary key of this product.                                                                                                                                                                                                   |
| **product\_Type**         | this product's type. For more information, please see the section on product's types.                                                                                                                                              |
| **product\_url**          | If this product is a file, this value will contain the location to use to request the source file.                                                                                                                                 |
| **security\_Flag**        | this product indicates whether or not this product has been assigned to one or more organizations. A value of "R" indicates it has been restricted to one or more organizations. Otherwise, the value will be "A".                 |
| **suffix**                | If this product is a file, this value represents the file extension of the source file e.g. 'txt', 'pdf', 'doc' etc...                                                                                                             |
| **timeline\_Date**        | If this product is displayed in a timeline, this value is used to display the time the author has decided to associate to this product. The value is a unix timestamp.                                                             |
| **title**                 | A string title for this product.                                                                                                                                                                                                   |
| **update\_Date**          | The time this product was last modified. The value is a unix timestamp.                                                                                                                                                            |
| **update\_User**          | The username of the user who last modified this product.                                                                                                                                                                           |
| **user\_ID**              | The username of the user who created this product.                                                                                                                                                                                 |
| **uuid**                  | The unique identifier for this product across all DisasterAWARE systems.                                                                                                                                                           |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://api-v2-docs.disasteraware.com/products-1/requesting-a-hazards-products.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
