> For the complete documentation index, see [llms.txt](https://standards.spdci.org/standards/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](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).

# 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` 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>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
