Systems availability
Generic selectors
Exact matches only
Search in title
Search in content
Post Type Selectors

Validation Services API Audit Guide

The following is a reference guide to the attributes and values that are a part of the certification process for each standard. Each field name has an API key that must be specified, followed by the value, or answer, for that field. This may take the form of a single selection from a list, a free form writing field, multiple selection of set values, number, etc. This document will be updated with additional standards as they become available in Validation Services.  

Example API Body

The following is an example of a call that could be used to set the attributes for an audit. This is to give you a reference point of how the attributes and values would be entered. In this example, the user has already created an audit, and is only updating the audit to include the information shown.

{
"apiKey": "audit_abcd1234-abcd-1234-abcd-12345678abc",
    "auditStatus": "UPDATED",
    "ggn": "1234567891011",
    "lastModified": "2023-11-03T11:46:11+01:00",
    "auditDate": "2023-10-10",
    "moduleApiKey": "module_f5d1aed3-6c1d-42f9-bd28-ea3765fad16f",
    "moduleName": "Integrated Farm Assurance version 6 Smart Plants Option 1 Individual certification",
    "moduleShortName": "IFA 6 Smart Plants Option 1",
    "productOption": null,
    "validFrom": "2023-10-10",
    "validTo": "2024-10-09",
    "maxValidTo": "2024-10-09",
    "extensionReason": null,
 "auditor": {
    "contactId": "abc12345-abc1-23ab-a123-12345679",
    "firstName": "John",
    "lastName": "Doe",
      "email": null

  },
  "authorizingPerson": {
    "contactId": "abc12345-abc1-23ab-a123-12345678",
    "firstName": "Jane",
    "lastName": "Doe",
      "email": null
  },
  "legalEntityType": "PRODUCERGROUP",
    "legalEntityName": "Test",
 "address": {
        "apiKey": "address_abcd1234-abcd-1234-abcd-12345678abc",
        "streetName": "test street",
        "houseNumber": "123",
        "city": "Test city",
        "email": null,
        "zipCode": "1234567",
        "country": "DEU",
        "longitude": "12.345670",
        "latitude": "-12.345670"
    },
    "mainSite": {
        "apiKey": "site_1234-1234-1234-1234-1234567",
        "ggn": "12334567891011",
        "type": "SITE",
        "mainSite": true,
        "name": "Test Farm 1",
        "address": {
            "apiKey": "address_abcd1234-abcd-1234-abcd-12345678abc",
            "streetName": "test street",
            "houseNumber": "123",
            "city": "Test city",
            "email": null,
            "zipCode": "1234567",
            "country": "DEU",
            "longitude": "12.345670",
            "latitude": "-12.345670"
        }
    },
    "certificateAttributes": [
        {
            "apiKey": "module_certificate_attribute_9b0a8357-766d-40f8-8f56-f2b8580e459e",
            "name": "Date of certification decision",
            "values": [
                "2023-10-11"
            ]
        },
        {
            "apiKey": "module_certificate_attribute_6219f9a7-1d24-449c-8a82-9618fd4c7185",
            "name": "Audit Method",
            "values": [
                "module_certificate_attribute_options_6290a3af-3001-440d-af60-192648a3c43d"
            ]
        },
        {
            "apiKey": "module_certificate_attribute_4e351b6f-7ff8-49b9-b200-7e4efd3e279f",
            "name": "Type of audit",
            "values": [
                "module_certificate_attribute_options_594cdedd-b7bf-4e74-9045-794c83c43be9"
            ]
        }
    ],
    "memberAttributes": [],
    "siteAttributes": [],
    "auditSiteProducts": [
        {
            "apiKey": "audit_site_product_18364393-52f6-4d3e-a0b3-21597cac5b30",
            "productApiKey": "product_2",
            "site": {
                "apiKey": "site_abcd1234-abcd-1234-abcd-12345678abc",
                "ggn": "1234567891011",
                "type": "SITE",
                "mainSite": true,
                "name": "Test Farm 1",
                "address": {
            "apiKey": "address_abcd1234-abcd-1234-abcd-12345678abc",
            "streetName": "test street",
            "houseNumber": "123",
            "city": "Test city",
            "email": null,
            "zipCode": "1234567",
            "country": "DEU",
            "longitude": "12.345670",
            "latitude": "-12.345670"
                }
            },
            "auditSiteProductAttributes": [
                {
                    "apiKey": "module_product_attribute_8ba06873-0932-4609-b1a7-f3085e52d2be",
                    "name": "Production area of covered harvest, in ha",
                    "values": [
                        "20.00"
                    ]
                },
                {
                    "apiKey": "module_product_attribute_59478fb0-794d-46a9-8f02-97f97ec8921b",
                    "name": "Harvest included",
                    "values": [
                        "module_product_attribute_options_87120023-555a-4429-8fc4-21eeff43dbbf"
                    ]
                },
                {
                    "apiKey": "module_product_attribute_1ee44a59-fef6-4506-98ff-3604993ecaa4",
                    "name": "Product handling included",
                    "values": [
                        "module_product_attribute_options_10ea1a64-9594-43f9-b165-c32de7a799bc"
                    ]
                },
                {
                    "apiKey": "module_product_attribute_8429e920-fc32-4353-b2f3-86b7c2994abd",
                    "name": "Parallel ownership",
                    "values": [
                        "module_product_attribute_options_0d8d3dee-ddad-4ab4-bf2c-56f36b7fc39a"
                    ]
                },
                {
                    "apiKey": "module_product_attribute_05a58040-c0f1-4fde-98bd-98a10f36d20a",
                    "name": "Countries of destination",
                    "values": [
                        "DEU"
                    ]
                },
                {
                    "apiKey": "module_product_attribute_2c3a8645-69f2-48e1-8a95-36d79a9eb1d7",
                    "name": "Production area of non-covered harvest, in ha",
                    "values": [
                        "20.00"
                    ]
                },
                {
                    "apiKey": "module_product_attribute_d715629b-97c9-4934-bf15-eb49c2f85345",
                    "name": "Number of growing cycles for covered",
                    "values": [
                        "5"
                    ]
                },
                {
                    "apiKey": "module_product_attribute_8df5182b-0f79-4e52-89df-501183d6a1e6",
                    "name": "Number of growing cycles for non-covered",
                    "values": [
                        "3"
                    ]
                },
                {
                    "apiKey": "module_product_attribute_7c83ec06-2d4a-43e9-9c81-82ece8a6ea22",
                    "name": "GGN",
                    "values": [
                        "4063651199079"
                    ]
                },
                {
                    "apiKey": "module_product_attribute_f884769d-5366-4923-9034-848c69b40793",
                    "name": "Name",
                    "values": [
                        "Test Site 1"
                    ]
                },
                {
                    "apiKey": "module_product_attribute_b62fb00d-ad06-4b76-b590-3e4d1a3c450f",
                    "name": "Longitude",
                    "values": [
                        "1.11111"
                    ]
                },
                {
                    "apiKey": "module_product_attribute_59207df1-c9f1-4e6b-92b2-8961c6716769",
                    "name": "Latitude",
                    "values": [
                        "1.11111"
                    ]
                }
            ]
        }
    ]
}

