# DO.FR.04 Farmer

### DO.DR.04 Farmer

This data object provides comprehensive information about various aspects of farmers' personal and agricultural activities. This information is organised into five key categories, each offering various insights. These categories include:

1. **Personal identification details:** This section contains vital information that uniquely identifies and verifies each farmer. It includes personal details such as full name, contact information, and demographic data like age and gender, as well as official identification numbers.
2. **Household details:** This section contains details of the farmer's household, including its size, family member information, and socio-economic factors that may influence farming activities, such as education levels of household members.
3. **Farm details:** This section contains essential agricultural information related to the farmer, such as land size, ownership status, and specifics about the farmers' farming activities.
4. **Machinery and equipment details:** This section outlines the equipment owned by the farmer that is used in their farming activities.

The information contained in this data object primarily references the [World Programme for the Census of Agriculture 2020 ](https://openknowledge.fao.org/server/api/core/bitstreams/c5afd226-08ab-4cda-bc45-871f1f95a3be/content)and the [Guidelines on International Classifications for Agricultural Statistics](https://unstats.un.org/unsd/classifications/expertgroup/egm2017/ac340-Bk2.PDF). The two documents contain various international classifications for agricultural statistics.

The list of international classifications referenced in the two documents can be found [here](https://www.fao.org/statistics/caliper/tools/download/en).

<table><thead><tr><th width="232">Attribute</th><th width="188">Type</th><th width="109">Cardinality</th><th>Description</th></tr></thead><tbody><tr><td>farmer_personal_details</td><td><a data-mention href="/pages/7aBY80jRUcDeRXBTOMvk">/pages/7aBY80jRUcDeRXBTOMvk</a></td><td>0...1</td><td>Personal identification details of the farmer</td></tr><tr><td>family_details</td><td><a data-mention href="/pages/m924tFTBBv4PySbBul58">/pages/m924tFTBBv4PySbBul58</a></td><td>0...1</td><td>Family/household information of the farmer</td></tr><tr><td>farm_details</td><td><a data-mention href="/pages/DcajX33bVhGGjDmy7rVr">/pages/DcajX33bVhGGjDmy7rVr</a></td><td>0...*</td><td>Details of the farmer's farm</td></tr><tr><td>machineries_details</td><td><a data-mention href="/pages/CADCaQTeVKzjLleJf1Pj">/pages/CADCaQTeVKzjLleJf1Pj</a></td><td>0...*</td><td>Details of the machinery owned by the farmer </td></tr><tr><td>additional_attributes</td><td><a data-mention href="/spaces/F9fu0tIY1rJUsF03WdAv/pages/9N8tb1uyZsNZ0hqrofMZ">/spaces/F9fu0tIY1rJUsF03WdAv/pages/9N8tb1uyZsNZ0hqrofMZ</a></td><td>0...*</td><td>Additional context/country specific attributes</td></tr><tr><td>registration_date</td><td><a data-mention href="/spaces/F9fu0tIY1rJUsF03WdAv/pages/HzeJPTMw9koOgH2lEKt8">/spaces/F9fu0tIY1rJUsF03WdAv/pages/HzeJPTMw9koOgH2lEKt8</a></td><td>0...1</td><td>Date the farmer was registered in the FR</td></tr><tr><td>last_updated</td><td><a data-mention href="/spaces/F9fu0tIY1rJUsF03WdAv/pages/HzeJPTMw9koOgH2lEKt8">/spaces/F9fu0tIY1rJUsF03WdAv/pages/HzeJPTMw9koOgH2lEKt8</a></td><td>0...1</td><td>Date the farmer's record was last updated</td></tr></tbody></table>

### Example of JSON Data Structure for an FRperson

```json
{
    "famer_personal_details": {
        "member_identifier": {
            "identifier_type": "NationalID",
            "identifier_value": "M123456"
        },
        "demographic_info": {
            "identifier": {
                "identifier_type": "NationalID",
                "identifier_value": "M123456"
            },
            "name": {
                "first_name": "John",
                "last_name": "Doe"
            },
            "date_of_birth": "1990-05-15T00:00:00Z",
            "gender": "Male"
        }
    },
    "family_details": {
        "group_identifier": [
            {
                "identifier_type": "NationalID",
                "identifier_value": "G9876543210"
            }
        ],
        "group_type": "family",
        "poverty_score": 45.2,
        "poverty_score_type": "income-based",
        "group_head_info": {
            "member_identifier": [
                {
                    "identifier_type": "NationalID",
                    "identifier_value": "M123456"
                }
            ],
            "demographic_info": {
                "identifier": {
                    "identifier_type": "NationalID",
                    "identifier_value": "M123456"
                },
                "name": {
                    "first_name": "John",
                    "last_name": "Doe"
                },
                "date_of_birth": "1990-05-15T00:00:00Z",
                "gender": "Male"
            },
            "is_disabled": false,
            "marital_status": "married",
            "registration_date": "1990-06-10T08:00:00Z"
        },
        "group_size": 2,
        "member_list": [
            {
                "member_identifier": [
                    {
                        "@type": "Identifier",
                        "identifier_type": "NationalID",
                        "identifier_value": "M9876543210"
                    }
                ],
                "demographic_info": {
                    "spdci:identifier": [
                        {
                            "@type": "Identifier",
                            "identifier_type": "NationalID",
                            "identifier_value": "1234567890"
                        }
                    ],
                    "name": {
                        "@type": "Name",
                        "surname": "Doe",
                        "given_name": "Jane",
                        "prefix": "Mr.",
                        "suffix": ""
                    },
                    "sex": "female",
                    "birth_date": "1982-03-15T00:00:00Z",
                    "registration_date": "2022-01-10T08:00:00Z"
                },
                "is_disabled": false,
                "marital_status": "married",
                "registration_date": "2022-01-10T08:00:00Z"
            }
        ],
        "registration_date": "2022-01-10T08:00:00Z",
        "last_updated": "2023-06-15T10:00:00Z"
    },
    "farm_type": "Small subsistence-oriented farms",
    "farm_details": [{
        "place": {
            "name": "Koh Samui",
            "geo": {
                "@type": "spdci:GeoLocation",
                "latitude": 9.5604,
                "longitude": 100.0245
            }
        },
        "land_tenure": "Leased (Rented from someone else)",
        "land_size": 3000,
        "measurement": "Acre",
        "farming_activities": [
            {
                "crop_production": [
                    {
                        "activity_group": "perennial crops",
                        "crop_type": "Fruit and nuts",
                        "variety": "local",
                        "season": "winter",
                        "end_use": [
                            "Food for human consumption"
                        ],
                        "irrigation": true,
                        "irrigation_water": [
                            "Mixed surface water and groundwater"
                        ],
                        "fertilizer_type": [
                            "Organic fertilizers"
                        ],
                        "registration_date": "2023-01-10T00:00:00Z",
                        "last_updated": "2023-09-20T00:00:00Z"
                    }
                ],
                "animal_production": [
                    {
                        "type": "Sheep and goats",
                        "count": 10,
                        "livestock_system": "Mixed system",
                        "registration_date": "2023-01-10T00:00:00Z",
                        "last_updated": "2023-09-20T00:00:00Z"
                    }
                ],
                "mixed_farming": true,
                "agri_support_activities": [
                    "Support activities for crop production"
                ],
                "aqua_support_activities": "Support activities for fishing and aquaculture",
                "aqua_culture": [
                    "Marine aquafarming"
                ],
                "agroforestry": [
                    "Reforestation (replanting trees)"
                ],
                "registration_date": "2023-06-15T08:00:00Z",
                "last_updated": "2023-06-15T10:00:00Z"
            }
        ],
        "registration_date": "2022-01-10T08:00:00Z",
        "last_updated": "2023-06-15T10:00:00Z"
    }],
    "machineries_details": [
        {
            "type": "Machine powered equipment",
            "count": 2,
            "equipement_source": "Provided by a cooperative",
            "registration_date": "2022-01-10T08:00:00Z",
            "last_updated": "2023-06-15T10:00:00Z"
        }
    ],
    "registration_date": "2023-01-10T00:00:00Z",
    "last_updated": "2023-09-20T00:00:00Z"
}
```

### JSON-LD File on GitHub


---

# 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://standards.spdci.org/standards/dci-standards/wip-farmers-registry/farmers-registry-and-sp-system-interface/1.-crvs/data/data-objects/do.fr.04-farmer.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.
