{"info":{"_postman_id":"411cd279-c066-4f02-aa5a-933e57155cc2","name":"GLOBALG.A.P. IT Platform (powered by Osapiens) Bookmarking API","description":"

What is Bookmarking?

GLOBALG.A.P. Bookmarking is the easy way to record and monitor the certification status of your producers.

With this exclusive access into the Database you can easily manage your GLOBALG.A.P. certified producers and also share this list to other companies, for instance wholesalers, which require GLOBALG.A.P. certification.

Support

Please send an e-mail to: api_support@agraya.com or call us at +49 221 57776 -100.

Terms of Use

For the use of the API GLOBALG.A.P. Bookmarking Package, please refer to our terms and conditions .

Change Log

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Date	Change	Description/Detail
27/04/2026	+ Fixed bug that caused an empty Editor value to get set to 'undefined'.	If a bookmark is created with Write Bookmark without a value for the Editor field, the editor will automatically be set to the company of the user creating the list.
6/1/2026	+ Fixed an issue with Write Bookmark Items not respecting the MembersIncluded flag.	+ You can now set \"membersIncluded\": true in calls to Write Bookmark Items.
15/12/2025	+ Fixed an issue with large lists refusing to return.
28/11/2025	+ Paging changed to cursor based pagination, with a maximum of 100 certificates per page. + Lists have a hard limit of 500 GGNs per list.	Paging IDs are now 64 bit strings instead of numbers. This allows for more flexibility and control in the size of each page. If a certificate is particularly large, you may only get back 1 certificate on a page. See Read Bookmark Updates for examples and further information. + Lists that contain more than 500 GGNs will return a message that you have exceeded the number of allowed GGNs per list, and to please reduce and try again.
15/09/2025	+ \"page\" field added to Read Bookmark Updates + \"membersIncluded\" field added to Write Bookmark and Write Bookmark Items	+ You can now add optional pagination to your results, by including the \"page\" field and a number for the page. Please see updated examples. + You can now specify when bookmarking a GGN whether to include all members on certificates that GGN is the holder for, or not. Defaults to \"No\". Please see updated examples.

","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"Support","slug":"support"},{"content":"Terms of Use","slug":"terms-of-use"},{"content":"Change Log","slug":"change-log"}],"owner":"29138650","collectionId":"411cd279-c066-4f02-aa5a-933e57155cc2","publishedId":"2sAYJ3EM2Y","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-01-06T12:58:05.000Z"},"item":[{"name":"Testing Environment (Preproduction)","item":[],"id":"2f8bf5f0-aca6-4655-94c6-e9386c1f3f5e","description":"

Variables

Below you will the find the corresponding values for testing the API. You can create a new environment in Postman using these variables, or manually replace them if you are not using Postman to hit these API endpoints.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Variable	Value
application	field-service-os
customer	foodplus-qa-ext
url	https://preprod.osapiens.cloud
username	Your username
password	Your password

Test GGNS

During this testing phase, you can check here for a list of GGNs to use for testing purposes. If you have questions or additional requests, please contact us.

A list of 2000 GGNs can be found here: Test GGNs
Below will be specific examples of types of GGNs. This section will continue to be updated.

UPDATE: Due to a system reset of all certificates, these will temporarily be unavailable.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

GGN	Details
6291041001154	Producer with an IFA V6 SMART - Plants Single Site certificate, with multiple kinds of produce.
6291041001512	Producer with an IFA V6 SMART - Plant Multisite without QMS certificate, with multiple sites.
6291041001611	Producer with an IFA V6 SMART - Aquaculture Single Site certificate, with a single product
6291041001628	Producer with a NURTURE Module Version 12.0 Option 1 - Single Site Certification
6291041001642	Producer with a Biodiversity v.1.1 Option 1 - Single Site Certification
6291041001178	Producer Group with a GLOBALG.A.P. IFA version 6 SMART - Plants Option 2 Certification
6291041001598	Producer member for GLOBALG.A.P. IFA version 6 SMART - Plants Option 2 Certification
6291041001604	Producer member for GLOBALG.A.P. IFA version 6 SMART - Plants Option 2 Certification
6291041010781	Producer with a GRASP V2 Option 1 Single Site Certification

","_postman_id":"2f8bf5f0-aca6-4655-94c6-e9386c1f3f5e"},{"name":"Live Environment (Production)","item":[{"name":"Read Bookmark Updates","id":"1501e753-7021-49ae-b4ea-d0253a4718cc","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"key\": \"\",\n \"reset\": false\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/data/integration/{{customer}}/field-service-os/read-bookmark-updates/?application={{application}}&customer={{customer}}&password={{password}}&username={{username}}","description":"

Returns data on all new and changed bookmark items from any given bookmark list.

Requires a bookmark ID as the \"key\" value.
When calling large lists, you can use pagination. To do so, set the reset value to \"true\", and add a key for \"page\". the value is the paging ID that is returned at the bottom of the call. For example:

\"message\": \"Processing certificates for recently added producers. Showing 100 certificateswith full details (up to 100 per request). More are available - send the request again with the returned pagingId to continue.\"

,\"pagingId\": \"AAAAARsADjE1MTY1MjktMzQ4MDAx\"

,\"processedCertificates\": 100,

\"remainingCertificates\": 273,

\"status\": 200

When you reach the end of the pages, you will receive a message indicating this:

\"message\": \"Showing 4 certificates with full details (up to 100 per request). All certificates have been processed.\",

\"pagingId\": null,

\"processedCertificates\": 4,

\"remainingCertificates\": 0,

Below is a list of returned fields. Please note as this is still under development, additional fields may be added at a later date.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field Name	Description
certificates	An array containing all the certificates for the bookmark list.
certificateDetails	An array of the certificates top level details and attributes.
auditMethod	Possible values: “On-site”, “Off-site”, “On-site + Off-site\".
auditNotification	Possible values: “Announced”, “Unannounced <48h”.
authorizationDate	The date the certificate was authorized.
authorizedBy	The name of the Authorizer.
certificateId	The ID of the certificate version displayed. Changes when the version is updated.
country	The producer's country.
fap	The Farm Assurance Product name and version.
option	The option and multisite value for the certificate.
rootId	The unique ID tied to the overall certification.
status	The status of the certificate.
validFrom	The date the validity of the certificate starts.
validTo	The date the validity of the certificate ends.
version	The version of the certificate. Modifications are reflected in this number.
CertificationBody	An array containing the address of the certification body.
address	An array containing the certification body address.
City	The city of the certification body.
Country	The country of the certification body.
PhoneNumber	The phone number of the certification body.
Street	The street of the certification body.
StreetNumber	The street number of the certification body.
certificationBodyId	the ID number associated with the certification body.
certificationBodyName	The name of the certification body.
isAuditVisible	Whether the audit report is visible and linked in the bookmark.
isCertificateVisible	Whether the certificate is visible and linked in the bookmark.
isGroupCertificate	Whether the certificate is a group certificate.
producer	An array containing the address of the producer.
address	An array containing the address of the producer.
City	The city of the producer.
Country	The country of the producer.
Email	The email of the producer.
Latitude	The latitude of the producer.
Longitude	The longitude of the producer.
PostalCode	The postal code of the producer.
State:	The state of the producer.
Street:	The street of the producer.
StreetNumber	The street number of the producer.
producerId	The GGN or GLN of the producer.
producerName	The name of the producer.
productHandlingUnits	The product handling units for product attributes.
sites	An array of the certificate's sites and their products.
address	An array of the site's address.
City	The city of the site.
Country	The country of the site.
Email	The email of the site.
Latitude	The latitude of the site.
Longitude	The longitude of the site.
PostalCode	The postal code of the site.
State	The state of the site.
Street	The street of the site.
StreetNumber	The street number of the site.
id	The ID of the site.
name	The name of the site.
products	An array of the products and their attributes for the site.
attributes	An array of the product's attributes.
key	A key identifying the audit question and answer for the attribute.
label	The name of the attribute.
value	The value for the attribute.
subProducers	The list of GGNs covered by a group certificate. Empty if certificate is option 1.
producerId	The producer ID the certificate is for.
producerName	The name of the producer the certificate is for.
error	Contains an error if issues are encountered.
status	The status of the API call.

","urlObject":{"path":["data","integration","{{customer}}","field-service-os","read-bookmark-updates",""],"host":["{{url}}"],"query":[{"key":"application","value":"{{application}}"},{"key":"customer","value":"{{customer}}"},{"key":"password","value":"{{password}}"},{"key":"username","value":"{{username}}"}],"variable":[]}},"response":[{"id":"4221487b-aceb-48da-901c-17f725cbc42e","name":"Certificate Extended Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"key\": \"1009\",\n \"reset\": false\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"{{url}}/data/integration/{{customer}}/field-service-os/read-bookmark-updates/?application={{application}}&customer={{customer}}&password={{password}}&username={{username}}","host":["{{url}}"],"path":["data","integration","{{customer}}","field-service-os","read-bookmark-updates",""],"query":[{"key":"application","value":"{{application}}"},{"key":"customer","value":"{{customer}}"},{"key":"password","value":"{{password}}"},{"key":"username","value":"{{username}}"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\r\n \"data\": [\r\n {\r\n \"certificates\": [\r\n {\r\n \"certificateDetails\": {\r\n \"certificateId\": \"10335\",\r\n \"rootId\": \"10326\",\r\n \"status\": \"Extended\",\r\n \"validTo\": 1775917020000,\r\n \"version\": \"1.3\"\r\n },\r\n \"producer\": {\r\n \"producerId\": \"6291041002755\",\r\n \"producerName\": \"CJ Producer #5\"\r\n }\r\n }\r\n ],\r\n \"producerId\": \"6291041002755\",\r\n \"producerName\": \"CJ Producer #5\"\r\n }\r\n ],\r\n \"error\": \"\",\r\n \"status\": 200\r\n}"},{"id":"afe72899-38f0-49d3-bddb-3003d226067e","name":"Product Change Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"key\": \"\",\n \"reset\": false\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"{{url}}/data/integration/{{customer}}/field-service-os/read-bookmark-updates/?application={{application}}&customer={{customer}}&password={{password}}&username={{username}}","host":["{{url}}"],"path":["data","integration","{{customer}}","field-service-os","read-bookmark-updates",""],"query":[{"key":"application","value":"{{application}}"},{"key":"customer","value":"{{customer}}"},{"key":"password","value":"{{password}}"},{"key":"username","value":"{{username}}"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": [\n {\n \"certificates\": [\n {\n \"certificateDetails\": {\n \"certificateId\": \"10045\",\n \"rootId\": \"10027\",\n \"validTo\": \"2026-01-31\",\n \"version\": \"1.3\"\n },\n \"removedProducts\": [\n {\n \"id\": \"10012\",\n \"name\": \"Apple\"\n }\n ],\n \"sites\": [\n {\n \"id\": \"10058\",\n \"name\": \"Site A for Subproducer 1\",\n \"products\": [\n {\n \"attributes\": [\n {\n \"key\": \"10.0\",\n \"label\": \"Harvest included\",\n \"value\": \"Excluded\"\n }\n ],\n \"id\": \"10043\",\n \"name\": \"Cucumber\"\n }\n ]\n }\n ]\n }\n ],\n \"producerId\": \"4049929001251\",\n \"producerName\": \"Dummy Subproducer 1\"\n }\n ],\n \"error\": \"\",\n \"status\": 200\n}"},{"id":"323c32b8-7d19-4206-8893-b7143049eb4a","name":"GGN Added to Bookmark List","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"key\": \"\",\n \"reset\": false\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"{{url}}/data/integration/{{customer}}/field-service-os/read-bookmark-updates/?application={{application}}&customer={{customer}}&password={{password}}&username={{username}}","host":["{{url}}"],"path":["data","integration","{{customer}}","field-service-os","read-bookmark-updates",""],"query":[{"key":"application","value":"{{application}}"},{"key":"customer","value":"{{customer}}"},{"key":"password","value":"{{password}}"},{"key":"username","value":"{{username}}"}]}},"code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": [\n {\n \"certificates\": [\n {\n \"certificateDetails\": {\n \"auditMethod\": \"NO_ACCESS\",\n \"auditNotification\": \"NO_ACCESS\",\n \"authorizationDate\": \"NO_ACCESS\",\n \"authorizedBy\": \"NO_ACCESS\",\n \"certificateId\": \"10033\",\n \"country\": \"NO_ACCESS\",\n \"fap\": \"GLOBALG.A.P. IFA version 6 SMART - Plants\",\n \"option\": \"Option 1 - Single Site Certification\",\n \"status\": \"Certified\",\n \"validFrom\": \"NO_ACCESS\",\n \"validTo\": 1764233319178\n },\n \"certificationBody\": {\n \"address\": {\n \"City\": \"NO_ACCESS\",\n \"Country\": \"NLD\",\n \"PostalCode\": \"8000 AD\",\n \"Street\": \"NO_ACCESS\",\n \"StreetNumber\": \"NO_ACCESS\"\n },\n \"certificationBodyId\": \"foodplus\",\n \"certificationBodyName\": \"foodplus\"\n },\n \"isAuditVisible\": false,\n \"isCertificateVisible\": false,\n \"isGroupCertificate\": false,\n \"producer\": {\n \"address\": {\n \"City\": \"5\",\n \"Country\": \"DE\",\n \"Email\": \"NO_ACCESS\",\n \"Latitude\": \"NO_ACCESS\",\n \"Longitude\": \"NO_ACCESS\",\n \"PostalCode\": \"NO_ACCESS\",\n \"State\": \"NO_ACCESS\",\n \"Street\": \"NO_ACCESS\",\n \"StreetNumber\": \"NO_ACCESS\"\n },\n \"producerId\": \"4049928846365\",\n \"producerName\": \"CJ Test 28.11\",\n \"productHandlingUnits\": [],\n \"sites\": [\n {\n \"address\": {\n \"City\": \"NO_ACCESS\",\n \"Country\": \"NO_ACCESS\",\n \"Email\": \"NO_ACCESS\",\n \"Latitude\": \"NO_ACCESS\",\n \"Longitude\": \"NO_ACCESS\",\n \"PostalCode\": \"NO_ACCESS\",\n \"State\": \"NO_ACCESS\",\n \"Street\": \"NO_ACCESS\",\n \"StreetNumber\": \"NO_ACCESS\"\n },\n \"id\": \"10094\",\n \"name\": \"4049928846365 Site 1\",\n \"products\": [\n {\n \"attributes\": [\n {\n \"key\": \"52.0\",\n \"label\": \"Non -Covered Crops First Harvest in hectares\",\n \"value\": \"NO_ACCESS\"\n },\n {\n \"key\": \"13.3\",\n \"label\": \"Unit\",\n \"value\": \"NO_ACCESS\"\n },\n {\n \"key\": \"14.2\",\n \"label\": \"Quantity\",\n \"value\": \"NO_ACCESS\"\n },\n {\n \"key\": \"13.2\",\n \"label\": \"Quantity\",\n \"value\": \"NO_ACCESS\"\n },\n {\n \"key\": \"14.1\",\n \"label\": \"GGN\",\n \"value\": \"NO_ACCESS\"\n },\n {\n \"key\": \"15.0\",\n \"label\": \"Countries of destination:one or multiple countries \",\n \"value\": \"NO_ACCESS\"\n },\n {\n \"key\": \"13.1\",\n \"label\": \"Name or address of non-certified supplier\",\n \"value\": \"NO_ACCESS\"\n },\n {\n \"key\": \"14.0\",\n \"label\": \"Trade. Does the producer buy certified product from external sources\",\n \"value\": \"NO_ACCESS\"\n },\n {\n \"key\": \"13.0\",\n \"label\": \"Ownership/Purchase of certified and non-certified products\",\n \"value\": \"NO_ACCESS\"\n },\n {\n \"key\": \"12.0\",\n \"label\": \"Production of certified and non-certified products\",\n \"value\": \"NO_ACCESS\"\n },\n {\n \"key\": \"11.0\",\n \"label\": \"\",\n \"value\": \"NO_ACCESS\"\n },\n {\n \"key\": \"10.0\",\n \"label\": \"Harvest included (test)\",\n \"value\": \"NO_ACCESS\"\n },\n {\n \"key\": \"53.0\",\n \"label\": \"Non -Covered Crops Total Harvest (first + further) in hectares\",\n \"value\": \"NO_ACCESS\"\n },\n {\n \"key\": \"54.0\",\n \"label\": \"Number of growing cycles for non-covered crops\",\n \"value\": \"NO_ACCESS\"\n },\n {\n \"key\": \"55.0\",\n \"label\": \"Continuous harvesting for non-covered\",\n \"value\": \"NO_ACCESS\"\n },\n {\n \"key\": \"56.0\",\n \"label\": \"Covered Crops First Harvest in hectares\",\n \"value\": \"NO_ACCESS\"\n },\n {\n \"key\": \"9.0\",\n \"label\": \"Additional data or variety\",\n \"value\": \"NO_ACCESS\"\n },\n {\n \"key\": \"57.0\",\n \"label\": \"Covered Crops Total Harvest (first + further) in hectares\",\n \"value\": \"NO_ACCESS\"\n },\n {\n \"key\": \"58.0\",\n \"label\": \"Number of growing cycles for covered crops\",\n \"value\": \"NO_ACCESS\"\n },\n {\n \"key\": \"14.3\",\n \"label\": \"Unit\",\n \"value\": \"NO_ACCESS\"\n }\n ],\n \"id\": \"10012\",\n \"name\": \"Apple\"\n }\n ]\n }\n ]\n },\n \"subProducers\": []\n }\n ],\n \"producerId\": \"4049928846365\",\n \"producerName\": \"CJ Test 28.11\"\n }\n ],\n \"error\": \"\",\n \"status\": 200\n}"},{"id":"04987eba-1f63-4ea8-a1b9-5852f17fbeca","name":"Example GRASP V2 Certificate","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"key\": \"\",\n \"reset\": false\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"{{url}}/data/integration/{{customer}}/field-service-os/read-bookmark-updates/?application={{application}}&customer={{customer}}&password={{password}}&username={{username}}","host":["{{url}}"],"path":["data","integration","{{customer}}","field-service-os","read-bookmark-updates",""],"query":[{"key":"application","value":"{{application}}"},{"key":"customer","value":"{{customer}}"},{"key":"password","value":"{{password}}"},{"key":"username","value":"{{username}}"}]}},"status":"OK","code":200,"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"{\r\n \"data\": [\r\n {\r\n \"certificates\": [\r\n {\r\n \"certificateDetails\": {\r\n \"auditDetails\": [\r\n {\r\n \"key\": \"348002\",\r\n \"label\": \"GRASP assessment result\",\r\n \"value\": \"Conformance\"\r\n }\r\n ],\r\n \"auditMethod\": \"NO_ACCESS\",\r\n \"auditNotification\": \"NO_ACCESS\",\r\n \"authorizationDate\": \"NO_ACCESS\",\r\n \"authorizedBy\": \"NO_ACCESS\",\r\n \"certificateId\": \"10151\",\r\n \"certificateReasonId\": \"\",\r\n \"country\": \"NO_ACCESS\",\r\n \"fap\": \"GRASP v.2\",\r\n \"option\": \"Option 1 - Single Site Certification\",\r\n \"rootId\": \"10151\",\r\n \"status\": \"Assessed\",\r\n \"validFrom\": 1743408055093,\r\n \"validTo\": 1774857655093,\r\n \"version\": \"1.0\"\r\n },\r\n \"certificationBody\": {\r\n \"address\": {\r\n \"City\": \"Köln\",\r\n \"Country\": \"DE\",\r\n \"Email\": \"\",\r\n \"Latitude\": \"NO_ACCESS\",\r\n \"Longitude\": \"NO_ACCESS\",\r\n \"PhoneNumber\": \"\",\r\n \"PostalCode\": \"50672\",\r\n \"State\": \"NO_ACCESS\",\r\n \"Street\": \"Spichernstraße\",\r\n \"StreetNumber\": \"55\"\r\n },\r\n \"certificationBodyId\": \"Test_GLOBALGAP\",\r\n \"certificationBodyName\": \"GLOBALGAP Foodplus-QA-Ext\"\r\n },\r\n \"isAuditVisible\": false,\r\n \"isCertificateVisible\": false,\r\n \"isGroupCertificate\": false,\r\n \"producer\": {\r\n \"address\": {\r\n \"City\": \"City\",\r\n \"Country\": \"DE\",\r\n \"Email\": \"NO_ACCESS\",\r\n \"Latitude\": 40.7617256,\r\n \"Longitude\": -74.0562128,\r\n \"PhoneNumber\": \"NO_ACCESS\",\r\n \"PostalCode\": \"Postal Code\",\r\n \"State\": \"NO_ACCESS\",\r\n \"Street\": \"Street\",\r\n \"StreetNumber\": \"House Number\"\r\n },\r\n \"producerId\": \"6291041010781\",\r\n \"producerName\": \"Example GRASP Producer\",\r\n \"productHandlingUnits\": [],\r\n \"sites\": [\r\n {\r\n \"address\": {\r\n \"City\": \"City\",\r\n \"Country\": \"DE\",\r\n \"Email\": \"NO_ACCESS\",\r\n \"Latitude\": 40.7617256,\r\n \"Longitude\": -74.0562128,\r\n \"PhoneNumber\": \"NO_ACCESS\",\r\n \"PostalCode\": \"Postal Code\",\r\n \"State\": \"NO_ACCESS\",\r\n \"Street\": \"Street\",\r\n \"StreetNumber\": \"House Number\"\r\n },\r\n \"id\": \"100024475\",\r\n \"name\": \"6291041010781 - site 1\",\r\n \"products\": [\r\n {\r\n \"attributes\": [\r\n {\r\n \"key\": \"291002\",\r\n \"label\": \"Harvest included\",\r\n \"value\": \"NO_ACCESS\"\r\n },\r\n {\r\n \"key\": \"291003\",\r\n \"label\": \"Product handling\",\r\n \"value\": \"Yes\"\r\n }\r\n ],\r\n \"categoryId\": \"11\",\r\n \"categoryName\": \"FRUIT AND VEGETABLES\",\r\n \"id\": \"94\",\r\n \"name\": \"Pineapple\"\r\n }\r\n ]\r\n }\r\n ]\r\n },\r\n \"productSummary\": [],\r\n \"subProducers\": []\r\n }\r\n ],\r\n \"producerId\": \"6291041010781\",\r\n \"producerName\": \"Example GRASP Producer\"\r\n }\r\n ],\r\n \"error\": \"\",\r\n \"status\": 200\r\n}"},{"id":"6b02b58f-1fc1-442a-a5ee-6cec486b35a8","name":"Example Producer Group Certificate","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"key\": \"1234\",\n \"reset\": false\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"{{url}}/data/integration/{{customer}}/field-service-os/read-bookmark-updates/?application={{application}}&customer={{customer}}&password={{password}}&username={{username}}","host":["{{url}}"],"path":["data","integration","{{customer}}","field-service-os","read-bookmark-updates",""],"query":[{"key":"application","value":"{{application}}"},{"key":"customer","value":"{{customer}}"},{"key":"password","value":"{{password}}"},{"key":"username","value":"{{username}}"}]}},"status":"OK","code":200,"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"{\r\n \"data\": [\r\n {\r\n \"certificates\": [\r\n {\r\n \"certificateDetails\": {\r\n \"auditDetails\": [],\r\n \"auditMethod\": \"NO_ACCESS\",\r\n \"auditNotification\": \"NO_ACCESS\",\r\n \"authorizationDate\": \"NO_ACCESS\",\r\n \"authorizedBy\": \"NO_ACCESS\",\r\n \"certificateId\": \"10148\",\r\n \"certificateReasonId\": \"\",\r\n \"country\": \"NO_ACCESS\",\r\n \"fap\": \"GLOBALG.A.P. IFA version 6 SMART - Plants\",\r\n \"option\": \"Option 2 - Certification Scope Management\",\r\n \"rootId\": \"10148\",\r\n \"status\": \"Certified\",\r\n \"validFrom\": 1743003073528,\r\n \"validTo\": 1774452673528,\r\n \"version\": \"1.0\"\r\n },\r\n \"certificationBody\": {\r\n \"address\": {\r\n \"City\": \"Köln\",\r\n \"Country\": \"DE\",\r\n \"Email\": \"\",\r\n \"Latitude\": \"NO_ACCESS\",\r\n \"Longitude\": \"NO_ACCESS\",\r\n \"PhoneNumber\": \"\",\r\n \"PostalCode\": \"50672\",\r\n \"State\": \"NO_ACCESS\",\r\n \"Street\": \"Spichernstraße\",\r\n \"StreetNumber\": \"55\"\r\n },\r\n \"certificationBodyId\": \"Test_GLOBALGAP\",\r\n \"certificationBodyName\": \"GLOBALGAP Foodplus-QA-Ext\"\r\n },\r\n \"isAuditVisible\": false,\r\n \"isCertificateVisible\": false,\r\n \"isGroupCertificate\": true,\r\n \"producer\": {\r\n \"address\": {\r\n \"City\": \"City\",\r\n \"Country\": \"DE\",\r\n \"Email\": \"NO_ACCESS\",\r\n \"Latitude\": 40.7617256,\r\n \"Longitude\": -74.0562128,\r\n \"PhoneNumber\": \"NO_ACCESS\",\r\n \"PostalCode\": \"Postal Code\",\r\n \"State\": \"NO_ACCESS\",\r\n \"Street\": \"Street\",\r\n \"StreetNumber\": \"House Number\"\r\n },\r\n \"producerId\": \"6291041001178\",\r\n \"producerName\": \"Example Producer Group Holder\",\r\n \"productHandlingUnits\": [],\r\n \"sites\": [\r\n {\r\n \"address\": {\r\n \"City\": \"City\",\r\n \"Country\": \"DE\",\r\n \"Email\": \"NO_ACCESS\",\r\n \"Latitude\": 40.7617256,\r\n \"Longitude\": -74.0562128,\r\n \"PhoneNumber\": \"NO_ACCESS\",\r\n \"PostalCode\": \"Postal Code\",\r\n \"State\": \"NO_ACCESS\",\r\n \"Street\": \"Street\",\r\n \"StreetNumber\": \"House Number\"\r\n },\r\n \"id\": \"100024311\",\r\n \"name\": \"6291041001178 - Site 1\",\r\n \"products\": [\r\n {\r\n \"attributes\": [\r\n {\r\n \"key\": \"291002\",\r\n \"label\": \"Harvest included\",\r\n \"value\": \"Included\"\r\n },\r\n {\r\n \"key\": \"97002\",\r\n \"label\": \"Production of certified and non-certified products\",\r\n \"value\": \"NO_ACCESS\"\r\n },\r\n {\r\n \"key\": \"999003\",\r\n \"label\": \"Covered Crops First Harvest in hectares\",\r\n \"value\": \"1\"\r\n },\r\n {\r\n \"key\": \"999102\",\r\n \"label\": \"Covered Crops Total Harvest (first + further) in hectares\",\r\n \"value\": \"NO_ACCESS\"\r\n },\r\n {\r\n \"key\": \"999103\",\r\n \"label\": \"Non -Covered Crops Total Harvest (first + further) in hectares\",\r\n \"value\": \"NO_ACCESS\"\r\n },\r\n {\r\n \"key\": \"55.0\",\r\n \"label\": \"Continuous harvesting for non-covered\",\r\n \"value\": \"NO_ACCESS\"\r\n },\r\n {\r\n \"key\": \"999001\",\r\n \"label\": \"Non -Covered Crops First Harvest in hectares\",\r\n \"value\": \"1\"\r\n },\r\n {\r\n \"key\": \"291001\",\r\n \"label\": \"Product handling included\",\r\n \"value\": \"Facility\"\r\n },\r\n {\r\n \"key\": \"999100.01\",\r\n \"label\": \"Number of growing cycles for covered crops - Number\",\r\n \"value\": \"NO_ACCESS\"\r\n },\r\n {\r\n \"key\": \"999101.01\",\r\n \"label\": \"Number of growing cycles for non-covered crops - Number\",\r\n \"value\": \"NO_ACCESS\"\r\n }\r\n ],\r\n \"categoryId\": \"11\",\r\n \"categoryName\": \"FRUIT AND VEGETABLES\",\r\n \"id\": \"2\",\r\n \"name\": \"Apple\"\r\n }\r\n ]\r\n }\r\n ]\r\n },\r\n \"productSummary\": [\r\n {\r\n \"attributes\": [\r\n {\r\n \"key\": \"291002\",\r\n \"label\": \"Harvest included\",\r\n \"value\": \"NO_ACCESS\"\r\n },\r\n {\r\n \"key\": \"97002\",\r\n \"label\": \"Production of certified and non-certified products\",\r\n \"value\": \"NO_ACCESS\"\r\n },\r\n {\r\n \"key\": \"999003\",\r\n \"label\": \"Covered Crops First Harvest in hectares\",\r\n \"value\": \"NO_ACCESS\"\r\n },\r\n {\r\n \"key\": \"999102\",\r\n \"label\": \"Covered Crops Total Harvest (first + further) in hectares\",\r\n \"value\": \"NO_ACCESS\"\r\n },\r\n {\r\n \"key\": \"999103\",\r\n \"label\": \"Non -Covered Crops Total Harvest (first + further) in hectares\",\r\n \"value\": \"NO_ACCESS\"\r\n },\r\n {\r\n \"key\": \"999001\",\r\n \"label\": \"Non -Covered Crops First Harvest in hectares\",\r\n \"value\": \"NO_ACCESS\"\r\n },\r\n {\r\n \"key\": \"291001\",\r\n \"label\": \"Product handling included\",\r\n \"value\": \"NO_ACCESS\"\r\n }\r\n ],\r\n \"id\": \"2\",\r\n \"memberCount\": 0,\r\n \"name\": \"Apfel\",\r\n \"phuCount\": 0\r\n },\r\n {\r\n \"attributes\": [\r\n {\r\n \"key\": \"291002\",\r\n \"label\": \"Harvest included\",\r\n \"value\": \"NO_ACCESS\"\r\n },\r\n {\r\n \"key\": \"97002\",\r\n \"label\": \"Production of certified and non-certified products\",\r\n \"value\": \"NO_ACCESS\"\r\n },\r\n {\r\n \"key\": \"999003\",\r\n \"label\": \"Covered Crops First Harvest in hectares\",\r\n \"value\": \"NO_ACCESS\"\r\n },\r\n {\r\n \"key\": \"999102\",\r\n \"label\": \"Covered Crops Total Harvest (first + further) in hectares\",\r\n \"value\": \"NO_ACCESS\"\r\n },\r\n {\r\n \"key\": \"999103\",\r\n \"label\": \"Non -Covered Crops Total Harvest (first + further) in hectares\",\r\n \"value\": \"NO_ACCESS\"\r\n },\r\n {\r\n \"key\": \"999001\",\r\n \"label\": \"Non -Covered Crops First Harvest in hectares\",\r\n \"value\": \"NO_ACCESS\"\r\n },\r\n {\r\n \"key\": \"291001\",\r\n \"label\": \"Product handling included\",\r\n \"value\": \"NO_ACCESS\"\r\n }\r\n ],\r\n \"id\": \"95\",\r\n \"memberCount\": 0,\r\n \"name\": \"Pflaume\",\r\n \"phuCount\": 0\r\n }\r\n ],\r\n \"subProducers\": [\r\n {\r\n \"address\": {\r\n \"City\": \"NO_ACCESS\",\r\n \"Country\": \"NO_ACCESS\",\r\n \"Email\": \"NO_ACCESS\",\r\n \"Latitude\": \"NO_ACCESS\",\r\n \"Longitude\": \"NO_ACCESS\",\r\n \"PhoneNumber\": \"NO_ACCESS\",\r\n \"PostalCode\": \"NO_ACCESS\",\r\n \"State\": \"NO_ACCESS\",\r\n \"Street\": \"NO_ACCESS\",\r\n \"StreetNumber\": \"NO_ACCESS\"\r\n },\r\n \"producerId\": \"6291041001598\",\r\n \"producerName\": \"Example Producer Group Member #1\",\r\n \"productHandlingUnits\": [],\r\n \"sites\": [\r\n {\r\n \"address\": {\r\n \"City\": \"City\",\r\n \"Country\": \"DE\",\r\n \"Email\": \"NO_ACCESS\",\r\n \"Latitude\": 40.7617256,\r\n \"Longitude\": -74.0562128,\r\n \"PhoneNumber\": \"NO_ACCESS\",\r\n \"PostalCode\": \"Postal Code\",\r\n \"State\": \"NO_ACCESS\",\r\n \"Street\": \"Street\",\r\n \"StreetNumber\": \"House Number\"\r\n },\r\n \"id\": \"100024313\",\r\n \"name\": \"6291041001598 - Site 1\",\r\n \"products\": [\r\n {\r\n \"attributes\": [\r\n {\r\n \"key\": \"291002\",\r\n \"label\": \"Harvest included\",\r\n \"value\": \"Included\"\r\n },\r\n {\r\n \"key\": \"97002\",\r\n \"label\": \"Production of certified and non-certified products\",\r\n \"value\": \"NO_ACCESS\"\r\n },\r\n {\r\n \"key\": \"999003\",\r\n \"label\": \"Covered Crops First Harvest in hectares\",\r\n \"value\": \"1\"\r\n },\r\n {\r\n \"key\": \"999102\",\r\n \"label\": \"Covered Crops Total Harvest (first + further) in hectares\",\r\n \"value\": \"NO_ACCESS\"\r\n },\r\n {\r\n \"key\": \"999103\",\r\n \"label\": \"Non -Covered Crops Total Harvest (first + further) in hectares\",\r\n \"value\": \"NO_ACCESS\"\r\n },\r\n {\r\n \"key\": \"55.0\",\r\n \"label\": \"Continuous harvesting for non-covered\",\r\n \"value\": \"NO_ACCESS\"\r\n },\r\n {\r\n \"key\": \"999001\",\r\n \"label\": \"Non -Covered Crops First Harvest in hectares\",\r\n \"value\": \"1\"\r\n },\r\n {\r\n \"key\": \"291001\",\r\n \"label\": \"Product handling included\",\r\n \"value\": \"Facility\"\r\n },\r\n {\r\n \"key\": \"999100.01\",\r\n \"label\": \"Number of growing cycles for covered crops - Number\",\r\n \"value\": \"NO_ACCESS\"\r\n },\r\n {\r\n \"key\": \"999101.01\",\r\n \"label\": \"Number of growing cycles for non-covered crops - Number\",\r\n \"value\": \"NO_ACCESS\"\r\n }\r\n ],\r\n \"categoryId\": \"11\",\r\n \"categoryName\": \"FRUIT AND VEGETABLES\",\r\n \"id\": \"2\",\r\n \"name\": \"Apple\"\r\n }\r\n ]\r\n }\r\n ]\r\n },\r\n {\r\n \"address\": {\r\n \"City\": \"NO_ACCESS\",\r\n \"Country\": \"NO_ACCESS\",\r\n \"Email\": \"NO_ACCESS\",\r\n \"Latitude\": \"NO_ACCESS\",\r\n \"Longitude\": \"NO_ACCESS\",\r\n \"PhoneNumber\": \"NO_ACCESS\",\r\n \"PostalCode\": \"NO_ACCESS\",\r\n \"State\": \"NO_ACCESS\",\r\n \"Street\": \"NO_ACCESS\",\r\n \"StreetNumber\": \"NO_ACCESS\"\r\n },\r\n \"producerId\": \"6291041001604\",\r\n \"producerName\": \"Example Producer Group Member #2\",\r\n \"productHandlingUnits\": [],\r\n \"sites\": [\r\n {\r\n \"address\": {\r\n \"City\": \"City\",\r\n \"Country\": \"DE\",\r\n \"Email\": \"NO_ACCESS\",\r\n \"Latitude\": 40.7617256,\r\n \"Longitude\": -74.0562128,\r\n \"PhoneNumber\": \"NO_ACCESS\",\r\n \"PostalCode\": \"Postal Code\",\r\n \"State\": \"NO_ACCESS\",\r\n \"Street\": \"Street\",\r\n \"StreetNumber\": \"House Number\"\r\n },\r\n \"id\": \"100024329\",\r\n \"name\": \"6291041001604 - Site 1\",\r\n \"products\": [\r\n {\r\n \"attributes\": [\r\n {\r\n \"key\": \"291002\",\r\n \"label\": \"Harvest included\",\r\n \"value\": \"Included\"\r\n },\r\n {\r\n \"key\": \"97002\",\r\n \"label\": \"Production of certified and non-certified products\",\r\n \"value\": \"NO_ACCESS\"\r\n },\r\n {\r\n \"key\": \"999003\",\r\n \"label\": \"Covered Crops First Harvest in hectares\",\r\n \"value\": \"1\"\r\n },\r\n {\r\n \"key\": \"999102\",\r\n \"label\": \"Covered Crops Total Harvest (first + further) in hectares\",\r\n \"value\": \"NO_ACCESS\"\r\n },\r\n {\r\n \"key\": \"999103\",\r\n \"label\": \"Non -Covered Crops Total Harvest (first + further) in hectares\",\r\n \"value\": \"NO_ACCESS\"\r\n },\r\n {\r\n \"key\": \"55.0\",\r\n \"label\": \"Continuous harvesting for non-covered\",\r\n \"value\": \"NO_ACCESS\"\r\n },\r\n {\r\n \"key\": \"999001\",\r\n \"label\": \"Non -Covered Crops First Harvest in hectares\",\r\n \"value\": \"1\"\r\n },\r\n {\r\n \"key\": \"291001\",\r\n \"label\": \"Product handling included\",\r\n \"value\": \"Facility\"\r\n },\r\n {\r\n \"key\": \"999100.01\",\r\n \"label\": \"Number of growing cycles for covered crops - Number\",\r\n \"value\": \"NO_ACCESS\"\r\n },\r\n {\r\n \"key\": \"999101.01\",\r\n \"label\": \"Number of growing cycles for non-covered crops - Number\",\r\n \"value\": \"NO_ACCESS\"\r\n }\r\n ],\r\n \"categoryId\": \"11\",\r\n \"categoryName\": \"FRUIT AND VEGETABLES\",\r\n \"id\": \"2\",\r\n \"name\": \"Apple\"\r\n }\r\n ]\r\n },\r\n {\r\n \"address\": {\r\n \"City\": \"City\",\r\n \"Country\": \"DE\",\r\n \"Email\": \"NO_ACCESS\",\r\n \"Latitude\": 40.761535,\r\n \"Longitude\": -74.056414,\r\n \"PhoneNumber\": \"NO_ACCESS\",\r\n \"PostalCode\": \"Postal Code\",\r\n \"State\": \"NO_ACCESS\",\r\n \"Street\": \"street\",\r\n \"StreetNumber\": \"\"\r\n },\r\n \"id\": \"100024331\",\r\n \"name\": \"6291041001604 - Site 2\",\r\n \"products\": [\r\n {\r\n \"attributes\": [\r\n {\r\n \"key\": \"291002\",\r\n \"label\": \"Harvest included\",\r\n \"value\": \"Included\"\r\n },\r\n {\r\n \"key\": \"97002\",\r\n \"label\": \"Production of certified and non-certified products\",\r\n \"value\": \"NO_ACCESS\"\r\n },\r\n {\r\n \"key\": \"999003\",\r\n \"label\": \"Covered Crops First Harvest in hectares\",\r\n \"value\": \"1\"\r\n },\r\n {\r\n \"key\": \"999102\",\r\n \"label\": \"Covered Crops Total Harvest (first + further) in hectares\",\r\n \"value\": \"NO_ACCESS\"\r\n },\r\n {\r\n \"key\": \"999103\",\r\n \"label\": \"Non -Covered Crops Total Harvest (first + further) in hectares\",\r\n \"value\": \"NO_ACCESS\"\r\n },\r\n {\r\n \"key\": \"55.0\",\r\n \"label\": \"Continuous harvesting for non-covered\",\r\n \"value\": \"NO_ACCESS\"\r\n },\r\n {\r\n \"key\": \"999001\",\r\n \"label\": \"Non -Covered Crops First Harvest in hectares\",\r\n \"value\": \"1\"\r\n },\r\n {\r\n \"key\": \"291001\",\r\n \"label\": \"Product handling included\",\r\n \"value\": \"In field + facility\"\r\n },\r\n {\r\n \"key\": \"999100.01\",\r\n \"label\": \"Number of growing cycles for covered crops - Number\",\r\n \"value\": \"NO_ACCESS\"\r\n },\r\n {\r\n \"key\": \"999101.01\",\r\n \"label\": \"Number of growing cycles for non-covered crops - Number\",\r\n \"value\": \"NO_ACCESS\"\r\n }\r\n ],\r\n \"categoryId\": \"11\",\r\n \"categoryName\": \"FRUIT AND VEGETABLES\",\r\n \"id\": \"95\",\r\n \"name\": \"Plum\"\r\n }\r\n ]\r\n }\r\n ]\r\n }\r\n ]\r\n }\r\n ],\r\n \"producerId\": \"6291041001178\",\r\n \"producerName\": \"Example Producer Group Holder\"\r\n }\r\n ],\r\n \"error\": \"\",\r\n \"status\": 200\r\n}"}],"_postman_id":"1501e753-7021-49ae-b4ea-d0253a4718cc"},{"name":"Read Bookmark Lists","id":"b773472b-fa72-4613-ac5c-302a3bc55c59","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"options\": {\n \"page\": 1,\n \"pageLimit\": 25,\n \"query\": []\n },\n \"countItems\": false\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/data/integration/{{customer}}/field-service-os/read-bookmarks/?application={{application}}&customer={{customer}}&password={{password}}&username={{username}}","description":"

View all bookmark lists your company is set to as the editor or follower.

With the optional query section, we can filter the bookmarks by Editor, Followers, Name and BookmarkId.

The following example would return bookmark lists where the editor was company 10000. Please note this will only work with your own company ID. Using other IDs will result in a permissions error.

{\n    \"options\": {\n        \"page\": 1,\n        \"pageLimit\": 25,\n        \"query\": [{\"key\": \"Editor\", \"value\": \"10000\"}]\n    },\n    \"countItems\": false\n}\n\n

The following example would return bookmark lists where the Follower was company 10000. This for example, would show all lists made by your company, or other companies, that you have permission to view.

{\n    \"options\": {\n        \"page\": 1,\n        \"pageLimit\": 25,\n        \"query\": [{\"key\": \"Follower\", \"value\": \"10000\"}]\n    },\n    \"countItems\": false\n}\n\n

The following example would return bookmark lists where the bookmark ID was 10000. Only one bookmark will be returned, as every bookmark ID is unique.

{\n    \"options\": {\n        \"page\": 1,\n        \"pageLimit\": 25,\n        \"query\": [{\"key\": \"BookmarkId\", \"value\": \"10000\"}]\n    },\n    \"countItems\": false\n}\n\n

The following example would return bookmark lists where the name of the bookmark was Test List 1. Since all bookmarks must have a unique name, this will only return 1 result, at most.

{\n    \"options\": {\n        \"page\": 1,\n        \"pageLimit\": 25,\n        \"query\": [{\"key\": \"Name\", \"value\": \"Test List One\"}]\n    },\n    \"countItems\": false\n}\n\n

\n","urlObject":{"path":["data","integration","{{customer}}","field-service-os","read-bookmarks",""],"host":["{{url}}"],"query":[{"key":"application","value":"{{application}}"},{"key":"customer","value":"{{customer}}"},{"key":"password","value":"{{password}}"},{"key":"username","value":"{{username}}"}],"variable":[]}},"response":[{"id":"383091d3-3a01-4305-a0af-c6a64729e402","name":"Read Bookmark Lists","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"options\": {\n \"page\": 1,\n \"pageLimit\": 25,\n \"query\": []\n },\n \"countItems\": false\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"{{url}}/data/integration/{{customer}}/field-service-os/read-bookmarks/?application={{application}}&customer={{customer}}&password={{password}}&username={{username}}","host":["{{url}}"],"path":["data","integration","{{customer}}","field-service-os","read-bookmarks",""],"query":[{"key":"application","value":"{{application}}"},{"key":"customer","value":"{{customer}}"},{"key":"password","value":"{{password}}"},{"key":"username","value":"{{username}}"}]}},"status":"OK","code":200,"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"{\r\n \"data\": [\r\n {\r\n \"BookmarkId\": \"10000\",\r\n \"ChangeControl\": {\r\n \"TimeStamp\": 1739533679762,\r\n \"UserId\": \"johnsontesting@globalgap.org\"\r\n },\r\n \"Description\": \"\",\r\n \"Editor\": \"10111\",\r\n \"Followers\": [\r\n \"101111\"\r\n ],\r\n \"LastQuery\": 1736780289430,\r\n \"Name\": \"CJ Bookmark Test\",\r\n \"Producers\": [\r\n {\r\n \"ProducerId\": \"6291041001154\",\r\n \"Products\": [\r\n {\r\n \"AdditionalDetails\": {},\r\n \"ProductId\": \"22\"\r\n },\r\n {\r\n \"AdditionalDetails\": {},\r\n \"ProductId\": \"5\"\r\n },\r\n {\r\n \"AdditionalDetails\": {},\r\n \"ProductId\": \"\"\r\n }\r\n ]\r\n }\r\n ],\r\n \"editorName\": \"111111111\",\r\n \"followerNames\": [\r\n \"111111111\"\r\n ]\r\n }"}],"_postman_id":"b773472b-fa72-4613-ac5c-302a3bc55c59"},{"name":"Write Bookmark","id":"8404684c-245e-4f73-969d-4b241536a02a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"bookmarkId\": \"\",\n \"name\": \"\",\n \"description\": \"\",\n\t\"editor\": \"\",\n \"followers\": [\"\"],\n \"producers\": [\n {\n \"producerId\": \"\",\n \"products\": [\n {\n \"productId\": \"\",\n \"attributes\": {}\n }\n ]\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/data/integration/{{customer}}/field-service-os/write-bookmark/?application={{application}}&customer={{customer}}&password={{password}}&username={{username}}","description":"

Replaces old endpoints bookmarkListInsert and bookmarkListUpdate.

If no BookmarkId is supplied, creates a new bookmark. If a bookmark ID is supplied, adds new field values to existing bookmark.

The folllowing fields can be added to the attributes section to include additional information. These fields are optional, and can be included only if a productId is specified.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field Name
deliveryDate
articleName
articleNumber
deliveredAmountUnit
deliveredAmountWeight
distributionCenter
supplierName
eta
firstAdditionalInfo
secondAdditionalInfo

","urlObject":{"path":["data","integration","{{customer}}","field-service-os","write-bookmark",""],"host":["{{url}}"],"query":[{"key":"application","value":"{{application}}"},{"key":"customer","value":"{{customer}}"},{"key":"password","value":"{{password}}"},{"key":"username","value":"{{username}}"}],"variable":[]}},"response":[{"id":"7384a3d9-e175-4d6c-af68-038891267c8e","name":"Create a List with Multiple Producers","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"bookmarkId\": \"\",\n \"name\": \"My First Bookmark\",\n \"description\": \"\",\n\t\"editor\": \"10012\",\n \"followers\": [\"10012\"],\n \"producers\": [\n {\n \"producerId\": \"1234567891019\",\n \"membersIncluded\": true\n },\n {\n \"producerId\": \"34567891012\",\n \"membersIncluded\": true\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"{{url}}/data/integration/{{customer}}/field-service-os/write-bookmark/?application={{application}}&customer={{customer}}&password={{password}}&username={{username}}","host":["{{url}}"],"path":["data","integration","{{customer}}","field-service-os","write-bookmark",""],"query":[{"key":"application","value":"{{application}}"},{"key":"customer","value":"{{customer}}"},{"key":"password","value":"{{password}}"},{"key":"username","value":"{{username}}"}]}},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":null},{"id":"516dbc82-c6b7-4f7f-899b-e83d0ac20f72","name":"Create a List with a Bookmark Item with Additional Details","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"bookmarkId\": \"\",\n \"name\": \"API\",\n \"description\": \"\",\n\t\"editor\": \"10000\",\n \"followers\": [\"10000\"],\n \"producers\": [\n {\n \"producerId\": \"1234567891019\",\n \"membersIncluded\": true,\n \"products\": [\n {\n \"productId\": \"2\",\n \"attributes\": {\n \"deliveryDate\": \"25.12.2024\",\n \"articleName\": \"Cherry\",\n \"articleNumber\": \"111111\",\n \"deliveredAmountUnit\": \"23\",\n \"deliveredAmountWeight\": \"23\",\n \"distributionCenter\": \"Example Center\",\n \"supplierName\": \"Example Farm\",\n \"eta\": \"14:15 GMT\",\n \"firstAdditionalInfo\": \"Bring an extra forklift\",\n \"secondAdditionalInfo\": \"More info\"\n }\n }\n ]\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"{{url}}/data/integration/{{customer}}/field-service-os/write-bookmark/?application={{application}}&customer={{customer}}&password={{password}}&username={{username}}","host":["{{url}}"],"path":["data","integration","{{customer}}","field-service-os","write-bookmark",""],"query":[{"key":"application","value":"{{application}}"},{"key":"customer","value":"{{customer}}"},{"key":"password","value":"{{password}}"},{"key":"username","value":"{{username}}"}]}},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":null}],"_postman_id":"8404684c-245e-4f73-969d-4b241536a02a"},{"name":"Write Bookmark Items","id":"ec43ae6d-ed99-4450-9749-d1fead5aadb8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"bookmarkId\": \"\",\n \"producers\": [\n {\n \"producerId\": \"\",\n \"products\": [\n {\n \"productId\": \"\",\n \"attributes\": {}\n }\n ]\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/data/integration/{{customer}}/field-service-os/write-bookmark-items/?application={{application}}&customer={{customer}}&password={{password}}&username={{username}}","description":"

There are two types of items that can be added.

GGN: Adding a GGN will assign all products of that GGN to the bookmarking list as one item.
\n
Product: Adding a product of a GGN will add all products from the GGN that share the same id. Using the product item allows for the additional data fields to be utilised.
\n

Both types of bookmark items can exist within the same bookmarking list.

\n","urlObject":{"path":["data","integration","{{customer}}","field-service-os","write-bookmark-items",""],"host":["{{url}}"],"query":[{"key":"application","value":"{{application}}"},{"key":"customer","value":"{{customer}}"},{"key":"password","value":"{{password}}"},{"key":"username","value":"{{username}}"}],"variable":[]}},"response":[{"id":"2411a5ea-5be8-4c1d-ac3a-618d7d3cd259","name":"Add Two Producers","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"bookmarkId\": \"19999\",\n \"producers\": [\n {\n \"producerId\": \"1234567891019\",\n \"membersIncluded\": true\n },\n {\n \"producerId\": \"34567891012\",\n \"membersIncluded\": true\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"{{url}}/data/integration/{{customer}}/field-service-os/write-bookmark-items/?application={{application}}&customer={{customer}}&password={{password}}&username={{username}}","host":["{{url}}"],"path":["data","integration","{{customer}}","field-service-os","write-bookmark-items",""],"query":[{"key":"application","value":"{{application}}"},{"key":"customer","value":"{{customer}}"},{"key":"password","value":"{{password}}"},{"key":"username","value":"{{username}}"}]}},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":null},{"id":"1b2d0e4d-6eb4-46d4-87d6-f903a44a7225","name":"Add a Bookmark Item with Additional Details","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"bookmarkId\": \"10056\",\n \"name\": \"CJ Example\",\n \"description\": \"\",\n \"editor\": \"10012\",\n \"followers\": [\n \"10012\"\n ],\n \"producers\": [\n {\n \"producerId\": \"4049929001268\",\n \"products\": [\n {\n \"productId\": \"25\",\n \"attributes\": {\n \"deliveryDate\": \"25.12.2024\",\n \"articleName\": \"Cherry\",\n \"articleNumber\": \"111111\",\n \"deliveredAmountUnit\": \"23\",\n \"deliveredAmountWeight\": \"23\",\n \"distributionCenter\": \"Example Center\",\n \"supplierName\": \"Example Farm\",\n \"eta\": \"14:15 GMT\",\n \"firstAdditionalInfo\": \"Bring an extra forklift\",\n \"secondAdditionalInfo\": \"More info\"\n }\n }\n ]\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"{{url}}/data/integration/{{customer}}/field-service-os/write-bookmark-items/?application={{application}}&customer={{customer}}&password={{password}}&username={{username}}","host":["{{url}}"],"path":["data","integration","{{customer}}","field-service-os","write-bookmark-items",""],"query":[{"key":"application","value":"{{application}}"},{"key":"customer","value":"{{customer}}"},{"key":"password","value":"{{password}}"},{"key":"username","value":"{{username}}"}]}},"status":"OK","code":200,"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"{\r\n \"data\": {\r\n \"BookmarkId\": \"10056\",\r\n \"ChangeControl\": {\r\n \"TimeStamp\": 1733233733851,\r\n \"UserId\": \"cj_test@globalgap.rog\"\r\n },\r\n \"Description\": \"\",\r\n \"Editor\": \"10012\",\r\n \"Followers\": [\r\n \"10012\"\r\n ],\r\n \"LastQuery\": 0,\r\n \"Name\": \"CJ Example\",\r\n \"Producers\": [\r\n {\r\n \"ProducerId\": \"4049929001268\",\r\n \"Products\": [\r\n {\r\n \"AdditionalDetails\": {\r\n \"articleName\": \"Cherry\",\r\n \"articleNumber\": \"111111\",\r\n \"deliveredAmountUnit\": \"23\",\r\n \"deliveredAmountWeight\": \"23\",\r\n \"deliveryDate\": \"25.12.2024\",\r\n \"distributionCenter\": \"Example Center\",\r\n \"eta\": \"14:15 GMT\",\r\n \"firstAdditionalInfo\": \"Bring an extra forklift\",\r\n \"secondAdditionalInfo\": \"More info\",\r\n \"supplierName\": \"Example Farm\"\r\n },\r\n \"ProductId\": \"25\"\r\n }\r\n ]\r\n }\r\n ]\r\n },\r\n \"error\": \"\",\r\n \"status\": 200"}],"_postman_id":"ec43ae6d-ed99-4450-9749-d1fead5aadb8"},{"name":"Write Bookmark Followers","id":"7f1a5d2f-0f36-433b-ac99-91c3f8a87f4c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"bookmarkId\": \"\",\n \"followers\": [\"\"]\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/data/integration/{{customer}}/field-service-os/write-bookmark-followers/?application={{application}}&customer={{customer}}&password={{password}}&username={{username}}","description":"

Update the list of followers who have access to a specific bookmark list. Appends to existing followers.

\n","urlObject":{"path":["data","integration","{{customer}}","field-service-os","write-bookmark-followers",""],"host":["{{url}}"],"query":[{"key":"application","value":"{{application}}"},{"key":"customer","value":"{{customer}}"},{"key":"password","value":"{{password}}"},{"key":"username","value":"{{username}}"}],"variable":[]}},"response":[{"id":"d4490db4-0245-48ba-a546-cc26ff7dff06","name":"Write Bookmark Followers","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"bookmarkId\": \"1000\",\n \"followers\": [\"1000\",\"10002\",\"1003\"]\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"{{url}}/data/integration/{{customer}}/field-service-os/write-bookmark-followers/?application={{application}}&customer={{customer}}&password={{password}}&username={{username}}","host":["{{url}}"],"path":["data","integration","{{customer}}","field-service-os","write-bookmark-followers",""],"query":[{"key":"application","value":"{{application}}"},{"key":"customer","value":"{{customer}}"},{"key":"password","value":"{{password}}"},{"key":"username","value":"{{username}}"}]}},"status":"OK","code":200,"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"{\r\n \"data\": true,\r\n \"error\": \"\",\r\n \"status\": 200\r\n}"}],"_postman_id":"7f1a5d2f-0f36-433b-ac99-91c3f8a87f4c"},{"name":"Delete Bookmark Items","id":"77ab07f1-f174-4f53-aba4-3e4fde15e502","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"bookmarkId\": \"\",\n \"producers\": [\"\"]\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/data/integration/{{customer}}/field-service-os/delete-bookmark-items/?application={{application}}&customer={{customer}}&password={{password}}&username={{username}}","description":"

Deletes listed producer IDs from a bookmark list.

\n","urlObject":{"path":["data","integration","{{customer}}","field-service-os","delete-bookmark-items",""],"host":["{{url}}"],"query":[{"key":"application","value":"{{application}}"},{"key":"customer","value":"{{customer}}"},{"key":"password","value":"{{password}}"},{"key":"username","value":"{{username}}"}],"variable":[]}},"response":[{"id":"2a2e79b8-7438-41d2-86b8-0999d4632d6f","name":"Delete Bookmark Items","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"bookmarkId\": \"19999\",\n \"producers\": [\"1234567891019\"]\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"{{url}}/data/integration/{{customer}}/field-service-os/delete-bookmark-items/?application={{application}}&customer={{customer}}&password={{password}}&username={{username}}","host":["{{url}}"],"path":["data","integration","{{customer}}","field-service-os","delete-bookmark-items",""],"query":[{"key":"application","value":"{{application}}"},{"key":"customer","value":"{{customer}}"},{"key":"password","value":"{{password}}"},{"key":"username","value":"{{username}}"}]}},"status":"OK","code":200,"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"{\r\n \"data\": true,\r\n \"error\": \"\",\r\n \"status\": 200\r\n}"}],"_postman_id":"77ab07f1-f174-4f53-aba4-3e4fde15e502"},{"name":"Unsubscribe","id":"fde74523-507b-4777-bc39-f6b7b1a5c65c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"key\": \"\",\n \"isUnsubscribe\": true\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/data/integration/{{customer}}/field-service-os/delete-bookmark/?application={{application}}&customer={{customer}}&password={{password}}&username={{username}}","description":"

Unsubscribe from a list that your company is a follower or an Editor for. Unfollowing a list as an Editor will delete the list.

Requires a bookmarkId as the \"key\" value.

If \"isUnsubscribe\" is false, and you are the editor of the list, the list will be deleted.

\n","urlObject":{"path":["data","integration","{{customer}}","field-service-os","delete-bookmark",""],"host":["{{url}}"],"query":[{"key":"application","value":"{{application}}"},{"key":"customer","value":"{{customer}}"},{"key":"password","value":"{{password}}"},{"key":"username","value":"{{username}}"}],"variable":[]}},"response":[],"_postman_id":"fde74523-507b-4777-bc39-f6b7b1a5c65c"}],"id":"def2bc09-96fe-42c6-9489-48cfecc9972b","description":"

What is Bookmarking?

GLOBALG.A.P. Bookmarking is the easy way to record and monitor the certification status of your producers.

Support

Please send an e-mail to: customer_support@globalgap.org or call us at +49 221 57776 -100.

Terms of Use

For the use of the API GLOBALG.A.P. Bookmarking Package, please refer to our terms and conditions .

Variables

Below you will the find the corresponding values for accessing the API. You can create a new environment in Postman using these variables, or manually replace them if you are not using Postman to hit these API endpoints.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Variable	Value
application	field-service-os
customer	foodplus
url	https://prod.osapiens.cloud
username	Your username
password	Your password

","_postman_id":"def2bc09-96fe-42c6-9489-48cfecc9972b"}],"event":[{"listen":"prerequest","script":{"id":"a79712fa-5ac2-42f7-911b-265c5fa4d0a5","type":"text/javascript","packages":{},"exec":[""]}},{"listen":"test","script":{"id":"52e9f05f-9530-4b10-8e0b-5908c704bb92","type":"text/javascript","packages":{},"exec":[""]}}]}