IFA 6 Plants

Product Site Attributes

Required?FieldValue TypeValue NameAPI Key/Example
    Yes  Production area of covered harvest, in ha  module_product_attribute_8ba06873-0932-4609-b1a7-f3085e52d2be
Decimal Example: 10.00
    YesHarvest included  module_product_attribute_59478fb0-794d-46a9-8f02-97f97ec8921b
Select 1  Includedmodule_product_attribute_options_87120023-555a-4429-8fc4-21eeff43dbbf
Excludedmodule_product_attribute_options_844d0a77-a80a-4e5d-a155-7bbfe587ed35
        YesProduct handling included  module_product_attribute_1ee44a59-fef6-4506-98ff-3604993ecaa4
Select 1Nomodule_product_attribute_options_10ea1a64-9594-43f9-b165-c32de7a799bc
In fieldmodule_product_attribute_options_8b1adb7e-af9c-4a01-8359-56e6fe38698b
Facilitymodule_product_attribute_options_c41943c1-3128-4044-bee3-63929c2baed9
In field + Facilitymodule_product_attribute_options_855180c4-eae0-4941-8f8e-847082681895
    YesParallel ownership  module_product_attribute_8429e920-fc32-4353-b2f3-86b7c2994abd
Select 1Yesmodule_product_attribute_options_0d8d3dee-ddad-4ab4-bf2c-56f36b7fc39a
Nomodule_product_attribute_options_2345cf4f-a9ab-4ef8-afb6-ce23ecf8429a
YesCountries of destination  module_product_attribute_05a58040-c0f1-4fde-98bd-98a10f36d20a
Multiple Text Example: DEU,ARG,USA
  YesProduction area of non-covered harvest, in ha  module_product_attribute_2c3a8645-69f2-48e1-8a95-36d79a9eb1d7
