{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"9007f0fe-7b1d-4745-ba48-bf95970f534f","name":"GRID RESTEasy API Version 2.0","description":"# **GRID Services Overview**\n\nGRID is a diligence technology provider with a SaaS solution that supports screening of our Clients’ customers and other business relationships against the MA KYC proprietary GRID™ database. As such, MA KYC delivers powerful, decision-ready intelligence and world class risk and compliance protection, allowing global organizations to identify banned / suspect entities, strengthen fraud protection, ensure regulatory compliance, manage supply and distribution risk and protect their brand equity.\n\nThe GRID solution allows Clients’ to create specific filters to ensure that the screening matches their unique risk requirements, as well as additional and / optional services such as MA KYC analyst review, automated daily portfolio monitoring, and the use of GRID's web portal for alert decisioning.\n\n## Concepts\n\n### Firms\n\nMA KYC segregates usage of the services between individual Clients and Clients own business units or regions, with the use of Firms. Each Firm provides a secure area for a client to access the services, complete their screening and allows for customization of the service usage, and risk parameters to achieve accurate screening. Firm configuration will be completed by MA KYC Support personnel only.\n\nNote: User accounts are unique to each firm for web services access. See REST API chapter for more details.\n\nNote: Each MA KYC Firm is setup by default to allow for 10,000 API inquiries per day. MA KYC systems are configured to scale to each Client’s needs, so those requiring higher volumes are requested to reach out to their MA KYC Account Manager and support. Reaching daily API limits will block further calls from being made.\n\n### Inquiries\n\nInquiries are used to submit a name of a Person or Organization to be searched against the MA KYC GRID. Each inquiry will be required to have at minimum a surname name or organization name, however additional information provided, such as address, date of birth, country, is used to ensure an accurate search and minimize false positives.\n\nFor Web Services inquiries can be submitted singularly or in batches subject to the use of the correct API operation.\n\nMA KYC highly recommends that inquiry names be submitted in English which is then matched using MA KYC name matching technology. MA KYC’s GRID Profiles are stored \nin English regardless of the origin of the individual or organization. For a number of profiles, MA KYC will also store local script aliases with UTF-8 encoding. However, if non-Roman scripts, (such as Chinese, Arabic, etc.), are used as the inquiry name in UTF-8 format, MA KYC will attempt to match the names to local script aliases against entities in the GRID database and also by transliteration of the name to a Romanized version.\n\nNote: Clients can also submit inquiries directly from the MA KYC web portal ([https://grid.rdc.com](https://grid.rdc.com)) or via batch file via SFTP. These options are described in other documents.\n\n### Batches\n\nEach set of inquiries submitted will be allocated a batch number. A batch will always contain one or more inquiries submitted. \nWhen configured for Portfolio Monitoring, a new batch will be created each day by MA KYC to contain all active inquiries within the portfolio to return the new Alerts generated.\n\n### Alerts\n\nAlerts are the potential matches found when MA KYC queries the inquiry name against the GRID database. The results are based on the client’s filter settings as defined within the Firm and can indicate that either no match was found or that potential matches have been alerted. Each potential match will be an Entity from the GRID database.\n\nIn addition to the standard MA KYC Inquiry Service, there are optional services available, as shown in Figure 1-1 and explained in the Optional Review Services section below. If optional services, such as analyst review or portfolio monitoring, have been selected, then these services will be completed prior to the response being sent back to the client application.\n\n\n\n### Entities\n\nEach Entity is a unique profile of a Person or Organization that MA KYC has curated within its GRID Database. The Entity contains the details of the Risk, be that a PEP, Sanction or Adverse Media article that has been identified from numerous sources. Additionally, the Entity record will contain additional information such as known age or date of birth, address information, nationality, relationships to other Entities, and aliases.\n\nMore than one Entity may be returned as a potential match in an alert generated per search completed, for example where only a name is searched with no additional identifiers such as date of birth or address, it is common for multiple matches to be found across many countries.\n\n## Optional Services\n\nThe optional services described here may extend the inquiry response time, depending on the services selected by each client.\n\n### MA KYC Analyst Review\n\nAfter a Client submits an inquiry, the MA KYC Analysts review all matches and provide results that reflect each client’s individual discounting requirements. Email notifications can be sent as the names are reviewed. Match results are available via the web portal and summary reports are available as soon as batches are complete. The historical results of batches and alerts can also be viewed via the web portal. \nEnabling MA KYC Analyst Review is a configuration step that occurs outside of the integration process and, as all potential matches are MA KYC analyst reviewed before the response is generated, response time is affected.\n\nNote: Test Firms will not have MA KYC review enabled so responses may differ when testing the API response. Some response types are only applicable when Analyst Review is enabled on the firm.\n\n### Client Analyst Review\n\nA Client’s own compliance team members can review the MA KYC screening results directly within the MA KYC web portal, independent of whether the MA KYC analyst review service is utilized. In this way, a client can decide whether to include the potentially matching GRID record’s details in the inquiry’s final results set. If this capability is enabled, the step is inserted before the response is sent back to the client’s solution.\n\nNote: Enabling Client Analyst Review, also known as Client Alert Decisioning (iCAD), is a configuration step that occurs outside the API integration and will impact responses due to the analyst decision being required before the final response is generated.\n\n### Portfolio Monitoring\n\nPortfolio Monitoring is a service wherein the MA KYC solution automatically checks all new GRID updates against the client’s existing portfolio of inquiry names on a daily basis. When enabled, clients no longer need to re-screen their entire portfolio for new negative information as alerts will be automatically generated as this new information is found that meets the client’s filter requirements.\n\nClients have the option of having these alerts pushed to the them via an API connection initiated by MA KYC, or receiving via web portal, email or batch files over SFTP. If the MA KYC Analyst Review service is utilized or the Client Alert Decisioning tool is enabled, then any potential alerts are routed through those services. Any alerts are then packaged to be returned to the client system. \nFor Clients who want to load items directly into monitoring without conducting an initial screening, MA KYC Inquiry Service allows a Load Only tag to be submitted with the inquiry.\n\n### Multiple Firm Access\n\nMA KYC supports multiple firm access via API. This functionality allows client to access multiple firms/accounts by adding a target firm ID in the query parameter. This functionality allows user to modify any inquiry targeted to that firm without logging into to the targeted firm. This needs to be set up by the MA KYC during Onboarding so please ask your account manager to have this functionality enabled if required.","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"4281497","team":1084057,"collectionId":"9007f0fe-7b1d-4745-ba48-bf95970f534f","publishedId":"2s7Z16i22c","public":true,"publicUrl":"https://documenter-api.postman.tech/view/4281497/2s7Z16i22c","privateUrl":"https://go.postman.co/documentation/4281497-9007f0fe-7b1d-4745-ba48-bf95970f534f","customColor":{"top-bar":"051583","right-sidebar":"627FB4","highlight":"051583"},"documentationLayout":"classic-double-column","customisation":null,"version":"8.10.1","publishDate":"2022-09-26T18:11:51.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{},"logos":{}},"statusCode":200},"environments":[{"name":"GRID Environments","id":"54631ea8-f217-4ff6-8631-ff52b5f839e3","owner":"4281497","values":[{"key":"access_token","value":"","enabled":true},{"key":"refresh_token","value":"","enabled":true},{"key":"baseUrl","value":"/api/grid-service/v2","enabled":true},{"key":"environment","value":"https://service.rdc.com","enabled":true},{"key":"username","value":"PutUserNameHere","enabled":true},{"key":"password","value":"StrongSample0$","enabled":true},{"key":"environment","value":"https://service.rdc.eu.com","enabled":false}],"published":true}],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/65fbaf06556da0d2a920f30865c0c78e7b132c756e4312e4e1c65aeaa4a04488","favicon":""},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"},{"label":"GRID Environments","value":"4281497-54631ea8-f217-4ff6-8631-ff52b5f839e3"}],"canonicalUrl":"https://documenter.gw.postman.com/view/metadata/2s7Z16i22c"}