Search ReliefWeb humanitarian reports, disasters, jobs, training, and country profiles via MCP.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Fetch a country profile from ReliefWeb by ISO3 code, including overview, humanitarian situation summary, key content links, active appeals and response plans, and useful external links. Country profiles are curated by OCHA editors and provide the authoritative situation summary for humanitarian responders. Each curated list also has an archive — thousands of entries deep for a long-running crisis — which the profile leaves out. Two alternative selectors, at most one per call: sections names parts of the profile to return, archive pages one list's archived entries in place of the profile. A profile over the response budget comes back as a section outline naming every section and its byte size. Nothing is truncated on any path.
ISO 3166-1 alpha-3 country code (e.g., SYR, AFG, UKR). Used to look up the country's ReliefWeb profile.
Archive mode: return a page of one curated list's ARCHIVED entries instead of the country record. The response carries the record identity, the selected list, and total / shown / offset, plus a next offset while more entries remain. Mutually exclusive with sections — sections slices the record, archive replaces it — and a call supplying both is rejected. A record over the response budget still answers an archive call with the page: a page is bounded by limit and carries none of the record prose, so it never outlines.
Sections of the country record to return, named by the sections[].name values an outline response lists. Omit for the whole record, or for a section outline when the record is over the response budget. Records are sparse, so a name this record does not carry is rejected with the names it does. Identity metadata — the record's ID, its name, and its canonical URL — comes back alongside whatever is requested. The call is self-contained — the record is re-fetched and sliced, so no prior call has to be repeated. This names parts of the profile itself and never reaches archived entries — use archive for those.
Fetch a country profile from ReliefWeb by ISO3 code, including overview, humanitarian situation summary, key content links, active appeals and response plans, and useful external links. Country profiles are curated by OCHA editors and provide the authoritative situation summary for humanitarian responders. Each curated list also has an archive — thousands of entries deep for a long-running crisis — which the profile leaves out. Two alternative selectors, at most one per call: sections names parts of the profile to return, archive pages one list's archived entries in place of the profile. A profile over the response budget comes back as a section outline naming every section and its byte size. Nothing is truncated on any path.
| Argument | Type | Description |
|---|---|---|
| iso3* | string | ISO 3166-1 alpha-3 country code (e.g., SYR, AFG, UKR). Used to look up the country's ReliefWeb profile. |
| archive | object | Archive mode: return a page of one curated list's ARCHIVED entries instead of the country record. The response carries the record identity, the selected list, and total / shown / offset, plus a next offset while more entries remain. Mutually exclusive with sections — sections slices the record, archive replaces it — and a call supplying both is rejected. A record over the response budget still answers an archive call with the page: a page is bounded by limit and carries none of the record prose, so it never outlines. |
| sections | array | Sections of the country record to return, named by the sections[].name values an outline response lists. Omit for the whole record, or for a section outline when the record is over the response budget. Records are sparse, so a name this record does not carry is rejected with the names it does. Identity metadata — the record's ID, its name, and its canonical URL — comes back alongside whatever is requested. The call is self-contained — the record is re-fetched and sliced, so no prior call has to be repeated. This names parts of the profile itself and never reaches archived entries — use archive for those. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"iso3"
],
"properties": {
"iso3": {
"type": "string",
"maxLength": 3,
"minLength": 3,
"description": "ISO 3166-1 alpha-3 country code (e.g., SYR, AFG, UKR). Used to look up the country's ReliefWeb profile."
},
"archive": {
"type": "object",
"required": [
"list"
],
"properties": {
"list": {
"enum": [
"keyContent",
"appealsResponsePlans",
"usefulLinks"
],
"type": "string",
"description": "Which curated list to page. The archived entries of that list are the ones the profile itself leaves out."
},
"limit": {
"type": "integer",
"default": 25,
"maximum": 100,
"minimum": 1,
"description": "Maximum archived entries in one page (1-100)."
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"description": "Zero-based index of the first archived entry to return. Send back the nextOffset from the previous page to continue."
}
},
"description": "Archive mode: return a page of one curated list's ARCHIVED entries instead of the country record. The response carries the record identity, the selected list, and total / shown / offset, plus a next offset while more entries remain. Mutually exclusive with sections — sections slices the record, archive replaces it — and a call supplying both is rejected. A record over the response budget still answers an archive call with the page: a page is bounded by limit and carries none of the record prose, so it never outlines."
},
"sections": {
"type": "array",
"items": {
"type": "string",
"description": "A section name exactly as the outline response spelled it."
},
"description": "Sections of the country record to return, named by the sections[].name values an outline response lists. Omit for the whole record, or for a section outline when the record is over the response budget. Records are sparse, so a name this record does not carry is rejected with the names it does. Identity metadata — the record's ID, its name, and its canonical URL — comes back alongside whatever is requested. The call is self-contained — the record is re-fetched and sliced, so no prior call has to be repeated. This names parts of the profile itself and never reaches archived entries — use archive for those."
}
},
"additionalProperties": false
}Fetch a disaster record by ReliefWeb numeric ID including description, affected countries, GLIDE number, profile overview, key content links, and active appeals or response plans. Use after reliefweb_search_disasters to retrieve full details. Each curated list also has an archive, which the record leaves out. Two alternative selectors, at most one per call: sections names parts of the record to return, archive pages one list's archived entries in place of the record. Description and profile overview can together run to tens of KB for major disasters. A record over the response budget comes back as a section outline naming every section and its byte size. Nothing is truncated on any path.
| Argument | Type | Description |
|---|---|---|
| id* | integer | ReliefWeb numeric disaster ID. Obtained from reliefweb_search_disasters results. |
| archive | object | Archive mode: return a page of one curated list's ARCHIVED entries instead of the disaster record. The response carries the record identity, the selected list, and total / shown / offset, plus a next offset while more entries remain. Mutually exclusive with sections — sections slices the record, archive replaces it — and a call supplying both is rejected. A record over the response budget still answers an archive call with the page: a page is bounded by limit and carries none of the record prose, so it never outlines. |
| sections | array | Sections of the disaster record to return, named by the sections[].name values an outline response lists. Omit for the whole record, or for a section outline when the record is over the response budget. Records are sparse, so a name this record does not carry is rejected with the names it does. Identity metadata — the record's ID, its name, and its canonical URL — comes back alongside whatever is requested. The call is self-contained — the record is re-fetched and sliced, so no prior call has to be repeated. This names parts of the record itself and never reaches archived entries — use archive for those. |
Fetch a job posting by ReliefWeb numeric ID with the full vacancy description, application instructions, dates, hiring organization, and location and taxonomy metadata. Use after reliefweb_search_jobs, which returns summaries without the description or application instructions. Reaches expired postings as well as open ones. A record over the response budget comes back as a section outline naming every section and its byte size; re-call with sections to pull only the ones needed. Nothing is truncated on either path.
| Argument | Type | Description |
|---|---|---|
| id* | integer | ReliefWeb numeric job ID. Obtained from reliefweb_search_jobs results. |
| sections | array | Sections of the job record to return, named by the sections[].name values an outline response lists. Omit for the whole record, or for a section outline when the record is over the response budget. Records are sparse, so a name this record does not carry is rejected with the names it does. Identity metadata — the record's ID, its name, and its canonical URL — comes back alongside whatever is requested. The call is self-contained — the record is re-fetched and sliced, so no prior call has to be repeated. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "ReliefWeb numeric job ID. Obtained from reliefweb_search_jobs results.",
"exclusiveMinimum": 0
},
"sections": {
"type": "array",
"items": {
"type": "string",
"description": "A section name exactly as the outline response spelled it."
},
"description": "Sections of the job record to return, named by the sections[].name values an outline response lists. Omit for the whole record, or for a section outline when the record is over the response budget. Records are sparse, so a name this record does not carry is rejected with the names it does. Identity metadata — the record's ID, its name, and its canonical URL — comes back alongside whatever is requested. The call is self-contained — the record is re-fetched and sliced, so no prior call has to be repeated."
}
},
"additionalProperties": false
}Fetch a single ReliefWeb report by its numeric ID with full body text, file attachments, and all metadata. Use after reliefweb_search_reports to retrieve document content — body is excluded from search results to manage context budget. Report bodies can be 10–100KB. A record over the response budget comes back as a section outline naming every section and its byte size; re-call with sections to pull only the ones needed. Nothing is truncated on either path.
| Argument | Type | Description |
|---|---|---|
| id* | integer | ReliefWeb numeric report ID. Obtained from reliefweb_search_reports results. |
| sections | array | Sections of the report record to return, named by the sections[].name values an outline response lists. Omit for the whole record, or for a section outline when the record is over the response budget. Records are sparse, so a name this record does not carry is rejected with the names it does. Identity metadata — the record's ID, its name, and its canonical URL — comes back alongside whatever is requested. The call is self-contained — the record is re-fetched and sliced, so no prior call has to be repeated. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "ReliefWeb numeric report ID. Obtained from reliefweb_search_reports results.",
"exclusiveMinimum": 0
},
"sections": {
"type": "array",
"items": {
"type": "string",
"description": "A section name exactly as the outline response spelled it."
},
"description": "Sections of the report record to return, named by the sections[].name values an outline response lists. Omit for the whole record, or for a section outline when the record is over the response budget. Records are sparse, so a name this record does not carry is rejected with the names it does. Identity metadata — the record's ID, its name, and its canonical URL — comes back alongside whatever is requested. The call is self-contained — the record is re-fetched and sliced, so no prior call has to be repeated."
}
},
"additionalProperties": false
}Fetch a training listing by ReliefWeb numeric ID with the full description, registration instructions, event link, cost and fee information, dates, languages, and organizing source. Use after reliefweb_search_training, which returns summaries without the description, registration instructions, or cost detail. Reaches concluded listings as well as current ones. A record over the response budget comes back as a section outline naming every section and its byte size; re-call with sections to pull only the ones needed. Nothing is truncated on either path.
| Argument | Type | Description |
|---|---|---|
| id* | integer | ReliefWeb numeric training ID. Obtained from reliefweb_search_training results. |
| sections | array | Sections of the training record to return, named by the sections[].name values an outline response lists. Omit for the whole record, or for a section outline when the record is over the response budget. Records are sparse, so a name this record does not carry is rejected with the names it does. Identity metadata — the record's ID, its name, and its canonical URL — comes back alongside whatever is requested. The call is self-contained — the record is re-fetched and sliced, so no prior call has to be repeated. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "ReliefWeb numeric training ID. Obtained from reliefweb_search_training results.",
"exclusiveMinimum": 0
},
"sections": {
"type": "array",
"items": {
"type": "string",
"description": "A section name exactly as the outline response spelled it."
},
"description": "Sections of the training record to return, named by the sections[].name values an outline response lists. Omit for the whole record, or for a section outline when the record is over the response budget. Records are sparse, so a name this record does not carry is rejected with the names it does. Identity metadata — the record's ID, its name, and its canonical URL — comes back alongside whatever is requested. The call is self-contained — the record is re-fetched and sliced, so no prior call has to be repeated."
}
},
"additionalProperties": false
}List all countries and territories tracked by ReliefWeb, optionally filtered to active humanitarian situations. Returns ISO3 codes and status for each entry — use the ISO3 code with reliefweb_get_country to fetch a full profile. Set crisis_only=true to limit results to countries with active humanitarian situations.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Number of results to return (1–1000, default 100). Each call counts against the 1,000-calls/day quota. |
| offset | integer | Zero-based offset for pagination. Use with limit and the totalCount enrichment field to page through results. |
| crisis_only | boolean | When true, filters to countries with an active humanitarian situation (status ongoing). Default false returns all countries. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"default": 100,
"maximum": 1000,
"minimum": 1,
"description": "Number of results to return (1–1000, default 100). Each call counts against the 1,000-calls/day quota."
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"description": "Zero-based offset for pagination. Use with limit and the totalCount enrichment field to page through results."
},
"crisis_only": {
"type": "boolean",
"description": "When true, filters to countries with an active humanitarian situation (status ongoing). Default false returns all countries."
}
},
"additionalProperties": false
}Browse source organizations that contribute content to ReliefWeb, optionally filtered by name text or organization type. Returns short names, types, and URLs. Use the shortname value with the source filter in reliefweb_search_reports, reliefweb_search_jobs, and reliefweb_search_training.
| Argument | Type | Description |
|---|---|---|
| text | string | Full-text search query. Matches against organization name and short name. |
| type | string | Organization type. One of: Non-governmental Organization, International Organization, Academic and Research Institution, Other, Government, Media, Red Cross/Red Crescent Movement. Filters on type.name. |
| limit | integer | Number of results to return (1–1000, default 10). Each call counts against the 1,000-calls/day quota. |
| offset | integer | Zero-based offset for pagination. Use with limit and the totalCount enrichment field to page through results. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"text": {
"type": "string",
"description": "Full-text search query. Matches against organization name and short name."
},
"type": {
"enum": [
"Non-governmental Organization",
"International Organization",
"Academic and Research Institution",
"Other",
"Government",
"Media",
"Red Cross/Red Crescent Movement"
],
"type": "string",
"description": "Organization type. One of: Non-governmental Organization, International Organization, Academic and Research Institution, Other, Government, Media, Red Cross/Red Crescent Movement. Filters on type.name."
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 1000,
"minimum": 1,
"description": "Number of results to return (1–1000, default 10). Each call counts against the 1,000-calls/day quota."
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"description": "Zero-based offset for pagination. Use with limit and the totalCount enrichment field to page through results."
}
},
"additionalProperties": false
}Search active and historical disasters on ReliefWeb by type, country, status, date range, and GLIDE number. Default preset covers alert, ongoing, and past disasters. Use include_archived=true to reach alert-archive entries as well, for historical research. Returns IDs suitable for use with reliefweb_get_disaster and as disaster_id filter in reliefweb_search_reports.
| Argument | Type | Description |
|---|---|---|
| sort | string | Sort order. Use date.created:desc for newest first (default), date.created:asc for oldest, score:desc for relevance. |
| text | string | Full-text search query. Matches against disaster name and description. |
| glide | string | GLIDE number (global disaster identifier, e.g., EQ-2023-000053-TUR). Use for cross-system disaster correlation. |
| limit | integer | Number of results to return (1–1000, default 10). Each call counts against the 1,000-calls/day quota. |
| offset | integer | Zero-based offset for pagination. Use with limit and the totalCount enrichment field to page through results. |
| status | string | Disaster status filter. One of: alert (newly declared), ongoing, past (resolved), alert-archive. Separate multiple values with commas; case, spacing, and punctuation are ignored, and any other value is rejected with the valid list. alert-archive is only reachable with include_archived=true — asking for it without that returns nothing. |
Search humanitarian job listings on ReliefWeb by country, organization, career category, theme, and experience level. Returns current open positions — expired postings are excluded by default. Use include_archived=true to search the full history of postings, which is far larger than the open set. Use text search for role titles and job descriptions.
| Argument | Type | Description |
|---|---|---|
| sort | string | Sort order. Use date.created:desc for newest postings first (default), date.closing:asc to surface roles closing soonest, or score:desc for relevance. |
| text | string | Full-text search query. Matches against job title, body, and key metadata fields. |
| limit | integer | Number of results to return (1–1000, default 10). Each call counts against the 1,000-calls/day quota. |
| theme | string | Sector or cross-cutting theme (e.g., Health, Food and Nutrition, Protection). Filters on theme.name. |
| offset | integer | Zero-based offset for pagination. Use with limit and the totalCount enrichment field to page through results. |
| source | string | Organization short name (e.g., UNHCR, OCHA, WFP). Filters on source.shortname. |
| country | string |
Search humanitarian reports on ReliefWeb with filtering by country, disaster, format, theme, language, source, and date. Returns paginated summaries — use reliefweb_get_report to fetch full body text. Report body is excluded from results (10–100KB each); call get_report when document content is needed. Every report is reachable by default — reports have no archived class, so include_archived has no effect here. Note: each call counts against the 1,000 calls/day quota.
| Argument | Type | Description |
|---|---|---|
| sort | string | Sort order. Use date.original:desc for newest first (default), date.original:asc for oldest first, score:desc for relevance. |
| text | string | Full-text search query. Matches against title, body, and key metadata fields. Use plain natural language or keywords. |
| limit | integer | Number of results to return (1–1000, default 10). Use a smaller value for targeted lookups; larger for bulk research. Each call counts against the 1,000-calls/day quota. |
| theme | string | Sector or cross-cutting theme (e.g., Health, Food and Nutrition, Shelter and Non-Food Items, Protection). Open-ended — matches theme.name exactly as ReliefWeb spells it. |
| filter | object | Raw ReliefWeb filter object for compound conditions not covered by named params. Example: {"operator": "AND", "conditions": [{"field": "format.name", "value": "Map"}, {"field": "language.code", "value": "fr"}]}. |
Search humanitarian training and learning opportunities on ReliefWeb by country, format, date, source, career category, and language. Covers on-site and online capacity-building events. Training date fields use date.start / date.end — different from report date fields. Use date_start_from and date_start_to to find upcoming training within a window. Results default to soonest-starting first (date.start:asc). With neither date bound supplied the search is scoped to training starting from now, so the first page is upcoming opportunities; supply either bound to search an explicit range, including a historical one. Use include_archived=true to search concluded listings as well, which are far more numerous than the current ones.
| Argument | Type | Description |
|---|---|---|
| sort | string | Sort order. Use date.start:asc for soonest-starting training first (default), date.start:desc for latest-starting, date.created:desc for most recently posted, or score:desc for relevance. |
| text | string | Full-text search query. Matches against training title and description. |
| limit | integer | Number of results to return (1–1000, default 10). Each call counts against the 1,000-calls/day quota. |
| format | string | Training format. Valid values: on-site, online. Filters on format.name. |
| offset | integer | Zero-based offset for pagination. Use with limit and the totalCount enrichment field to page through results. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "ReliefWeb numeric disaster ID. Obtained from reliefweb_search_disasters results.",
"exclusiveMinimum": 0
},
"archive": {
"type": "object",
"required": [
"list"
],
"properties": {
"list": {
"enum": [
"keyContent",
"appealsResponsePlans",
"usefulLinks"
],
"type": "string",
"description": "Which curated list to page. The archived entries of that list are the ones the profile itself leaves out."
},
"limit": {
"type": "integer",
"default": 25,
"maximum": 100,
"minimum": 1,
"description": "Maximum archived entries in one page (1-100)."
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"description": "Zero-based index of the first archived entry to return. Send back the nextOffset from the previous page to continue."
}
},
"description": "Archive mode: return a page of one curated list's ARCHIVED entries instead of the disaster record. The response carries the record identity, the selected list, and total / shown / offset, plus a next offset while more entries remain. Mutually exclusive with sections — sections slices the record, archive replaces it — and a call supplying both is rejected. A record over the response budget still answers an archive call with the page: a page is bounded by limit and carries none of the record prose, so it never outlines."
},
"sections": {
"type": "array",
"items": {
"type": "string",
"description": "A section name exactly as the outline response spelled it."
},
"description": "Sections of the disaster record to return, named by the sections[].name values an outline response lists. Omit for the whole record, or for a section outline when the record is over the response budget. Records are sparse, so a name this record does not carry is rejected with the names it does. Identity metadata — the record's ID, its name, and its canonical URL — comes back alongside whatever is requested. The call is self-contained — the record is re-fetched and sliced, so no prior call has to be repeated. This names parts of the record itself and never reaches archived entries — use archive for those."
}
},
"additionalProperties": false
}| country | string | ISO 3166-1 alpha-3 country code (e.g., SYR, AFG, UKR). Filters to disasters tagged with this country. |
| date_to | any | Latest disaster creation date. Pair with date_from for a date range. A bare calendar date resolves to end of that day in UTC, so the range covers it in full; a datetime carrying any offset is resolved to UTC. |
| date_from | any | Earliest disaster creation date. Filters on date.created. A bare calendar date such as 2024-01-15 is accepted and resolves to start of that day in UTC; a datetime carrying any offset is resolved to UTC. |
| disaster_type | string | Disaster type name (e.g., Earthquake, Flood, Drought, Cyclone). Filters on type.name. |
| include_archived | boolean | Include alert-archive disasters in results, alongside alert, ongoing, and past. Uses preset=analysis. Off by default. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"sort": {
"type": "string",
"description": "Sort order. Use date.created:desc for newest first (default), date.created:asc for oldest, score:desc for relevance."
},
"text": {
"type": "string",
"description": "Full-text search query. Matches against disaster name and description."
},
"glide": {
"type": "string",
"description": "GLIDE number (global disaster identifier, e.g., EQ-2023-000053-TUR). Use for cross-system disaster correlation."
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 1000,
"minimum": 1,
"description": "Number of results to return (1–1000, default 10). Each call counts against the 1,000-calls/day quota."
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"description": "Zero-based offset for pagination. Use with limit and the totalCount enrichment field to page through results."
},
"status": {
"type": "string",
"description": "Disaster status filter. One of: alert (newly declared), ongoing, past (resolved), alert-archive. Separate multiple values with commas; case, spacing, and punctuation are ignored, and any other value is rejected with the valid list. alert-archive is only reachable with include_archived=true — asking for it without that returns nothing."
},
"country": {
"type": "string",
"description": "ISO 3166-1 alpha-3 country code (e.g., SYR, AFG, UKR). Filters to disasters tagged with this country."
},
"date_to": {
"anyOf": [
{
"type": "string",
"const": ""
},
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d+)?)?(?:Z|[+-]\\d{2}:?\\d{2})?)?$",
"description": "Calendar date (2024-01-31) or full ISO 8601 datetime (2024-01-31T23:59:59+00:00)."
}
],
"description": "Latest disaster creation date. Pair with date_from for a date range. A bare calendar date resolves to end of that day in UTC, so the range covers it in full; a datetime carrying any offset is resolved to UTC."
},
"date_from": {
"anyOf": [
{
"type": "string",
"const": ""
},
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d+)?)?(?:Z|[+-]\\d{2}:?\\d{2})?)?$",
"description": "Calendar date (2024-01-15) or full ISO 8601 datetime (2024-01-15T00:00:00+00:00)."
}
],
"description": "Earliest disaster creation date. Filters on date.created. A bare calendar date such as 2024-01-15 is accepted and resolves to start of that day in UTC; a datetime carrying any offset is resolved to UTC."
},
"disaster_type": {
"type": "string",
"description": "Disaster type name (e.g., Earthquake, Flood, Drought, Cyclone). Filters on type.name."
},
"include_archived": {
"type": "boolean",
"description": "Include alert-archive disasters in results, alongside alert, ongoing, and past. Uses preset=analysis. Off by default."
}
},
"additionalProperties": false
}| ISO 3166-1 alpha-3 country code (e.g., SYR, AFG, UKR). Filters to jobs tagged with this country. |
| experience | string | Experience level (e.g., 0-2 years, 3-4 years, 5-9 years). Filters on experience.name. |
| career_category | string | Humanitarian career track (e.g., Programme and Project Management, Information and Communications Technology, Logistics and Telecommunications). Filters on career_categories.name. |
| include_archived | boolean | Search expired postings alongside the open ones. Uses preset=analysis. Off by default — the open set is a small fraction of the archive, so turn this on for labour-market history rather than for a hiring snapshot. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"sort": {
"type": "string",
"description": "Sort order. Use date.created:desc for newest postings first (default), date.closing:asc to surface roles closing soonest, or score:desc for relevance."
},
"text": {
"type": "string",
"description": "Full-text search query. Matches against job title, body, and key metadata fields."
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 1000,
"minimum": 1,
"description": "Number of results to return (1–1000, default 10). Each call counts against the 1,000-calls/day quota."
},
"theme": {
"type": "string",
"description": "Sector or cross-cutting theme (e.g., Health, Food and Nutrition, Protection). Filters on theme.name."
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"description": "Zero-based offset for pagination. Use with limit and the totalCount enrichment field to page through results."
},
"source": {
"type": "string",
"description": "Organization short name (e.g., UNHCR, OCHA, WFP). Filters on source.shortname."
},
"country": {
"type": "string",
"description": "ISO 3166-1 alpha-3 country code (e.g., SYR, AFG, UKR). Filters to jobs tagged with this country."
},
"experience": {
"type": "string",
"description": "Experience level (e.g., 0-2 years, 3-4 years, 5-9 years). Filters on experience.name."
},
"career_category": {
"type": "string",
"description": "Humanitarian career track (e.g., Programme and Project Management, Information and Communications Technology, Logistics and Telecommunications). Filters on career_categories.name."
},
"include_archived": {
"type": "boolean",
"description": "Search expired postings alongside the open ones. Uses preset=analysis. Off by default — the open set is a small fraction of the archive, so turn this on for labour-market history rather than for a hiring snapshot."
}
},
"additionalProperties": false
}| format |
| string |
| Content format filter. One of: News and Press Release, Situation Report, Map, Infographic, Analysis, Other, Assessment, Manual and Guideline, Appeal, UN Document, Evaluation and Lessons Learned. Case, spacing, and punctuation are ignored; any other value is rejected with the valid list. |
| offset | integer | Zero-based offset for pagination. Use with limit and the totalCount enrichment field to page through large result sets. |
| source | string | Organization short name (e.g., UNHCR, OCHA, WFP). Filters on source.shortname. |
| country | string | ISO 3166-1 alpha-3 country code (e.g., SYR, AFG, UKR). Filters to content tagged with this country. |
| date_to | any | Latest publication date. Pair with date_from for a date range. A bare calendar date resolves to end of that day in UTC, so the range covers it in full; a datetime carrying any offset is resolved to UTC. |
| language | string | ISO 639-1 language code (e.g., en, fr, es, ar). Filters on language.code. |
| date_from | any | Earliest publication date. Filters on date.original (source publication date). A bare calendar date such as 2024-01-15 is accepted and resolves to start of that day in UTC; a datetime carrying any offset is resolved to UTC. |
| disaster_id | integer | ReliefWeb numeric disaster ID. Filters to reports linked to a specific disaster. Get the ID from reliefweb_search_disasters. |
| include_archived | boolean | No effect on reports. Reports have no archived class — every report is already in scope, whatever this is set to. Kept so existing calls that pass it keep working; it is meaningful on reliefweb_search_jobs, reliefweb_search_training, and reliefweb_search_disasters. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"sort": {
"type": "string",
"description": "Sort order. Use date.original:desc for newest first (default), date.original:asc for oldest first, score:desc for relevance."
},
"text": {
"type": "string",
"description": "Full-text search query. Matches against title, body, and key metadata fields. Use plain natural language or keywords."
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 1000,
"minimum": 1,
"description": "Number of results to return (1–1000, default 10). Use a smaller value for targeted lookups; larger for bulk research. Each call counts against the 1,000-calls/day quota."
},
"theme": {
"type": "string",
"description": "Sector or cross-cutting theme (e.g., Health, Food and Nutrition, Shelter and Non-Food Items, Protection). Open-ended — matches theme.name exactly as ReliefWeb spells it."
},
"filter": {
"type": "object",
"description": "Raw ReliefWeb filter object for compound conditions not covered by named params. Example: {\"operator\": \"AND\", \"conditions\": [{\"field\": \"format.name\", \"value\": \"Map\"}, {\"field\": \"language.code\", \"value\": \"fr\"}]}.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"format": {
"type": "string",
"description": "Content format filter. One of: News and Press Release, Situation Report, Map, Infographic, Analysis, Other, Assessment, Manual and Guideline, Appeal, UN Document, Evaluation and Lessons Learned. Case, spacing, and punctuation are ignored; any other value is rejected with the valid list."
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"description": "Zero-based offset for pagination. Use with limit and the totalCount enrichment field to page through large result sets."
},
"source": {
"type": "string",
"description": "Organization short name (e.g., UNHCR, OCHA, WFP). Filters on source.shortname."
},
"country": {
"type": "string",
"description": "ISO 3166-1 alpha-3 country code (e.g., SYR, AFG, UKR). Filters to content tagged with this country."
},
"date_to": {
"anyOf": [
{
"type": "string",
"const": ""
},
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d+)?)?(?:Z|[+-]\\d{2}:?\\d{2})?)?$",
"description": "Calendar date (2024-01-31) or full ISO 8601 datetime (2024-01-31T23:59:59+00:00)."
}
],
"description": "Latest publication date. Pair with date_from for a date range. A bare calendar date resolves to end of that day in UTC, so the range covers it in full; a datetime carrying any offset is resolved to UTC."
},
"language": {
"type": "string",
"description": "ISO 639-1 language code (e.g., en, fr, es, ar). Filters on language.code."
},
"date_from": {
"anyOf": [
{
"type": "string",
"const": ""
},
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d+)?)?(?:Z|[+-]\\d{2}:?\\d{2})?)?$",
"description": "Calendar date (2024-01-15) or full ISO 8601 datetime (2024-01-15T00:00:00+00:00)."
}
],
"description": "Earliest publication date. Filters on date.original (source publication date). A bare calendar date such as 2024-01-15 is accepted and resolves to start of that day in UTC; a datetime carrying any offset is resolved to UTC."
},
"disaster_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "ReliefWeb numeric disaster ID. Filters to reports linked to a specific disaster. Get the ID from reliefweb_search_disasters."
},
"include_archived": {
"type": "boolean",
"description": "No effect on reports. Reports have no archived class — every report is already in scope, whatever this is set to. Kept so existing calls that pass it keep working; it is meaningful on reliefweb_search_jobs, reliefweb_search_training, and reliefweb_search_disasters."
}
},
"additionalProperties": false
}| source |
| string |
| Organization short name. Filters on source.shortname. |
| country | string | ISO 3166-1 alpha-3 country code (e.g., KEN, ETH, COD). Filters to training tagged with this country. |
| language | string | ISO 639-1 language code (e.g., en, fr, es). Filters on language.code. |
| date_start_to | any | Training start date upper bound. Filters on date.start — pair with date_start_from for a window. A bare calendar date resolves to end of that day in UTC, and a datetime carrying any offset is resolved to UTC. Supplying this alone searches everything up to it, with no lower bound injected. |
| career_category | string | Humanitarian career track (e.g., Programme and Project Management, Information and Communications Technology). Filters on career_categories.name. |
| date_start_from | any | Training start date lower bound. Filters on date.start — use to find training starting after a given date. A bare calendar date resolves to start of that day in UTC, and a datetime carrying any offset is resolved to UTC. Omit this and date_start_to together to default the search to training starting from now, unless include_archived is set, which leaves the range open. |
| include_archived | boolean | Search concluded listings alongside the current ones. Uses preset=analysis. Off by default. Setting this also drops the start-from-now default bound, so an otherwise unbounded search reaches back through the whole record; pair it with date_start_from and date_start_to to study a specific period. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"sort": {
"type": "string",
"description": "Sort order. Use date.start:asc for soonest-starting training first (default), date.start:desc for latest-starting, date.created:desc for most recently posted, or score:desc for relevance."
},
"text": {
"type": "string",
"description": "Full-text search query. Matches against training title and description."
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 1000,
"minimum": 1,
"description": "Number of results to return (1–1000, default 10). Each call counts against the 1,000-calls/day quota."
},
"format": {
"enum": [
"on-site",
"online"
],
"type": "string",
"description": "Training format. Valid values: on-site, online. Filters on format.name."
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"description": "Zero-based offset for pagination. Use with limit and the totalCount enrichment field to page through results."
},
"source": {
"type": "string",
"description": "Organization short name. Filters on source.shortname."
},
"country": {
"type": "string",
"description": "ISO 3166-1 alpha-3 country code (e.g., KEN, ETH, COD). Filters to training tagged with this country."
},
"language": {
"type": "string",
"description": "ISO 639-1 language code (e.g., en, fr, es). Filters on language.code."
},
"date_start_to": {
"anyOf": [
{
"type": "string",
"const": ""
},
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d+)?)?(?:Z|[+-]\\d{2}:?\\d{2})?)?$",
"description": "Calendar date (2024-12-31) or full ISO 8601 datetime (2024-12-31T23:59:59+00:00)."
}
],
"description": "Training start date upper bound. Filters on date.start — pair with date_start_from for a window. A bare calendar date resolves to end of that day in UTC, and a datetime carrying any offset is resolved to UTC. Supplying this alone searches everything up to it, with no lower bound injected."
},
"career_category": {
"type": "string",
"description": "Humanitarian career track (e.g., Programme and Project Management, Information and Communications Technology). Filters on career_categories.name."
},
"date_start_from": {
"anyOf": [
{
"type": "string",
"const": ""
},
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d+)?)?(?:Z|[+-]\\d{2}:?\\d{2})?)?$",
"description": "Calendar date (2024-06-01) or full ISO 8601 datetime (2024-06-01T00:00:00+00:00)."
}
],
"description": "Training start date lower bound. Filters on date.start — use to find training starting after a given date. A bare calendar date resolves to start of that day in UTC, and a datetime carrying any offset is resolved to UTC. Omit this and date_start_to together to default the search to training starting from now, unless include_archived is set, which leaves the range open."
},
"include_archived": {
"type": "boolean",
"description": "Search concluded listings alongside the current ones. Uses preset=analysis. Off by default. Setting this also drops the start-from-now default bound, so an otherwise unbounded search reaches back through the whole record; pair it with date_start_from and date_start_to to study a specific period."
}
},
"additionalProperties": false
}