Decimal Example: 10.00
  YesNumber of growing cycles for covered  module_product_attribute_d715629b-97c9-4934-bf15-eb49c2f85345
Integer Example: 5
YesNumber of growing cycles for non-covered  module_product_attribute_8df5182b-0f79-4e52-89df-501183d6a1e6
Integer Example: 5
Only if Site is an External PHUGGN  module_product_attribute_7c83ec06-2d4a-43e9-9c81-82ece8a6ea22
13 digits 1234567891011

Only if Site is an External PHUName  module_product_attribute_f884769d-5366-4923-9034-848c69b40793
Text Example: Example Farm
Only if Site is an External PHULongitude  module_product_attribute_b62fb00d-ad06-4b76-b590-3e4d1a3c450f
Decimal with 5-6 digits after the decimal Example: 1.12345
Only if Site is an External PHULatitude  module_product_attribute_59207df1-c9f1-4e6b-92b2-8961c6716769
Decimal with 5-6 digits after the decimal Example: 1.12345

Certificate Attributes

Required?FieldValue TypeValue NameAPI Key/Example
YesDate of certification decision                                                                                                   module_certificate_attribute_9b0a8357-766d-40f8-8f56-f2b8580e459e
Date      Example: 2023-12-30
Yes      Audit Method  module_certificate_attribute_6219f9a7-1d24-449c-8a82-9618fd4c7185
Select 1Offsitemodule_certificate_attribute_options_98810914-797d-41e4-a814-261c34f23703
Onsitemodule_certificate_attribute_options_0e9970bb-9ed1-4f2f-b95e-254bbc088660
onsite + offsite.module_certificate_attribute_options_6290a3af-3001-440d-af60-192648a3c43d
Yes    Type of audit  module_certificate_attribute_4e351b6f-7ff8-49b9-b200-7e4efd3e279f
Select 1ANNOUNCEDmodule_certificate_attribute_options_d07a879b-9ec1-4a0f-8c2d-cc7b59ce8d55
UNANNOUNCEDmodule_certificate_attribute_options_594cdedd-b7bf-4e74-9045-794c83c43be9

IFA 6 Aquaculture

Product Site Attributes

Required?FieldValue TypeValue NameAPI Key/Example
YesCountries of destination  module_product_attribute_05a58040-c0f1-4fde-98bd-98a10f36d20a
Multiple Text Example: DEU,ARG,USA
YesBroodstock in-house, estimated organisms in no.  module_product_attribute_d0473dcd-cea3-4d9b-abff-b567c45e2b94
Integer Example: 15
 Seedlings (ova) in-house, estimated organisms in no.  module_product_attribute_a8207552-19f2-4cb9-a7fa-d517ae0bf150
Integer Example: 15
YesSeedlings (juvenile) in-house, estimated organisms in no.  module_product_attribute_8d3dd403-4ac1-49e7-bcaa-4cc45e186d76
 Integer Example: 15
YesFarmed aquatic species, annual quantity in metric tons at point of harvest  module_product_attribute_5c352e7d-c3d3-44aa-96e8-8059962c0a38
 Integer Example: 15
