---
title: "Get food security data"
method: GET
path: "/api/v2/food-security-nutrition-poverty/food-security"
tags: ["Food Security, Nutrition & Poverty"]
---

# Get food security data

`GET /api/v2/food-security-nutrition-poverty/food-security`

## Request

- Base URL: `https://data.humdata.org/api/3/action`
- URL: `https://data.humdata.org/api/3/action/api/v2/food-security-nutrition-poverty/food-security`
- Auth: one of:
  - none
  - API key in header `Authorization`

Integrated Food Security Phase Classification from the IPC. See the more detailed technical <a href="https://hdx-hapi.readthedocs.io/en/latest/data_usage_guides/food_security_and_nutrition/#food-security">HDX HAPI documentation</a>, and the <a href="https://www.ipcinfo.org/ipcinfo-website/ipc-overview-and-classification-system/ipc-acute-food-insecurity-classification/en/">original IPC source</a> website.

## Query parameters

- `app_identifier` string, nullable, required: base64 encoded application name and email, as in `base64("app_name:email")`. This value can also be passed in the `X-HDX-HAPI-APP-IDENTIFIER` header. See the *encoded_app_identifier* endpoint.
- `ipc_phase` '1' | '2' | '3' | '4' | '5' | '3+' | 'all', nullable
- `ipc_type` 'current' | 'first projection' | 'second projection', nullable
- `has_hrp` boolean, nullable: Filter the response by the has_hrp flag. The has_hrp flag indicates whether a country has a Humanitarian Response Plan.
- `in_gho` boolean, nullable: Filter the response by the in_gho flag. The in_gho flag indicates whether a country is in the <a href="https://humanitarianaction.info/">Global Humanitarian Overview</a>.
- `start_date` string, nullable: Filter entries to include rows where the reference period overlaps with or extends beyond this date, e.g. 2020, 2020-01, 2020-01-01 or 2020-01-01T00:00:00
- `end_date` string, nullable: Filter entries to include rows where the reference period overlaps with or begins prior to this date, e.g. 2020, 2020-01, 2020-01-01, 2020-01-01 or 2020-01-01T23:59:59
- `location_code` string, nullable: Filter the response by a location (typically a country). The location codes use the ISO-3 (ISO 3166 alpha-3) codes. See the <a href="/docs#/Metadata/get_locations_api_v1_metadata_location_get" target="_blank">location endpoint</a> for details.
- `location_name` string, nullable: Filter the response by a location (typically a country). The location names are based on the "short name" from the <a href="https://unstats.un.org/unsd/methodology/m49/#fn2">UN M49 Standard</a>. See the <a href="/docs#/Metadata/get_locations_api_v1_metadata_location_get" target="_blank">location endpoint</a> for details.
- `admin1_code` string, nullable: Filter the response by the 1st subnational administrative divisions. The admin1 codes refer to the p-codes in the <a href="https://data.humdata.org/dashboards/cod?">Common Operational Datasets</a>. See the <a href="/docs#/Metadata/get_admin1_api_v1_metadata_admin1_get" target="_blank">admin1 endpoint</a> for details.
- `admin1_name` string, nullable: Filter the response by the 1st subnational administrative divisions. The admin1 names refer to either the <a href="https://data.humdata.org/dashboards/cod?">Common Operational Datasets</a> or those provided in the original data source. See the <a href="/docs#/Metadata/get_admin1_api_v1_metadata_admin1_get" target="_blank">admin1 endpoint</a> for details.
- `admin2_code` string, nullable: Filter the response by the 2nd subnational administrative divisions. The admin2 codes refer to the p-codes in the <a href="https://data.humdata.org/dashboards/cod?">Common Operational Datasets</a>. See the <a href="/docs#/Metadata/get_admin2_api_v1_metadata_admin2_get" target="_blank">admin2 endpoint</a> for details.
- `admin2_name` string, nullable: Filter the response by the 2nd subnational administrative divisions. The admin2 names refer to either the <a href="https://data.humdata.org/dashboards/cod?">Common Operational Datasets</a> or those provided in the original data source. See the <a href="/docs#/Metadata/get_admin2_api_v1_metadata_admin2_get" target="_blank">admin2 endpoint</a> for details.
- `admin_level` '0' | '1' | '2', nullable
- `output_format` 'csv' | 'json'
- `limit` integer: Maximum number of records to return. The system will not return more than 10,000 records.
- `offset` integer: Number of records to skip in the response. Use in conjunction with the limit parameter to paginate.

## Response `200`

Successful Response

- HapiGenericResponseFoodSecurityResponse
  - `data` FoodSecurityResponse[], required
    - `location_code` string, required: A location (typically a country). The location codes use the ISO-3 (ISO 3166 alpha-3) codes.
    - `location_name` string, required: A location (typically a country). The location names are based on the "short name" from the <a href="https://unstats.un.org/unsd/methodology/m49/#fn2">UN M49 Standard</a>.
    - `admin1_code` string, nullable, required: The 1st subnational administrative divisions. The admin1 codes refer to the p-codes in the <a href="https://data.humdata.org/dashboards/cod?">Common Operational Datasets</a>.
    - `admin1_name` string, nullable, required: The 1st subnational administrative divisions. The admin1 names refer to either the <a href="https://data.humdata.org/dashboards/cod?">Common Operational Datasets</a> or those provided in the original data source.
    - `admin2_code` string, nullable, required: The 2nd subnational administrative divisions. The admin2 codes refer to the p-codes in the <a href="https://data.humdata.org/dashboards/cod?">Common Operational Datasets</a>.
    - `admin2_name` string, nullable, required: The 2nd subnational administrative divisions. The admin2 names refer to either the <a href="https://data.humdata.org/dashboards/cod?">Common Operational Datasets</a> or those provided in the original data source.
    - `admin_level` integer, required: Admin level.
    - `resource_hdx_id` string, required: Filter the response by the resource ID, which is a unique and fixed identifier of a resource on HDX. A URL in the pattern of `https://data.humdata.org/dataset/[dataset_hdx_id]/resource/[resource_hdx_id]` will load the resource page on HDX.
    - `ipc_phase` string, required: The IPC phase, available values are described <a href="https://hdx-hapi.readthedocs.io/en/latest/data_usage_guides/enums/#ipc-code">here.</a>
    - `ipc_type` string, required: The IPC type, available values are described <a href="https://hdx-hapi.readthedocs.io/en/latest/data_usage_guides/enums/#ipc-type">here.</a>
    - `population_in_phase` integer, required: The number of people in the IPC phase
    - `population_fraction_in_phase` number, required: The fraction of people in the IPC phase
    - `reference_period_start` string, date-time, nullable, required: The start date for which the data are applicable
    - `reference_period_end` string, date-time, nullable, required: The end date for which the data are applicable

## Other responses

- `400`: Bad Request
- `422`: Validation Error
- `500`: Internal Server Error

---

[API](https://skmtc.dev/humdata/apis/hdx-apis.md) - [All operations](https://skmtc.dev/humdata/apis/hdx-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/humdata/apis/hdx-apis/revisions/cc1970bc392c?raw)
