Click the user name on the menu to open My Profile.
Use of this API is subject to the Terms of Service as outlined by USDA's Agricultural Marketing Service.
The Organic INTEGRITY Database (INTEGRITY) API allows developers to incorporate organic operation data into their applications. INTEGRITY offers REST & SOAP access to get a download of all/filtered organic operations in the system in XML or JSON format depending on the request.
INTEGRITY’s DownloadAPI OIDPublicDataService has method GetAllOperationsPublicData with the following URL to download a Zip file of all the organic operations in XML format from your browser. An API key is required to be passed in the URL. https://organicapi.ams.usda.gov/IntegrityPubDataServices/OidPublicDataService.svc/rest/GetAllOperationsPublicData?api_key=APIKEY_STRING
Anyone may access and use the API. However, a data.gov API key must be incorporated into the API request. INTEGRITY uses the shared, interagency service api.data.gov to provide an optimized experience for users. After you register, you can use one key to gain universal access to any Open Government data using the service. The API key can be obtained at https://api.data.gov/signup/
Rate Limits
We currently limit the number of API requests to a default rate of 1,000 requests per hour per API Key. Exceeding this limit will cause your API key to be temporarily blocked for one hour. More detailed information on rate limits and other general information can be found at http://api.data.gov/docs/
The service can be called using SOAP or REST. The Rest response can be in XML or JSON format depending on the request. The new methods are listed below. An API key is required to be passed in the URL for every method.
https://organicapi.ams.usda.gov/IntegrityPubDataServices/OidPublicDataService.svc?wsdl&api_key=APIKEY_STRING
https://organicapi.ams.usda.gov/IntegrityPubDataServices/OidPublicDataService.svc/soap?api_key=APIKEY_STRING
Method: GetAllOperationsPublicData();
Description: Returns a Zip file of all the organic operations in XML format.
URL: https://organicapi.ams.usda.gov/IntegrityPubDataServices/OidPublicDataService.svc/rest/GetAllOperationsPublicData?api_key=APIKEY_STRING
Method: Operations(List<string> countries, List<string> states, DateTime? fromDate, DateTime? toDate, int startIdx, int count);
Description: Returns subset of the certified organic operations based on countries, states, From & To Status Effective Date filters.
URL: https://organicapi.ams.usda.gov/IntegrityPubDataServices/OidPublicDataService.svc/rest/Operations?api_key=APIKEY_STRING
Method: OperationsCount(List<string> countries, List<string> states, DateTime? fromDate, DateTime? toDate);
Description: Returns certified organic operations count based on countries, states, From & To Status Effective Date filters.
URL: https://organicapi.ams.usda.gov/IntegrityPubDataServices/OidPublicDataService.svc/rest/Operations/Count?api_key=APIKEY_STRING
Method: Items(string operationId, int startIdx, int count);
Description: Returns Products/Items for selected Nop Operation ID.
URL: https://organicapi.ams.usda.gov/IntegrityPubDataServices/OidPublicDataService.svc/rest/Items?api_key=APIKEY_STRING
Method: ItemsCount(string operationId);
Description: Returns count of Products/Items for selected Nop Operation ID.
URL: https://organicapi.ams.usda.gov/IntegrityPubDataServices/OidPublicDataService.svc/rest/Items/Count?api_key=APIKEY_STRING
Method: Operation(string operationId);
Description: Returns all public information for selected certified organic operation.
URL: https://organicapi.ams.usda.gov/IntegrityPubDataServices/OidPublicDataService.svc/rest/Operations/Operation?api_key=APIKEY_STRING
class Program { static void Main(string[] args) { CallRestSVC(); } public static void CallRestSVC() { try { WebClient wc = new WebClient(); wc.DownloadFile("https://organicapi.ams.usda.gov/IntegrityPubDataServices/OidPublicDataService.svc/rest/ GetAllOperationsPublicData?&api_key=APIKEY_STRING ", "Operations.zip"); } catch (Exception ex) { Console.WriteLine(ex.ToString()); } } }
The below table specifies Elements in the Operations XML data from GetAllOperationsPublicData method