YesBroodstock additionally purchased?  module_product_attribute_90c7984f-4f10-4ef1-a314-38e755101391
Select 1Yesmodule_product_attribute_options_12da297f-5dcc-4c55-a3dc-6ae118f249de
Nomodule_product_attribute_options_c06ff4a9-ae6c-4101-84ee-cadf908eae4a
YesSeedlings (ova) additionally purchased?  module_product_attribute_01783ad1-0161-4f17-a942-d6db1e4ab2d9
Select 1Yesmodule_product_attribute_options_416ceb0c-050f-4749-8fe6-f90ee60abf06
Nomodule_product_attribute_options_4685bd9f-b15b-4f90-b2bd-a9c50c0bb2e9
YesSeedlings (juvenile) additionally purchased?  module_product_attribute_01783ad1-0161-4f17-a942-d6db1e4ab2d9
Select 1Yesmodule_product_attribute_options_66122d0b-9adc-4aae-ad5a-c0b20490251e
Nomodule_product_attribute_options_d3295b0f-ec0e-48ee-8305-8cdd0ab38527
YesFeed supplied (internally or externally)?  module_product_attribute_275e869b-38d3-4014-a925-71a9c43a1e6e
Select 1Yesmodule_product_attribute_options_7584bace-ae75-4df5-bdd0-62d5ab909e90
Nomodule_product_attribute_options_87c0db35-bc66-49a1-8bcf-cc80a99f57ea
Only if Site is an External PHUGGN  module_product_attribute_7c83ec06-2d4a-43e9-9c81-82ece8a6ea22
13 digits 1234567891011

Only if Site is an External PHUName  module_product_attribute_f884769d-5366-4923-9034-848c69b40793
Text Example: Example Farm
Only if Site is an External PHULongitude  module_product_attribute_b62fb00d-ad06-4b76-b590-3e4d1a3c450f
Decimal with 5-6 digits after the decimal Example: 1.12345
Only if Site is an External PHULatitude  module_product_attribute_59207df1-c9f1-4e6b-92b2-8961c6716769
Decimal with 5-6 digits after the decimal Example: 1.12345
YesParallel ownership  module_product_attribute_8ffd6a21-7384-45c9-913b-3e203b16f60f
Select 1Yesmodule_product_attribute_options_fbc4be4b-10a4-4a42-807c-62b31c989de5
Nomodule_product_attribute_options_e537ccda-8906-4e41-945f-7c5251a1095c

Certificate Attributes

YesPost harvest activity?  module_certificate_attribute_6e150074-31dd-4d0c-a19d-9bd618fb8c70
Select 1Post-harvest activities are certified to a GFSI (*) recognized post-farm gate standard for food safety or a 3rd party certified HACCP system (*). The food safety system (*) of the post-harvest activities is not part of the scope of this certificate.module_certificate_attribute_options_6c1cbb35-e66d-4e8c-886b-925848337be0
Nomodule_certificate_attribute_options_f2e19106-d247-4eb6-b08f-58c6c8fe8297
YesDate of certification decision                                                                                                     module_certificate_attribute_9b0a8357-766d-40f8-8f56-f2b8580e459e
Date             Example: 2023-12-30
Yes      Audit Method  module_certificate_attribute_6219f9a7-1d24-449c-8a82-9618fd4c7185
Select 1Offsitemodule_certificate_attribute_options_98810914-797d-41e4-a814-261c34f23703
Onsitemodule_certificate_attribute_options_0e9970bb-9ed1-4f2f-b95e-254bbc088660
onsite + offsite.module_certificate_attribute_options_6290a3af-3001-440d-af60-192648a3c43d
Yes    Type of audit  module_certificate_attribute_4e351b6f-7ff8-49b9-b200-7e4efd3e279f
Select 1ANNOUNCEDmodule_certificate_attribute_options_d07a879b-9ec1-4a0f-8c2d-cc7b59ce8d55
UNANNOUNCEDmodule_certificate_attribute_options_594cdedd-b7bf-4e74-9045-794c83c43be9

Farm Sustainability Assessment (FSA) 2.1, (FSA) 3.0

Product Site Attributes

