reliefweb-api 1.0.0

data/docs/JobsApi.md

@@ -0,0 +1,202 @@
+# ReliefWebAPI::JobsApi
+
+All URIs are relative to *http://api.reliefweb.int/v1*
+
+Method | HTTP request | Description
+------------- | ------------- | -------------
+[**get_job_by_id**](JobsApi.md#get_job_by_id) | **GET** /jobs/{jobId} | Find job by its unique ID
+[**get_jobs**](JobsApi.md#get_jobs) | **GET** /jobs | List or search humanitarian job offers. 
+[**search_jobs**](JobsApi.md#search_jobs) | **POST** /jobs | List or search humanitarian job offers. 
+
+
+# **get_job_by_id**
+> Job get_job_by_id(job_id, opts)
+
+Find job by its unique ID
+
+Individual jobs. 
+
+### Example
+```ruby
+# load the gem
+require 'reliefweb-api'
+
+api_instance = ReliefWebAPI::JobsApi.new
+
+job_id = 'job_id_example' # String | The identifier of the job.
+
+opts = { 
+  profile: 'profile_example', # String | Pre-built standard selections of fields to return for ease of displaying lists or items. 
+  fields_include: ['fields_include_example'], # Array<String> | Specify which fields to include for each item. Defaults to an item label. 
+  fields_exclude: ['fields_exclude_example'] # Array<String> | Specify sub-fields to exclude from overall results. For example, if you include <code>date</code> you may exclude <code>date.changed</code>. 
+}
+
+begin
+  #Find job by its unique ID
+  result = api_instance.get_job_by_id(job_id, opts)
+  p result
+rescue ReliefWebAPI::ApiError => e
+  puts "Exception when calling JobsApi->get_job_by_id: #{e}"
+end
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **job_id** | **String**| The identifier of the job. | 
+ **profile** | **String**| Pre-built standard selections of fields to return for ease of displaying lists or items.  | [optional] 
+ **fields_include** | [**Array&lt;String&gt;**](String.md)| Specify which fields to include for each item. Defaults to an item label.  | [optional] 
+ **fields_exclude** | [**Array&lt;String&gt;**](String.md)| Specify sub-fields to exclude from overall results. For example, if you include &lt;code&gt;date&lt;/code&gt; you may exclude &lt;code&gt;date.changed&lt;/code&gt;.  | [optional] 
+
+### Return type
+
+[**Job**](Job.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: text/plain; charset=utf-8, application/json
+ - **Accept**: application/json
+
+
+
+# **get_jobs**
+> Job get_jobs(opts)
+
+List or search humanitarian job offers. 
+
+
+
+### Example
+```ruby
+# load the gem
+require 'reliefweb-api'
+
+api_instance = ReliefWebAPI::JobsApi.new
+
+opts = { 
+  query_value: 'query_value_example', # String | Specify the terms of your fuzzy search. The default is no query. 
+  query_operator: 'query_operator_example', # String | Specify the operator by which your search query words will be combined. 
+  query_fields: ['query_fields_example'], # Array<String> | Specify which fields to target with your search. You may use boost syntax here, see the Advanced API Usage documentation. 
+  filter_field: 'filter_field_example', # String | Field to filter by. Every condition must contain either a <code>field</code> or <code>conditions</code> property. 
+  filter_value: ['filter_value_example'], # Array<String> | Value for the field being filtered. Leave blank to require existence of the field, must be present for <code>range</code> and <code>value</code> conditions. 
+  filter_operator: 'filter_operator_example', # String | Operator by which filters will be combined. 
+  filter_negate: true, # BOOLEAN | Reverse the filter to include those items that do not match. 
+  filter_conditions: ['filter_conditions_example'], # Array<String> | This property is used to combine conditions with a logical connector (the <code>operator</code> property). Every condition must contain one of the <code>field</code> or <code>conditions</code> properties. 
+  facets_field: 'facets_field_example', # String | Field to facet by. May include dates, references or the status field. 
+  facets_name: 'facets_name_example', # String | Identifier for resulting facet data. Useful when faceting multiple ways on the same field. 
+  facets_limit: 56, # Integer | Limit the number of facets returned for non-date based facets. 
+  facets_sort: 'facets_sort_example', # String | The sort order of non-date facets. Sorting may be by <code>value</code> or <code>count</code> of terms, and ascending or descending. <code>count</code> defaults to <code>desc</code>, <code>value</code> defaults to <code>asc</code>. 
+  facets_filter: ['facets_filter_example'], # Array<String> | Apply all the same capabilities of the filter parameter to the specific results of this facet request. 
+  facets_interval: 'facets_interval_example', # String | Round date information to the nearest interval unit. Apply all the same capabilities of the filter parameter to the specific results of this facet request. 
+  fields_include: ['fields_include_example'], # Array<String> | Specify which fields to include for each item. Defaults to an item label. 
+  fields_exclude: ['fields_exclude_example'] # Array<String> | Specify sub-fields to exclude from overall results. For example, if you include <code>date</code> you may exclude <code>date.changed</code>. 
+  limit: 10, # Integer | The maximum number of items to return for a list query. The default is <code>10</code> and the maximum <code>1000</code>. 
+  offset: 0, # Integer | The offset from which to return the items in a list query. Allows paging through all results. The default is <code>0</code>. 
+  sort: ['sort_example'], # Array<String> | Sort the list results. Defaults to search relevance. Values in the form of <code>fieldname:(asc|desc)</code>. 
+  profile: 'profile_example', # String | Pre-built standard selections of fields to return for ease of displaying lists or items. 
+  preset: 'preset_example' # String | Pre-built standard configurations of queries, filters and sorts for common use cases. 
+}
+
+begin
+  #List or search humanitarian job offers. 
+  result = api_instance.get_jobs(opts)
+  p result
+rescue ReliefWebAPI::ApiError => e
+  puts "Exception when calling JobsApi->get_jobs: #{e}"
+end
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **query_value** | **String**| Specify the terms of your fuzzy search. The default is no query.  | [optional] 
+ **query_operator** | **String**| Specify the operator by which your search query words will be combined.  | [optional] 
+ **query_fields** | [**Array&lt;String&gt;**](String.md)| Specify which fields to target with your search. You may use boost syntax here, see the Advanced API Usage documentation.  | [optional] 
+ **filter_field** | **String**| Field to filter by. Every condition must contain either a &lt;code&gt;field&lt;/code&gt; or &lt;code&gt;conditions&lt;/code&gt; property.  | [optional] 
+ **filter_value** | [**Array&lt;String&gt;**](String.md)| Value for the field being filtered. Leave blank to require existence of the field, must be present for &lt;code&gt;range&lt;/code&gt; and &lt;code&gt;value&lt;/code&gt; conditions.  | [optional] 
+ **filter_operator** | **String**| Operator by which filters will be combined.  | [optional] 
+ **filter_negate** | **BOOLEAN**| Reverse the filter to include those items that do not match.  | [optional] 
+ **filter_conditions** | [**Array&lt;String&gt;**](String.md)| This property is used to combine conditions with a logical connector (the &lt;code&gt;operator&lt;/code&gt; property). Every condition must contain one of the &lt;code&gt;field&lt;/code&gt; or &lt;code&gt;conditions&lt;/code&gt; properties.  | [optional] 
+ **facets_field** | **String**| Field to facet by. May include dates, references or the status field.  | [optional] 
+ **facets_name** | **String**| Identifier for resulting facet data. Useful when faceting multiple ways on the same field.  | [optional] 
+ **facets_limit** | **Integer**| Limit the number of facets returned for non-date based facets.  | [optional] 
+ **facets_sort** | **String**| The sort order of non-date facets. Sorting may be by &lt;code&gt;value&lt;/code&gt; or &lt;code&gt;count&lt;/code&gt; of terms, and ascending or descending. &lt;code&gt;count&lt;/code&gt; defaults to &lt;code&gt;desc&lt;/code&gt;, &lt;code&gt;value&lt;/code&gt; defaults to &lt;code&gt;asc&lt;/code&gt;.  | [optional] 
+ **facets_filter** | [**Array&lt;String&gt;**](String.md)| Apply all the same capabilities of the filter parameter to the specific results of this facet request.  | [optional] 
+ **facets_interval** | **String**| Round date information to the nearest interval unit. Apply all the same capabilities of the filter parameter to the specific results of this facet request.  | [optional] 
+ **fields_include** | [**Array&lt;String&gt;**](String.md)| Specify which fields to include for each item. Defaults to an item label.  | [optional] 
+ **fields_exclude** | [**Array&lt;String&gt;**](String.md)| Specify sub-fields to exclude from overall results. For example, if you include &lt;code&gt;date&lt;/code&gt; you may exclude &lt;code&gt;date.changed&lt;/code&gt;.  | [optional] 
+ **limit** | **Integer**| The maximum number of items to return for a list query. The default is &lt;code&gt;10&lt;/code&gt; and the maximum &lt;code&gt;1000&lt;/code&gt;.  | [optional] [default to 10]
+ **offset** | **Integer**| The offset from which to return the items in a list query. Allows paging through all results. The default is &lt;code&gt;0&lt;/code&gt;.  | [optional] [default to 0]
+ **sort** | [**Array&lt;String&gt;**](String.md)| Sort the list results. Defaults to search relevance. Values in the form of &lt;code&gt;fieldname:(asc|desc)&lt;/code&gt;.  | [optional] 
+ **profile** | **String**| Pre-built standard selections of fields to return for ease of displaying lists or items.  | [optional] 
+ **preset** | **String**| Pre-built standard configurations of queries, filters and sorts for common use cases.  | [optional] 
+
+### Return type
+
+[**Job**](Job.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: text/plain; charset=utf-8
+ - **Accept**: application/json
+
+
+
+# **search_jobs**
+> Job search_jobs(opts)
+
+List or search humanitarian job offers. 
+
+<iframe width=\"100%\" height=\"300px\" src=\"http://reliefweb.int/help/api/field-definitions#jobs\"></iframe> 
+
+### Example
+```ruby
+# load the gem
+require 'reliefweb-api'
+
+api_instance = ReliefWebAPI::JobsApi.new
+
+opts = { 
+  fields: ReliefWebAPI::PostParams.new # PostParams | Returned fields
+}
+
+begin
+  #List or search humanitarian job offers. 
+  result = api_instance.search_jobs(opts)
+  p result
+rescue ReliefWebAPI::ApiError => e
+  puts "Exception when calling JobsApi->search_jobs: #{e}"
+end
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **fields** | [**PostParams**](PostParams.md)| Returned fields | [optional] 
+
+### Return type
+
+[**Job**](Job.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: application/json
+
+
+

data/docs/Language.md

@@ -0,0 +1,10 @@
+# ReliefWebAPI::Language
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**code** | **String** |  | [optional] 
+**id** | **Integer** |  | [optional] 
+**name** | **String** |  | [optional] 
+
+

data/docs/LimitPost.md

@@ -0,0 +1,7 @@
+# ReliefWebAPI::LimitPost
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+
+

data/docs/Location.md

@@ -0,0 +1,8 @@
+# ReliefWebAPI::Location
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**name** | **String** |  | [optional] 
+
+

data/docs/OffsetPost.md

@@ -0,0 +1,7 @@
+# ReliefWebAPI::OffsetPost
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+
+

data/docs/PostParams.md

@@ -0,0 +1,28 @@
+# ReliefWebAPI::PostParams
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**query_value** | [**QueryValuePost**](QueryValuePost.md) |  | [optional] 
+**query_operator_post** | [**QueryOperatorPost**](QueryOperatorPost.md) |  | [optional] 
+**query_fields_post** | [**QueryFieldsPost**](QueryFieldsPost.md) |  | [optional] 
+**filter_field_post** | [**FilterFieldPost**](FilterFieldPost.md) |  | [optional] 
+**filter_value_post** | [**FilterValuePost**](FilterValuePost.md) |  | [optional] 
+**filter_operator_post** | [**FilterOperatorPost**](FilterOperatorPost.md) |  | [optional] 
+**filter_negate_post** | [**FilterNegatePost**](FilterNegatePost.md) |  | [optional] 
+**filter_conditions_post** | [**FilterConditionsPost**](FilterConditionsPost.md) |  | [optional] 
+**facets_field_post** | [**FacetsFieldPost**](FacetsFieldPost.md) |  | [optional] 
+**facets_name_post** | [**FacetsNamePost**](FacetsNamePost.md) |  | [optional] 
+**facets_limit_post** | [**FacetsLimitPost**](FacetsLimitPost.md) |  | [optional] 
+**facets_sort_post** | [**FacetsSortPost**](FacetsSortPost.md) |  | [optional] 
+**facets_filter_post** | [**FacetsFilterPost**](FacetsFilterPost.md) |  | [optional] 
+**facets_interval_post** | [**FacetsIntervalPost**](FacetsIntervalPost.md) |  | [optional] 
+**fields_include** | [**FieldsIncludePost**](FieldsIncludePost.md) |  | [optional] 
+**fields_exclude** | [**FieldsExcludePost**](FieldsExcludePost.md) |  | [optional] 
+**sort_post** | [**SortPost**](SortPost.md) |  | [optional] 
+**limit_post** | [**LimitPost**](LimitPost.md) |  | [optional] 
+**offset_post** | [**OffsetPost**](OffsetPost.md) |  | [optional] 
+**profile** | [**ProfilePost**](ProfilePost.md) |  | [optional] 
+**preset_post** | [**PresetPost**](PresetPost.md) |  | [optional] 
+
+

data/docs/PresetPost.md

@@ -0,0 +1,7 @@
+# ReliefWebAPI::PresetPost
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+
+

data/docs/ProfilePost.md

@@ -0,0 +1,7 @@
+# ReliefWebAPI::ProfilePost
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+
+

data/docs/QueryFieldsPost.md

@@ -0,0 +1,7 @@
+# ReliefWebAPI::QueryFieldsPost
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+
+

data/docs/QueryOperatorPost.md

@@ -0,0 +1,7 @@
+# ReliefWebAPI::QueryOperatorPost
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+
+

data/docs/QueryValuePost.md

@@ -0,0 +1,7 @@
+# ReliefWebAPI::QueryValuePost
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+
+

data/docs/Report.md

@@ -0,0 +1,19 @@
+# ReliefWebAPI::Report
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**body** | **String** |  | [optional] 
+**country** | [**Array<Country>**](Country.md) |  | [optional] 
+**date** | **Date** |  | [optional] 
+**format** | [**Array<Category>**](Category.md) | Format of report. | [optional] 
+**id** | **Integer** |  | [optional] 
+**language** | [**Language**](Language.md) |  | [optional] 
+**primary_country** | [**Country**](Country.md) |  | [optional] 
+**source** | [**Array<Source>**](Source.md) | Report production and coordination bodies. | [optional] 
+**status** | **BOOLEAN** |  | [optional] 
+**theme** | [**Array<Category>**](Category.md) | Category of information contained in the report. | [optional] 
+**title** | **String** |  | [optional] 
+**type** | **String** |  | [optional] 
+
+

data/docs/ReportsApi.md

@@ -0,0 +1,202 @@
+# ReliefWebAPI::ReportsApi
+
+All URIs are relative to *http://api.reliefweb.int/v1*
+
+Method | HTTP request | Description
+------------- | ------------- | -------------
+[**get_report_by_id**](ReportsApi.md#get_report_by_id) | **GET** /reports/{reportId} | Find report by its unique ID
+[**get_reports**](ReportsApi.md#get_reports) | **GET** /reports | List or search updates, headlines or maps. 
+[**search_reports**](ReportsApi.md#search_reports) | **POST** /reports | List or search updates, headlines or maps. 
+
+
+# **get_report_by_id**
+> Report get_report_by_id(report_id, opts)
+
+Find report by its unique ID
+
+Individual reports. 
+
+### Example
+```ruby
+# load the gem
+require 'reliefweb-api'
+
+api_instance = ReliefWebAPI::ReportsApi.new
+
+report_id = 'report_id_example' # String | The identifier of the report.
+
+opts = { 
+  profile: 'profile_example', # String | Pre-built standard selections of fields to return for ease of displaying lists or items. 
+  fields_include: ['fields_include_example'], # Array<String> | Specify which fields to include for each item. Defaults to an item label. 
+  fields_exclude: ['fields_exclude_example'] # Array<String> | Specify sub-fields to exclude from overall results. For example, if you include <code>date</code> you may exclude <code>date.changed</code>. 
+}
+
+begin
+  #Find report by its unique ID
+  result = api_instance.get_report_by_id(report_id, opts)
+  p result
+rescue ReliefWebAPI::ApiError => e
+  puts "Exception when calling ReportsApi->get_report_by_id: #{e}"
+end
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **report_id** | **String**| The identifier of the report. | 
+ **profile** | **String**| Pre-built standard selections of fields to return for ease of displaying lists or items.  | [optional] 
+ **fields_include** | [**Array&lt;String&gt;**](String.md)| Specify which fields to include for each item. Defaults to an item label.  | [optional] 
+ **fields_exclude** | [**Array&lt;String&gt;**](String.md)| Specify sub-fields to exclude from overall results. For example, if you include &lt;code&gt;date&lt;/code&gt; you may exclude &lt;code&gt;date.changed&lt;/code&gt;.  | [optional] 
+
+### Return type
+
+[**Report**](Report.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: text/plain; charset=utf-8, application/json
+ - **Accept**: application/json
+
+
+
+# **get_reports**
+> Report get_reports(opts)
+
+List or search updates, headlines or maps. 
+
+
+
+### Example
+```ruby
+# load the gem
+require 'reliefweb-api'
+
+api_instance = ReliefWebAPI::ReportsApi.new
+
+opts = { 
+  query_value: 'query_value_example', # String | Specify the terms of your fuzzy search. The default is no query. 
+  query_operator: 'query_operator_example', # String | Specify the operator by which your search query words will be combined. 
+  query_fields: ['query_fields_example'], # Array<String> | Specify which fields to target with your search. You may use boost syntax here, see the Advanced API Usage documentation. 
+  filter_field: 'filter_field_example', # String | Field to filter by. Every condition must contain either a <code>field</code> or <code>conditions</code> property. 
+  filter_value: ['filter_value_example'], # Array<String> | Value for the field being filtered. Leave blank to require existence of the field, must be present for <code>range</code> and <code>value</code> conditions. 
+  filter_operator: 'filter_operator_example', # String | Operator by which filters will be combined. 
+  filter_negate: true, # BOOLEAN | Reverse the filter to include those items that do not match. 
+  filter_conditions: ['filter_conditions_example'], # Array<String> | This property is used to combine conditions with a logical connector (the <code>operator</code> property). Every condition must contain one of the <code>field</code> or <code>conditions</code> properties. 
+  facets_field: 'facets_field_example', # String | Field to facet by. May include dates, references or the status field. 
+  facets_name: 'facets_name_example', # String | Identifier for resulting facet data. Useful when faceting multiple ways on the same field. 
+  facets_limit: 56, # Integer | Limit the number of facets returned for non-date based facets. 
+  facets_sort: 'facets_sort_example', # String | The sort order of non-date facets. Sorting may be by <code>value</code> or <code>count</code> of terms, and ascending or descending. <code>count</code> defaults to <code>desc</code>, <code>value</code> defaults to <code>asc</code>. 
+  facets_filter: ['facets_filter_example'], # Array<String> | Apply all the same capabilities of the filter parameter to the specific results of this facet request. 
+  facets_interval: 'facets_interval_example', # String | Round date information to the nearest interval unit. Apply all the same capabilities of the filter parameter to the specific results of this facet request. 
+  fields_include: ['fields_include_example'], # Array<String> | Specify which fields to include for each item. Defaults to an item label. 
+  fields_exclude: ['fields_exclude_example'] # Array<String> | Specify sub-fields to exclude from overall results. For example, if you include <code>date</code> you may exclude <code>date.changed</code>. 
+  limit: 10, # Integer | The maximum number of items to return for a list query. The default is <code>10</code> and the maximum <code>1000</code>. 
+  offset: 0, # Integer | The offset from which to return the items in a list query. Allows paging through all results. The default is <code>0</code>. 
+  sort: ['sort_example'], # Array<String> | Sort the list results. Defaults to search relevance. Values in the form of <code>fieldname:(asc|desc)</code>. 
+  profile: 'profile_example', # String | Pre-built standard selections of fields to return for ease of displaying lists or items. 
+  preset: 'preset_example' # String | Pre-built standard configurations of queries, filters and sorts for common use cases. 
+}
+
+begin
+  #List or search updates, headlines or maps. 
+  result = api_instance.get_reports(opts)
+  p result
+rescue ReliefWebAPI::ApiError => e
+  puts "Exception when calling ReportsApi->get_reports: #{e}"
+end
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **query_value** | **String**| Specify the terms of your fuzzy search. The default is no query.  | [optional] 
+ **query_operator** | **String**| Specify the operator by which your search query words will be combined.  | [optional] 
+ **query_fields** | [**Array&lt;String&gt;**](String.md)| Specify which fields to target with your search. You may use boost syntax here, see the Advanced API Usage documentation.  | [optional] 
+ **filter_field** | **String**| Field to filter by. Every condition must contain either a &lt;code&gt;field&lt;/code&gt; or &lt;code&gt;conditions&lt;/code&gt; property.  | [optional] 
+ **filter_value** | [**Array&lt;String&gt;**](String.md)| Value for the field being filtered. Leave blank to require existence of the field, must be present for &lt;code&gt;range&lt;/code&gt; and &lt;code&gt;value&lt;/code&gt; conditions.  | [optional] 
+ **filter_operator** | **String**| Operator by which filters will be combined.  | [optional] 
+ **filter_negate** | **BOOLEAN**| Reverse the filter to include those items that do not match.  | [optional] 
+ **filter_conditions** | [**Array&lt;String&gt;**](String.md)| This property is used to combine conditions with a logical connector (the &lt;code&gt;operator&lt;/code&gt; property). Every condition must contain one of the &lt;code&gt;field&lt;/code&gt; or &lt;code&gt;conditions&lt;/code&gt; properties.  | [optional] 
+ **facets_field** | **String**| Field to facet by. May include dates, references or the status field.  | [optional] 
+ **facets_name** | **String**| Identifier for resulting facet data. Useful when faceting multiple ways on the same field.  | [optional] 
+ **facets_limit** | **Integer**| Limit the number of facets returned for non-date based facets.  | [optional] 
+ **facets_sort** | **String**| The sort order of non-date facets. Sorting may be by &lt;code&gt;value&lt;/code&gt; or &lt;code&gt;count&lt;/code&gt; of terms, and ascending or descending. &lt;code&gt;count&lt;/code&gt; defaults to &lt;code&gt;desc&lt;/code&gt;, &lt;code&gt;value&lt;/code&gt; defaults to &lt;code&gt;asc&lt;/code&gt;.  | [optional] 
+ **facets_filter** | [**Array&lt;String&gt;**](String.md)| Apply all the same capabilities of the filter parameter to the specific results of this facet request.  | [optional] 
+ **facets_interval** | **String**| Round date information to the nearest interval unit. Apply all the same capabilities of the filter parameter to the specific results of this facet request.  | [optional] 
+ **fields_include** | [**Array&lt;String&gt;**](String.md)| Specify which fields to include for each item. Defaults to an item label.  | [optional] 
+ **fields_exclude** | [**Array&lt;String&gt;**](String.md)| Specify sub-fields to exclude from overall results. For example, if you include &lt;code&gt;date&lt;/code&gt; you may exclude &lt;code&gt;date.changed&lt;/code&gt;.  | [optional] 
+ **limit** | **Integer**| The maximum number of items to return for a list query. The default is &lt;code&gt;10&lt;/code&gt; and the maximum &lt;code&gt;1000&lt;/code&gt;.  | [optional] [default to 10]
+ **offset** | **Integer**| The offset from which to return the items in a list query. Allows paging through all results. The default is &lt;code&gt;0&lt;/code&gt;.  | [optional] [default to 0]
+ **sort** | [**Array&lt;String&gt;**](String.md)| Sort the list results. Defaults to search relevance. Values in the form of &lt;code&gt;fieldname:(asc|desc)&lt;/code&gt;.  | [optional] 
+ **profile** | **String**| Pre-built standard selections of fields to return for ease of displaying lists or items.  | [optional] 
+ **preset** | **String**| Pre-built standard configurations of queries, filters and sorts for common use cases.  | [optional] 
+
+### Return type
+
+[**Report**](Report.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: text/plain; charset=utf-8
+ - **Accept**: application/json
+
+
+
+# **search_reports**
+> Report search_reports(opts)
+
+List or search updates, headlines or maps. 
+
+<div id=\"reports-fields\"></div> 
+
+### Example
+```ruby
+# load the gem
+require 'reliefweb-api'
+
+api_instance = ReliefWebAPI::ReportsApi.new
+
+opts = { 
+  fields: ReliefWebAPI::PostParams.new # PostParams | Returned fields
+}
+
+begin
+  #List or search updates, headlines or maps. 
+  result = api_instance.search_reports(opts)
+  p result
+rescue ReliefWebAPI::ApiError => e
+  puts "Exception when calling ReportsApi->search_reports: #{e}"
+end
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **fields** | [**PostParams**](PostParams.md)| Returned fields | [optional] 
+
+### Return type
+
+[**Report**](Report.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: application/json
+
+
+