> 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="/standards/dci-standards/wip-farmers-registry/farmers-registry-and-sp-system-interface/1.-crvs/data/data-objects/do.fr.02-member.md">DO.FR.02 Member</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="/standards/dci-standards/wip-farmers-registry/farmers-registry-and-sp-system-interface/1.-crvs/data/data-objects/do.fr.03-group.md">DO.FR.03 Group</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="/standards/dci-standards/wip-farmers-registry/farmers-registry-and-sp-system-interface/1.-crvs/data/data-objects/do.fr.05-farminfo.md">DO.FR.05 FarmInfo</a></td><td>0...*</td><td>Details of the farmer's farm</td></tr><tr><td>machineries_details</td><td><a data-mention href="/standards/dci-standards/wip-farmers-registry/farmers-registry-and-sp-system-interface/1.-crvs/data/data-objects/do.fr.09-machinery.md">DO.FR.09 Machinery</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="/standards/standards-for-interoperability-interfaces/common-standards-for-interoperability-interfaces/data/data-types-and-formats/dt.com.05-array.md">DT.COM.05 array</a></td><td>0...*</td><td>Additional context/country specific attributes</td></tr><tr><td>registration_date</td><td><a data-mention href="/standards/standards-for-interoperability-interfaces/common-standards-for-interoperability-interfaces/data/data-types-and-formats/dt.com.02-string/data-formats/df.com.string.01-date_time.md">DF.COM.STRING.01 date_time</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="/standards/standards-for-interoperability-interfaces/common-standards-for-interoperability-interfaces/data/data-types-and-formats/dt.com.02-string/data-formats/df.com.string.01-date_time.md">DF.COM.STRING.01 date_time</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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
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=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.