Required?FieldValue TypeValue NameAPI Key/Example
YesNon Covered Crops First Harvest in hectares  module_product_attribute_9ad74d68-c887-47d6-9f3f-b974119d2d27
Integer Example: 50
YesNon Covered Crops Further Harvest in hectares  module_product_attribute_df85efe1-d0b0-4247-95e4-02fbc94b7efc
Integer Example: 50
YesCovered Crops First Harvest in hectares  module_product_attribute_dda89b70-23eb-4af8-a30e-969e010bca37
Integer Example: 50
YesCovered Crops Further Harvest in hectares  module_product_attribute_0daecfe9-35bd-4888-890c-334fb04436ec
Integer Example: 50
YesTotal Members in Count  module_product_attribute_bfe37f7f-7ed4-4543-a79e-84c83f74791e
Integer Example: 50
YesLast assessment date  module_product_attribute_6aea2459-d0c3-472e-bebc-402cec428ec1
Date      Example: 2023-12-30
YesCountries of destination  module_product_attribute_75e82a60-0f20-4510-a774-e716964418af
Multiple Text Example: DEU,ARG,USA

Certificate Attributes

Required?FieldValue TypeValue NameAPI Key/Example
YesDate of certification decision                                                                                                     module_certificate_attribute_9b0a8357-766d-40f8-8f56-f2b8580e459e
Date      Example: 2023-12-30
Yes      Audit Method  module_certificate_attribute_6219f9a7-1d24-449c-8a82-9618fd4c7185
Select 1Offsitemodule_certificate_attribute_options_98810914-797d-41e4-a814-261c34f23703
Onsitemodule_certificate_attribute_options_0e9970bb-9ed1-4f2f-b95e-254bbc088660
onsite + offsite.module_certificate_attribute_options_6290a3af-3001-440d-af60-192648a3c43d
Yes    Type of audit  module_certificate_attribute_4e351b6f-7ff8-49b9-b200-7e4efd3e279f
Select 1ANNOUNCEDmodule_certificate_attribute_options_d07a879b-9ec1-4a0f-8c2d-cc7b59ce8d55
UNANNOUNCEDmodule_certificate_attribute_options_594cdedd-b7bf-4e74-9045-794c83c43be9

GRASP V2.0

Product Site Attributes

Required?FieldValue TypeValue NameAPI Key/Example
Only if Site is an External PHUGGN  module_product_attribute_7c83ec06-2d4a-43e9-9c81-82ece8a6ea22
13 digits 1234567891011

Only if Site is an External PHUName  module_product_attribute_f884769d-5366-4923-9034-848c69b40793
Text Example: Example Farm
Only if Site is an External PHULongitude  module_product_attribute_b62fb00d-ad06-4b76-b590-3e4d1a3c450f
Decimal with 5-6 digits after the decimal Example: 1.12345
Only if Site is an External PHULatitude  module_product_attribute_59207df1-c9f1-4e6b-92b2-8961c6716769
Decimal with 5-6 digits after the decimal Example: 1.12345

Certificate Attributes

Required?FieldValue TypeValue NameAPI Key/Example
Yes      Audit Method  module_certificate_attribute_6219f9a7-1d24-449c-8a82-9618fd4c7185
  Select 1Offsitemodule_certificate_attribute_options_98810914-797d-41e4-a814-261c34f23703
   Onsitemodule_certificate_attribute_options_0e9970bb-9ed1-4f2f-b95e-254bbc088660
   onsite + offsite.module_certificate_attribute_options_6290a3af-3001-440d-af60-192648a3c43d
YesMain Certificate  module_certificate_attribute_3ca1b54a-ffa9-4d4f-ac0e-8b4888ca183a
Text The audit_api_key associated with the main certificate. Example: audit_12345678-abcd-1234-abc1-23456abcd12345
YesDate of Conformance Decision  module_certificate_attribute_701d1087-849c-415a-bed1-a128e7982a8e
Date Example: 2023-12-30
YesTotal Number of Workers  module_certificate_attribute_2b7c6adb-6f36-4aa1-af4a-5266cd87c675
Integer Example: 20
YesOverall Assessment Result  module_certificate_attribute_1ae2b631-c5c5-4b8a-b823-4c8cfc5d04d7
Select 1conformancemodule_certificate_attribute_options_29ff915b-e0c9-4550-81e5-17deebbc3ead
non-Conformancemodule_certificate_attribute_options_182c2b16-263f-4a70-96fa-1e9018a407d9
Not Applicablemodule_certificate_attribute_options_ece061d8-085e-433d-bec1-19d6d6d5fc58
Yes    Type of audit  module_certificate_attribute_4e351b6f-7ff8-49b9-b200-7e4efd3e279f
Select 1ANNOUNCEDmodule_certificate_attribute_options_d07a879b-9ec1-4a0f-8c2d-cc7b59ce8d55
UNANNOUNCEDmodule_certificate_attribute_options_594cdedd-b7bf-4e74-9045-794c83c43be9

Site Attributes

Required?FieldValue TypeValue NameAPI Key/Example
YesTotal Number of Workers  module_site_attribute_84508a4a-7bb4-4a6d-b326-4df0779ca90e
Integer Example:10

Produce Handling Assurance (PHA) v.1.2

Required?FieldValue TypeValue NameAPI Key/Example
YesCovered by PSR  module_product_attribute_3895f50f-dc6c-44da-81d2-7808a1895dfd
Select 1Yesmodule_product_attribute_options_d2685755-50ed-450f-9648-34f4946a6070
Nomodule_product_attribute_options_35203fff-8070-4e1e-adbf-5ae45970525c
YesCovered by PCHF   
Select 1Yesmodule_product_attribute_options_4f7baf6c-ce78-458e-9ae8-c75ac5e3944b
Nomodule_product_attribute_options_331d57ee-919d-4c1b-a74a-051448046b90
YesObserved during the audit   
Select 1Yesmodule_product_attribute_options_3af63d72-91a0-4588-8fcb-bee97b4536a7
Nomodule_product_attribute_options_c01b051c-c0ea-44c7-b815-70f5657c1821
YesOperation Scope  module_product_attribute_1165b60b-5f3c-4799-9b2c-318610696045
Select MultipleCooling/Cold storagemodule_product_attribute_options_58c28a20-6435-4a8c-b398-cac31ffc5f7b
Packing housemodule_product_attribute_options_49b263d4-0eaa-4c96-bfe0-1c530124701f
Pre-processingmodule_product_attribute_options_1aaba901-7eb6-4865-9b78-c1514b89fc4f
Storage/Distributionmodule_product_attribute_options_6474a67a-9f12-45a9-b791-6610804b6a82
Includes open-shed facility in enclosed operationmodule_product_attribute_options_19f24319-ed0a-451b-8e94-3821d3d04f2a

Certificate Attributes

Required?FieldValue TypeValue NameAPI Key/Example
YesOperation Type  module_certificate_attribute_0347d481-8259-4714-b005-eed15abfad78
Select 1Open shedmodule_certificate_attribute_options_5aa05790-d911-4faf-a78d-f31746262ecd
Enclosed operationmodule_certificate_attribute_options_5b611645-6db8-493e-a5b6-31ca989fc403
YesType of audit  module_certificate_attribute_4e351b6f-7ff8-49b9-b200-7e4efd3e279f
Select 1ANNOUNCEDmodule_certificate_attribute_options_d07a879b-9ec1-4a0f-8c2d-cc7b59ce8d55
UNANNOUNCEDmodule_certificate_attribute_options_594cdedd-b7bf-4e74-9045-794c83c43be9

SPRING Version 1.1

Certificate Attributes

Required?FieldValue TypeValue NameAPI Key/Example
YesType of audit  module_certificate_attribute_4e351b6f-7ff8-49b9-b200-7e4efd3e279f
Select 1ANNOUNCEDmodule_certificate_attribute_options_d07a879b-9ec1-4a0f-8c2d-cc7b59ce8d55
UNANNOUNCEDmodule_certificate_attribute_options_594cdedd-b7bf-4e74-9045-794c83c43be9