{"openapi":"3.0.3","info":{"title":"Compliance Monitoring API","description":"Compliance Monitoring API","version":"2.0.0"},"servers":[{"url":"https://api.company.info/compliance/monitor/v2"}],"security":[{"ApiKeyAuth":[]}],"paths":{"/follow-lists":{"get":{"tags":["Follow Lists"],"parameters":[{"name":"page","in":"query","style":"deepObject","description":"`size`defines the number of records to return in each page.  default value: 10, maximum value: 20.  <br>`cursor`specifies the next page cursor.","schema":{"$ref":"#/components/schemas/Page"}}],"responses":{"200":{"description":"OK","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/ListOfFollowList"}}},"headers":{"X-Correlation-Id":{"schema":{"type":"string","format":"uuid","description":"Unique request identifier"}},"X-Ratelimit-Limit":{"schema":{"type":"integer","description":"The number of request available in a rate limit window"}},"X-Ratelimit-Remaining":{"schema":{"type":"integer","description":"The number of requests left for the rate limit window"}},"X-Ratelimit-Reset":{"schema":{"type":"integer","description":"The Unix timestamp at which the current rate limit window resets"}}}},"400":{"description":"Bad Request","content":{"application/vnd.api+json":{"schema":{"title":"JSON:API Error Response","type":"object","required":["errors"],"properties":{"errors":{"title":"An array of Error objects","type":"array","minItems":1,"items":{"type":"object","required":["status","code","title","detail"],"properties":{"status":{"description":"the HTTP status code applicable to this problem","type":"string","minLength":3,"maxLength":3},"code":{"description":"an application-specific error code. It can be the same as 'status'","type":"string"},"title":{"description":"a short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization","type":"string"},"detail":{"description":"a human-readable explanation specific to this occurrence of the problem. Like title, this field’s value can be localized","type":"string"}}}}}}}}},"401":{"description":"Unauthorized","content":{"application/vnd.api+json":{"schema":{"$ref":"#/paths/~1follow-lists/get/responses/400/content/application~1vnd.api%2Bjson/schema"}}}},"403":{"description":"Forbidden","content":{"application/vnd.api+json":{"schema":{"$ref":"#/paths/~1follow-lists/get/responses/400/content/application~1vnd.api%2Bjson/schema"}}}},"404":{"description":"Not Found","content":{"application/vnd.api+json":{"schema":{"$ref":"#/paths/~1follow-lists/get/responses/400/content/application~1vnd.api%2Bjson/schema"}}}},"500":{"description":"Internal Server Error","content":{"application/vnd.api+json":{"schema":{"$ref":"#/paths/~1follow-lists/get/responses/400/content/application~1vnd.api%2Bjson/schema"}}}}}},"post":{"tags":["Follow Lists"],"requestBody":{"description":"Follow List payload.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/NewFollowList"}],"example":{"data":{"type":"follow-lists","attributes":{"dateOfBirthMatching":"withinThreeYears","name":"Follow List - 1","threshold":85,"frequency":"daily","datasets":["PEP"]}}}}}}},"responses":{"201":{"description":"Created","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/FollowList"},"example":{"data":{"id":"01ARZ3NDEKTSV4RRFFQ69G5FAV","type":"follow-lists","attributes":{"dateOfBirthMatching":"withinThreeYears","name":"Follow List - 1","threshold":85,"frequency":"daily","datasets":["PEP"],"dateOfBirthRequired":false,"countryRequired":false,"matching":"fuzzy","pepTiers":[]},"links":{"self":"https://example.com/follow-lists/01ARZ3NDEKTSV4RRFFQ69G5FAV"}}}}},"headers":{"X-Correlation-Id":{"schema":{"type":"string","format":"uuid","description":"Unique request identifier"}},"X-Ratelimit-Limit":{"schema":{"type":"integer","description":"The number of request available in a rate limit window"}},"X-Ratelimit-Remaining":{"schema":{"type":"integer","description":"The number of requests left for the rate limit window"}},"X-Ratelimit-Reset":{"schema":{"type":"integer","description":"The Unix timestamp at which the current rate limit window resets"}}}},"400":{"$ref":"#/paths/~1follow-lists/get/responses/400"},"401":{"$ref":"#/paths/~1follow-lists/get/responses/401"},"403":{"$ref":"#/paths/~1follow-lists/get/responses/403"},"404":{"$ref":"#/paths/~1follow-lists/get/responses/404"},"500":{"$ref":"#/paths/~1follow-lists/get/responses/500"}}}},"/follow-lists/{follow_list_id}":{"get":{"tags":["Follow Lists"],"parameters":[{"name":"follow_list_id","in":"path","required":true,"description":"The ID of the Follow List that will be returned.","schema":{"$ref":"#/components/schemas/ID"}}],"responses":{"200":{"description":"OK","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/FullFollowList"},"example":{"data":{"id":"01ARZ3NDEKTSV4RRFFQ69G5FAV","type":"follow-lists","attributes":{"lastScreenedDateISO":"2022-06-11T00:00:00.000Z","dateOfBirthMatching":"withinThreeYears","name":"Follow List - 1","threshold":85,"frequency":"daily","datasets":["PEP"],"dateOfBirthRequired":false,"countryRequired":false,"matching":"fuzzy","businessTruePositiveAlertsCount":0,"businessDiscardedAlertsCount":0,"businessOpenSubscriptionsCount":0,"businessOpenAlertsCount":0,"personFalsePositiveAlertsCount":0,"personOpenAlertsCount":0,"personTruePositiveAlertsCount":0,"personDiscardedAlertsCount":0,"businessFalsePositiveAlertsCount":0,"businessSubscriptionsCount":0,"personOpenSubscriptionsCount":0,"personSubscriptionsCount":0,"pepTiers":[]},"links":{"self":"https://example.com/follow-lists/01ARZ3NDEKTSV4RRFFQ69G5FAV"}}}}},"headers":{"X-Correlation-Id":{"schema":{"type":"string","format":"uuid","description":"Unique request identifier"}},"X-Ratelimit-Limit":{"schema":{"type":"integer","description":"The number of request available in a rate limit window"}},"X-Ratelimit-Remaining":{"schema":{"type":"integer","description":"The number of requests left for the rate limit window"}},"X-Ratelimit-Reset":{"schema":{"type":"integer","description":"The Unix timestamp at which the current rate limit window resets"}}}},"400":{"$ref":"#/paths/~1follow-lists/get/responses/400"},"401":{"$ref":"#/paths/~1follow-lists/get/responses/401"},"403":{"$ref":"#/paths/~1follow-lists/get/responses/403"},"404":{"$ref":"#/paths/~1follow-lists/get/responses/404"},"500":{"$ref":"#/paths/~1follow-lists/get/responses/500"}}},"put":{"tags":["Follow Lists"],"parameters":[{"name":"follow_list_id","in":"path","required":true,"description":"The ID of the Follow List that will be updated.","schema":{"$ref":"#/components/schemas/ID"}}],"requestBody":{"description":"Follow List payload.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/NewFollowList"}],"example":{"data":{"type":"follow-lists","attributes":{"dateOfBirthMatching":"withinThreeYears","name":"Follow List - 1","threshold":85,"frequency":"daily","datasets":["PEP"]}}}}}}},"responses":{"200":{"description":"OK","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/FollowList"},"example":{"data":{"id":"01ARZ3NDEKTSV4RRFFQ69G5FAV","type":"follow-lists","attributes":{"dateOfBirthMatching":"withinThreeYears","name":"Follow List - 1","threshold":85,"frequency":"daily","datasets":["PEP"],"dateOfBirthRequired":false,"countryRequired":false,"matching":"fuzzy","pepTiers":[]},"links":{"self":"https://example.com/follow-lists/01ARZ3NDEKTSV4RRFFQ69G5FAV"}}}}},"headers":{"X-Correlation-Id":{"schema":{"type":"string","format":"uuid","description":"Unique request identifier"}},"X-Ratelimit-Limit":{"schema":{"type":"integer","description":"The number of request available in a rate limit window"}},"X-Ratelimit-Remaining":{"schema":{"type":"integer","description":"The number of requests left for the rate limit window"}},"X-Ratelimit-Reset":{"schema":{"type":"integer","description":"The Unix timestamp at which the current rate limit window resets"}}}},"400":{"$ref":"#/paths/~1follow-lists/get/responses/400"},"401":{"$ref":"#/paths/~1follow-lists/get/responses/401"},"403":{"$ref":"#/paths/~1follow-lists/get/responses/403"},"404":{"$ref":"#/paths/~1follow-lists/get/responses/404"},"500":{"$ref":"#/paths/~1follow-lists/get/responses/500"}}},"delete":{"description":"Deletes a Follow List with a given ID.\n**IMPORTANT** Deletes **all** subscriptions in a Follow List as well.","tags":["Follow Lists"],"parameters":[{"name":"follow_list_id","in":"path","required":true,"description":"The ID of the Follow List that will be deleted.","schema":{"$ref":"#/components/schemas/ID"}}],"responses":{"204":{"description":"No Content","headers":{"X-Correlation-Id":{"schema":{"type":"string","format":"uuid","description":"Unique request identifier"}},"X-Ratelimit-Limit":{"schema":{"type":"integer","description":"The number of request available in a rate limit window"}},"X-Ratelimit-Remaining":{"schema":{"type":"integer","description":"The number of requests left for the rate limit window"}},"X-Ratelimit-Reset":{"schema":{"type":"integer","description":"The Unix timestamp at which the current rate limit window resets"}}}},"400":{"$ref":"#/paths/~1follow-lists/get/responses/400"},"401":{"$ref":"#/paths/~1follow-lists/get/responses/401"},"403":{"$ref":"#/paths/~1follow-lists/get/responses/403"},"404":{"$ref":"#/paths/~1follow-lists/get/responses/404"},"500":{"$ref":"#/paths/~1follow-lists/get/responses/500"}}}},"/follow-lists/{follow_list_id}/subscriptions/persons":{"get":{"tags":["Persons Subscriptions"],"parameters":[{"name":"follow_list_id","in":"path","required":true,"description":"The ID of the Follow List where a Subscription will be created.","schema":{"$ref":"#/components/schemas/ID"}},{"name":"page","in":"query","style":"deepObject","description":"`size`defines the number of records to return in each page.  default value: 10, maximum value: 20.  <br>`cursor`specifies the next page cursor.","schema":{"$ref":"#/components/schemas/Page"}},{"name":"status","schema":{"type":"string","enum":["open","closed"]},"in":"query","required":false,"description":"Filters Subscriptions by status. If not present, all Subscriptions are returned."}],"responses":{"200":{"description":"OK","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/ListOfPersonSubscriptions"},"example":{"data":[{"type":"subscriptions","id":"01H2TC48NQGJ1RXJBQC3GR72QC","attributes":{"countries":["US"],"createdDateTimeISO":"2023-05-10T11:24:12.515Z","dateOfBirth":"1957-06-29","discardedCount":0,"falsePositiveCount":0,"gender":"female","lastUpdatedDateTimeISO":"2023-05-10T14:35:48.019Z","name":"Jane Doe","openCount":0,"truePositiveCount":0},"links":{"self":"https://example.com/follow-lists/01H3T8GTDTYBFDSE99N7QZ9KK8/subscriptions/persons/01H2TC48NQGJ1RXJBQC3GR72QC"}}],"links":{"next":"https://example.com/follow-lists/01H3T8GTDTYBFDSE99N7QZ9KK8/subscriptions/persons?page[cursor]=eyJnc2kxaGFQ0dHUjdUUVYifQ==&page[size]=1","self":"https://example.com/follow-lists/01H3T8GTDTYBFDSE99N7QZ9KK8/subscriptions/persons?page[size]=1"},"meta":{"discardedAlertsCount":0,"falsePositiveAlertsCount":0,"openAlertsCount":0,"openSubscriptionsCount":0,"subscriptionsCount":2,"truePositiveAlertsCount":0}}}},"headers":{"X-Correlation-Id":{"schema":{"type":"string","format":"uuid","description":"Unique request identifier"}},"X-Ratelimit-Limit":{"schema":{"type":"integer","description":"The number of request available in a rate limit window"}},"X-Ratelimit-Remaining":{"schema":{"type":"integer","description":"The number of requests left for the rate limit window"}},"X-Ratelimit-Reset":{"schema":{"type":"integer","description":"The Unix timestamp at which the current rate limit window resets"}}}},"400":{"$ref":"#/paths/~1follow-lists/get/responses/400"},"401":{"$ref":"#/paths/~1follow-lists/get/responses/401"},"403":{"$ref":"#/paths/~1follow-lists/get/responses/403"},"404":{"$ref":"#/paths/~1follow-lists/get/responses/404"},"500":{"$ref":"#/paths/~1follow-lists/get/responses/500"}}},"post":{"tags":["Persons Subscriptions"],"parameters":[{"name":"follow_list_id","in":"path","required":true,"description":"The ID of the Follow List where a Subscription will be created.","schema":{"$ref":"#/components/schemas/ID"}}],"requestBody":{"description":"Subscription payload.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/NewPersonSubscription"}],"example":{"data":{"type":"subscriptions","attributes":{"name":"Jane Doe","countries":["US"],"dateOfBirth":"1991-07-22","gender":"female"}}}}}}},"responses":{"201":{"description":"Created","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/UpdatedPersonSubscription"},"example":{"data":{"id":"01ARZ3NDEKTSV4RRFFQ69G5FAV","type":"subscriptions","attributes":{"name":"Jane Doe","countries":["US"],"dateOfBirth":"1991-07-22","gender":"female"},"links":{"self":"https://example.com/follow-lists/93CVS1NDEKTSV4RRFFQ69F2FDC/subscriptions/persons/01ARZ3NDEKTSV4RRFFQ69G5FAV"}}}}},"headers":{"X-Correlation-Id":{"schema":{"type":"string","format":"uuid","description":"Unique request identifier"}},"X-Ratelimit-Limit":{"schema":{"type":"integer","description":"The number of request available in a rate limit window"}},"X-Ratelimit-Remaining":{"schema":{"type":"integer","description":"The number of requests left for the rate limit window"}},"X-Ratelimit-Reset":{"schema":{"type":"integer","description":"The Unix timestamp at which the current rate limit window resets"}}}},"400":{"$ref":"#/paths/~1follow-lists/get/responses/400"},"401":{"$ref":"#/paths/~1follow-lists/get/responses/401"},"403":{"$ref":"#/paths/~1follow-lists/get/responses/403"},"404":{"$ref":"#/paths/~1follow-lists/get/responses/404"},"500":{"$ref":"#/paths/~1follow-lists/get/responses/500"}}}},"/follow-lists/{follow_list_id}/subscriptions/persons/{subscription_id}":{"get":{"tags":["Persons Subscriptions"],"parameters":[{"name":"follow_list_id","in":"path","required":true,"description":"The ID of the Follow List that the Subscription belongs to.","schema":{"$ref":"#/components/schemas/ID"}},{"name":"subscription_id","in":"path","required":true,"description":"The ID of the Subscription that will be returned.","schema":{"$ref":"#/components/schemas/ID"}}],"responses":{"200":{"description":"OK","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/FullPersonSubscription"},"example":{"data":{"id":"01ARZ3NDEKTSV4RRFFQ69G5FAV","type":"subscriptions","attributes":{"name":"Jane Doe","countries":["US"],"dateOfBirth":"1991-07-22","gender":"female","openCount":1,"falsePositiveCount":0,"truePositiveCount":0,"discardedCount":0},"links":{"self":"https://example.com/follow-lists/93CVS1NDEKTSV4RRFFQ69F2FDC/subscriptions/persons/01ARZ3NDEKTSV4RRFFQ69G5FAV"}}}}},"headers":{"X-Correlation-Id":{"schema":{"type":"string","format":"uuid","description":"Unique request identifier"}},"X-Ratelimit-Limit":{"schema":{"type":"integer","description":"The number of request available in a rate limit window"}},"X-Ratelimit-Remaining":{"schema":{"type":"integer","description":"The number of requests left for the rate limit window"}},"X-Ratelimit-Reset":{"schema":{"type":"integer","description":"The Unix timestamp at which the current rate limit window resets"}}}},"400":{"$ref":"#/paths/~1follow-lists/get/responses/400"},"401":{"$ref":"#/paths/~1follow-lists/get/responses/401"},"403":{"$ref":"#/paths/~1follow-lists/get/responses/403"},"404":{"$ref":"#/paths/~1follow-lists/get/responses/404"},"500":{"$ref":"#/paths/~1follow-lists/get/responses/500"}}},"put":{"tags":["Persons Subscriptions"],"parameters":[{"name":"follow_list_id","in":"path","required":true,"description":"The ID of the Follow List that the Subscription belongs to.","schema":{"$ref":"#/components/schemas/ID"}},{"name":"subscription_id","in":"path","required":true,"description":"The ID of the Subscription that will be updated.","schema":{"$ref":"#/components/schemas/ID"}}],"requestBody":{"description":"Subscription payload.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/NewPersonSubscription"}],"example":{"data":{"type":"subscriptions","attributes":{"name":"Jane Doe","countries":["US"],"dateOfBirth":"1991-07-22","gender":"female"}}}}}}},"responses":{"200":{"description":"OK","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/UpdatedPersonSubscription"},"example":{"data":{"id":"01ARZ3NDEKTSV4RRFFQ69G5FAV","type":"subscriptions","attributes":{"name":"Jane Doe","countries":["US"],"dateOfBirth":"1991-07-22","gender":"female"},"links":{"self":"https://example.com/follow-lists/93CVS1NDEKTSV4RRFFQ69F2FDC/subscriptions/persons/01ARZ3NDEKTSV4RRFFQ69G5FAV"}}}}},"headers":{"X-Correlation-Id":{"schema":{"type":"string","format":"uuid","description":"Unique request identifier"}},"X-Ratelimit-Limit":{"schema":{"type":"integer","description":"The number of request available in a rate limit window"}},"X-Ratelimit-Remaining":{"schema":{"type":"integer","description":"The number of requests left for the rate limit window"}},"X-Ratelimit-Reset":{"schema":{"type":"integer","description":"The Unix timestamp at which the current rate limit window resets"}}}},"400":{"$ref":"#/paths/~1follow-lists/get/responses/400"},"401":{"$ref":"#/paths/~1follow-lists/get/responses/401"},"403":{"$ref":"#/paths/~1follow-lists/get/responses/403"},"404":{"$ref":"#/paths/~1follow-lists/get/responses/404"},"500":{"$ref":"#/paths/~1follow-lists/get/responses/500"}}},"delete":{"tags":["Persons Subscriptions"],"parameters":[{"name":"follow_list_id","in":"path","required":true,"description":"The ID of the Follow List that the Subscription belongs to.","schema":{"$ref":"#/components/schemas/ID"}},{"name":"subscription_id","in":"path","required":true,"description":"The ID of the Subscription that will be deleted.","schema":{"$ref":"#/components/schemas/ID"}}],"responses":{"204":{"description":"No Content","headers":{"X-Correlation-Id":{"schema":{"type":"string","format":"uuid","description":"Unique request identifier"}},"X-Ratelimit-Limit":{"schema":{"type":"integer","description":"The number of request available in a rate limit window"}},"X-Ratelimit-Remaining":{"schema":{"type":"integer","description":"The number of requests left for the rate limit window"}},"X-Ratelimit-Reset":{"schema":{"type":"integer","description":"The Unix timestamp at which the current rate limit window resets"}}}},"400":{"$ref":"#/paths/~1follow-lists/get/responses/400"},"401":{"$ref":"#/paths/~1follow-lists/get/responses/401"},"403":{"$ref":"#/paths/~1follow-lists/get/responses/403"},"404":{"$ref":"#/paths/~1follow-lists/get/responses/404"},"500":{"$ref":"#/paths/~1follow-lists/get/responses/500"}}}},"/follow-lists/{follow_list_id}/subscriptions/persons/{subscription_id}/alerts":{"get":{"tags":["Persons Alerts"],"parameters":[{"name":"follow_list_id","in":"path","required":true,"description":"The ID of the Follow List where a Subscription will be created.","schema":{"$ref":"#/components/schemas/ID"}},{"name":"subscription_id","in":"path","required":true,"description":"The ID of the Subscription that is used to get Alerts. All Alerts are the matching profiles for the given Subscription.","schema":{"$ref":"#/components/schemas/ID"}},{"name":"page","in":"query","style":"deepObject","description":"`size`defines the number of records to return in each page.  default value: 10, maximum value: 20.  <br>`cursor`specifies the next page cursor.","schema":{"$ref":"#/components/schemas/Page"}}],"responses":{"200":{"description":"OK","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/ListOfPersonAlerts"},"example":{"data":[{"type":"reviews","id":"NQZGEVkxH3oUZAFaFRA=","attributes":{"countries":["tm"],"currentStatus":"true-positive","datasets":["RRE","PEP-FORMER"],"datesOfBirth":["1957-06-29"],"gender":"male","match":"Jane Doe","matchVersion":7,"name":"Jane Marie Doe","pepTier":"PEP Tier 1","personID":"NQZGEVkxH3pAYV0KQhQTXV0gFFJ9QAFKUXJZWmENWl1SJ2QhBnlBKWYmElp2QFp5f28EURVGFFxTdgBaCABXGWFTVwFUchY=","profileImage":"https://www.acurisriskintelligence.com/cdn/content/0020615000/0020612599.jpg","score":100,"version":1673422459727},"links":{"self":"https://example.com/follow-lists/01H3T8GTDTYBFDSE99N7QZ9KK8/subscriptions/persons/01H2TC48NQGJ1RXJBQC3GR72QC/alerts/NQZGEVkxH3oUZAFaFRA="}}],"links":{"next":"https://example.com/follow-lists/01H3T8GTDTYBFDSE99N7QZ9KK8/subscriptions/persons/alerts?page[cursor]=eyJnc2kxaGFQ0dHUjdUUVYifQ==&page[size]=1","self":"https://example.com/follow-lists/01H3T8GTDTYBFDSE99N7QZ9KK8/subscriptions/persons/alerts?page[size]=1"}}}},"headers":{"X-Correlation-Id":{"schema":{"type":"string","format":"uuid","description":"Unique request identifier"}},"X-Ratelimit-Limit":{"schema":{"type":"integer","description":"The number of request available in a rate limit window"}},"X-Ratelimit-Remaining":{"schema":{"type":"integer","description":"The number of requests left for the rate limit window"}},"X-Ratelimit-Reset":{"schema":{"type":"integer","description":"The Unix timestamp at which the current rate limit window resets"}}}},"400":{"$ref":"#/paths/~1follow-lists/get/responses/400"},"401":{"$ref":"#/paths/~1follow-lists/get/responses/401"},"403":{"$ref":"#/paths/~1follow-lists/get/responses/403"},"404":{"$ref":"#/paths/~1follow-lists/get/responses/404"},"500":{"$ref":"#/paths/~1follow-lists/get/responses/500"}}}},"/follow-lists/{follow_list_id}/subscriptions/persons/{subscription_id}/alerts/{monitoring_id}":{"get":{"tags":["Persons Alerts"],"parameters":[{"name":"follow_list_id","in":"path","required":true,"description":"The ID of the Follow List where a Subscription will be created.","schema":{"$ref":"#/components/schemas/ID"}},{"name":"subscription_id","in":"path","required":true,"description":"The ID of the Subscription that is used to get an Alert. Alert is a matching profile for the given Subscription.","schema":{"$ref":"#/components/schemas/ID"}},{"name":"monitoring_id","in":"path","required":true,"description":"The ID of the Alert that contains matching profile.","schema":{"$ref":"#/components/schemas/ID"}}],"responses":{"200":{"description":"OK","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/FullPersonAlert"},"example":{"data":{"type":"alerts","id":"NQZGEVkxH3oUZAFaFRA=","attributes":{"countries":["us"],"currentStatus":"true-positive","datasets":["RRE","PEP-FORMER"],"datesOfBirth":["1957-06-29"],"gender":"male","match":"Jane Doe","matchVersion":7,"name":"Jane Marie Doe","pepTier":"PEP Tier 1","personID":"NQZGEVkxH3pAYc0KQhqTXV0gFFJ9QAFKUXdZWmENWl1SJ2QhBnlBKWYmElp2QFp5f28EURVGFFxTdgBaCABXGWFTVwFUchY=","profileImage":"https://www.acurisriskintelligence.com/cdn/content/0020615000/0020612599.jpg","score":100,"version":1673422459727},"links":{"self":"https://example.com/follow-lists/01H3T8GTDTYBFDSE99N7QZ9KK8/subscriptions/persons/01H2TC48NQGJ1RXJBQC3GR72QC/alerts/NQZGEVkxH3oUZAFaFRA="}}}}},"headers":{"X-Correlation-Id":{"schema":{"type":"string","format":"uuid","description":"Unique request identifier"}},"X-Ratelimit-Limit":{"schema":{"type":"integer","description":"The number of request available in a rate limit window"}},"X-Ratelimit-Remaining":{"schema":{"type":"integer","description":"The number of requests left for the rate limit window"}},"X-Ratelimit-Reset":{"schema":{"type":"integer","description":"The Unix timestamp at which the current rate limit window resets"}}}},"400":{"$ref":"#/paths/~1follow-lists/get/responses/400"},"401":{"$ref":"#/paths/~1follow-lists/get/responses/401"},"403":{"$ref":"#/paths/~1follow-lists/get/responses/403"},"404":{"$ref":"#/paths/~1follow-lists/get/responses/404"},"500":{"$ref":"#/paths/~1follow-lists/get/responses/500"}}}},"/follow-lists/{follow_list_id}/subscriptions/persons/{subscription_id}/alerts/{monitoring_id}/reviews":{"get":{"tags":["Persons Alerts"],"parameters":[{"name":"follow_list_id","in":"path","required":true,"description":"The ID of the Follow List that the Subscription belongs to.","schema":{"$ref":"#/components/schemas/ID"}},{"name":"subscription_id","in":"path","required":true,"description":"The ID of the Subscription that will be returned.","schema":{"$ref":"#/components/schemas/ID"}},{"name":"monitoring_id","in":"path","required":true,"description":"The ID of the Alert that contains matching profile.","schema":{"$ref":"#/components/schemas/ID"}},{"name":"page","in":"query","style":"deepObject","description":"`size`defines the number of records to return in each page.  default value: 10, maximum value: 20.  <br>`cursor`specifies the next page cursor.","schema":{"$ref":"#/components/schemas/Page"}},{"name":"order","schema":{"type":"string","enum":["asc","desc"]},"in":"query","required":false,"example":"desc","description":"Defines the order of the data returned. Use desc to sort in descending order or asc to sort in ascending order. Defaults to asc if not provided."}],"responses":{"200":{"description":"OK","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/ListOfAlertReviews"},"example":{"data":[{"type":"reviews","attributes":{"dateTimeISO":"2023-06-13T18:09:37.748Z","status":"open"}},{"type":"reviews","attributes":{"riskComment":"very risky","riskRating":"risky","userID":"123","dateTimeISO":"2023-06-19T15:24:02.333Z","status":"true-positive"}}],"links":{"next":"https://example.com/follow-lists/01H2T8GTATYBFDSE99N7QZ9KK8/subscriptions/persons/01H2TC48NQGJ1RXJBQCGGR7TQV/alerts/NQZGEVkxH3oUZAFaFRA=/reviews?page[cursor]=eyJzb3J0S2V5IjoiTUhTVC0xMTI5MdM1lVYwMDAwMDIiLCJwYXJ0aXRpb25LZXkiOiJNVC01NjlfVEVTVC0wMUgyVDhHVEFUWUJGRFNFOTlON1FaOUtLOC0wMUgyVEM0OE5RR0oxUlhKQlFDR0dSN1RRViJ9","self":"https://example.com/follow-lists/01H2T8GTATYBFDSE99N7QZ9KK8/subscriptions/persons/01H2TC48NQGJ1RXJBQCGGR7TQV/alerts/NQZGEVkxH3oUZAFaFRA=/reviews"}}}},"headers":{"X-Correlation-Id":{"schema":{"type":"string","format":"uuid","description":"Unique request identifier"}},"X-Ratelimit-Limit":{"schema":{"type":"integer","description":"The number of request available in a rate limit window"}},"X-Ratelimit-Remaining":{"schema":{"type":"integer","description":"The number of requests left for the rate limit window"}},"X-Ratelimit-Reset":{"schema":{"type":"integer","description":"The Unix timestamp at which the current rate limit window resets"}}}},"400":{"$ref":"#/paths/~1follow-lists/get/responses/400"},"401":{"$ref":"#/paths/~1follow-lists/get/responses/401"},"403":{"$ref":"#/paths/~1follow-lists/get/responses/403"},"404":{"$ref":"#/paths/~1follow-lists/get/responses/404"},"500":{"$ref":"#/paths/~1follow-lists/get/responses/500"}}}},"/follow-lists/{follow_list_id}/subscriptions/persons/{subscription_id}/alerts/reviews":{"put":{"tags":["Persons Alerts"],"parameters":[{"name":"follow_list_id","in":"path","required":true,"description":"The ID of the Follow List that the Subscription belongs to.","schema":{"$ref":"#/components/schemas/ID"}},{"name":"subscription_id","in":"path","required":true,"description":"The ID of the Subscription.","schema":{"$ref":"#/components/schemas/ID"}}],"requestBody":{"description":"Batch reviews payload.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/BatchAlertReviews"}],"example":{"data":[{"type":"reviews","attributes":{"monitoringID":"NQZGEVsxH3oUZAFaFRA=","status":"true-positive","matchVersion":6,"riskRating":"not risky","riskComment":"not a risk for the business","userID":"123"}}]}}}}},"responses":{"200":{"description":"OK","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/BatchResponse"},"example":{"data":[{"type":"reviews","attributes":{"status":"success","review":{"monitoringID":"NQZGEVsxH3oUZAFaFRA=","status":"true-positive","matchVersion":2,"riskRating":"not risky","riskComment":"not a risk for the business","userID":"123"}}},{"type":"reviews","attributes":{"review":{"monitoringID":"NDZGEVsxH3oUZAFsFRA=","status":"false-positive","matchVersion":1,"riskRating":"not risky","riskComment":"not a risk for the business","userID":"123"},"error":{"code":"ERR-01","message":"Resource not found"},"status":"error"}}]}}},"headers":{"X-Correlation-Id":{"schema":{"type":"string","format":"uuid","description":"Unique request identifier"}},"X-Ratelimit-Limit":{"schema":{"type":"integer","description":"The number of request available in a rate limit window"}},"X-Ratelimit-Remaining":{"schema":{"type":"integer","description":"The number of requests left for the rate limit window"}},"X-Ratelimit-Reset":{"schema":{"type":"integer","description":"The Unix timestamp at which the current rate limit window resets"}}}},"400":{"$ref":"#/paths/~1follow-lists/get/responses/400"},"401":{"$ref":"#/paths/~1follow-lists/get/responses/401"},"403":{"$ref":"#/paths/~1follow-lists/get/responses/403"},"404":{"$ref":"#/paths/~1follow-lists/get/responses/404"},"500":{"$ref":"#/paths/~1follow-lists/get/responses/500"}}}},"/follow-lists/{follow_list_id}/subscriptions/persons/{subscription_id}/alerts/auto-reviews":{"put":{"tags":["Persons Alerts"],"parameters":[{"name":"follow_list_id","in":"path","required":true,"description":"The ID of the Follow List that the Subscription belongs to.","schema":{"$ref":"#/components/schemas/ID"}},{"name":"subscription_id","in":"path","required":true,"description":"The ID of the Subscription.","schema":{"$ref":"#/components/schemas/ID"}}],"requestBody":{"description":"Batch reviews payload.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/BatchAlertReviews"}],"example":{"data":[{"type":"reviews","attributes":{"monitoringID":"NQZGEVsxH3oUZAFaFRA=","status":"true-positive","matchVersion":6,"riskRating":"not risky","riskComment":"not a risk for the business","userID":"123"}}]}}}}},"responses":{"200":{"description":"OK","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/BatchResponse"},"example":{"data":[{"type":"reviews","attributes":{"status":"success","review":{"monitoringID":"NQZGEVsxH3oUZAFaFRA=","status":"true-positive","matchVersion":2,"riskRating":"not risky","riskComment":"not a risk for the business","userID":"123"}}},{"type":"reviews","attributes":{"review":{"monitoringID":"NDZGEVsxH3oUZAFsFRA=","status":"false-positive","matchVersion":1,"riskRating":"not risky","riskComment":"not a risk for the business","userID":"123"},"error":{"code":"ERR-01","message":"Resource not found"},"status":"error"}}]}}},"headers":{"X-Correlation-Id":{"schema":{"type":"string","format":"uuid","description":"Unique request identifier"}},"X-Ratelimit-Limit":{"schema":{"type":"integer","description":"The number of request available in a rate limit window"}},"X-Ratelimit-Remaining":{"schema":{"type":"integer","description":"The number of requests left for the rate limit window"}},"X-Ratelimit-Reset":{"schema":{"type":"integer","description":"The Unix timestamp at which the current rate limit window resets"}}}},"400":{"$ref":"#/paths/~1follow-lists/get/responses/400"},"401":{"$ref":"#/paths/~1follow-lists/get/responses/401"},"403":{"$ref":"#/paths/~1follow-lists/get/responses/403"},"404":{"$ref":"#/paths/~1follow-lists/get/responses/404"},"500":{"$ref":"#/paths/~1follow-lists/get/responses/500"}}}},"/follow-lists/{follow_list_id}/subscriptions/businesses":{"get":{"tags":["Business Subscriptions"],"parameters":[{"name":"follow_list_id","in":"path","required":true,"description":"The ID of the Follow List where a Subscription will be created.","schema":{"$ref":"#/components/schemas/ID"}},{"name":"page","in":"query","style":"deepObject","description":"`size`defines the number of records to return in each page.  default value: 10, maximum value: 20.  <br>`cursor`specifies the next page cursor.","schema":{"$ref":"#/components/schemas/Page"}},{"name":"status","schema":{"type":"string","enum":["open","closed"]},"in":"query","required":false,"description":"Filters Subscriptions by status. If not present, all Subscriptions are returned."}],"responses":{"200":{"description":"OK","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/ListOfPersonSubscriptions"},"example":{"data":[{"type":"subscriptions","id":"01H2TC48NQGJ1RXJBQC3GR72QC","attributes":{"countries":["US"],"createdDateTimeISO":"2023-05-10T11:24:12.515Z","discardedCount":0,"falsePositiveCount":0,"lastUpdatedDateTimeISO":"2023-05-10T14:35:48.019Z","name":"BMI Corporation","id":"ABC123","openCount":0,"truePositiveCount":0},"links":{"self":"https://example.com/follow-lists/01H3T8GTDTYBFDSE99N7QZ9KK8/subscriptions/businesses/01H2TC48NQGJ1RXJBQC3GR72QC"}}],"links":{"next":"https://example.com/follow-lists/01H3T8GTDTYBFDSE99N7QZ9KK8/subscriptions/businesses?page[cursor]=eyJnc2kxaGFQ0dHUjdUUVYifQ==&page[size]=1","self":"https://example.com/follow-lists/01H3T8GTDTYBFDSE99N7QZ9KK8/subscriptions/businesses?page[size]=1"},"meta":{"discardedAlertsCount":0,"falsePositiveAlertsCount":0,"openAlertsCount":0,"openSubscriptionsCount":0,"subscriptionsCount":2,"truePositiveAlertsCount":0}}}},"headers":{"X-Correlation-Id":{"schema":{"type":"string","format":"uuid","description":"Unique request identifier"}},"X-Ratelimit-Limit":{"schema":{"type":"integer","description":"The number of request available in a rate limit window"}},"X-Ratelimit-Remaining":{"schema":{"type":"integer","description":"The number of requests left for the rate limit window"}},"X-Ratelimit-Reset":{"schema":{"type":"integer","description":"The Unix timestamp at which the current rate limit window resets"}}}},"400":{"$ref":"#/paths/~1follow-lists/get/responses/400"},"401":{"$ref":"#/paths/~1follow-lists/get/responses/401"},"403":{"$ref":"#/paths/~1follow-lists/get/responses/403"},"404":{"$ref":"#/paths/~1follow-lists/get/responses/404"},"500":{"$ref":"#/paths/~1follow-lists/get/responses/500"}}},"post":{"tags":["Business Subscriptions"],"parameters":[{"name":"follow_list_id","in":"path","required":true,"description":"The ID of the Follow List where a Subscription will be created.","schema":{"$ref":"#/components/schemas/ID"}}],"requestBody":{"description":"Subscription payload.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/NewBusinessSubscription"}],"example":{"data":{"type":"subscriptions","attributes":{"name":"BMI Corporation","countries":["US"]}}}}}}},"responses":{"201":{"description":"Created","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/UpdatedBusinessSubscription"},"example":{"data":{"id":"01ARZ3NDEKTSV4RRFFQ69G5FAV","type":"subscriptions","attributes":{"name":"BMI Corporation","countries":["US"]},"links":{"self":"https://example.com/follow-lists/93CVS1NDEKTSV4RRFFQ69F2FDC/subscriptions/businesses/01ARZ3NDEKTSV4RRFFQ69G5FAV"}}}}},"headers":{"X-Correlation-Id":{"schema":{"type":"string","format":"uuid","description":"Unique request identifier"}},"X-Ratelimit-Limit":{"schema":{"type":"integer","description":"The number of request available in a rate limit window"}},"X-Ratelimit-Remaining":{"schema":{"type":"integer","description":"The number of requests left for the rate limit window"}},"X-Ratelimit-Reset":{"schema":{"type":"integer","description":"The Unix timestamp at which the current rate limit window resets"}}}},"400":{"$ref":"#/paths/~1follow-lists/get/responses/400"},"401":{"$ref":"#/paths/~1follow-lists/get/responses/401"},"403":{"$ref":"#/paths/~1follow-lists/get/responses/403"},"404":{"$ref":"#/paths/~1follow-lists/get/responses/404"},"500":{"$ref":"#/paths/~1follow-lists/get/responses/500"}}}},"/follow-lists/{follow_list_id}/subscriptions/businesses/{subscription_id}":{"get":{"tags":["Business Subscriptions"],"parameters":[{"name":"follow_list_id","in":"path","required":true,"description":"The ID of the Follow List that the Subscription belongs to.","schema":{"$ref":"#/components/schemas/ID"}},{"name":"subscription_id","in":"path","required":true,"description":"The ID of the Subscription that will be returned.","schema":{"$ref":"#/components/schemas/ID"}}],"responses":{"200":{"description":"OK","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/FullBusinessSubscription"},"example":{"data":{"id":"01ARZ3NDEKTSV4RRFFQ69G5FAV","type":"subscriptions","attributes":{"name":"BMI Corporation","countries":["US"],"openCount":1,"id":"ABC123","falsePositiveCount":0,"truePositiveCount":0,"discardedCount":0},"links":{"self":"https://example.com/follow-lists/93CVS1NDEKTSV4RRFFQ69F2FDC/subscriptions/businesses/01ARZ3NDEKTSV4RRFFQ69G5FAV"}}}}},"headers":{"X-Correlation-Id":{"schema":{"type":"string","format":"uuid","description":"Unique request identifier"}},"X-Ratelimit-Limit":{"schema":{"type":"integer","description":"The number of request available in a rate limit window"}},"X-Ratelimit-Remaining":{"schema":{"type":"integer","description":"The number of requests left for the rate limit window"}},"X-Ratelimit-Reset":{"schema":{"type":"integer","description":"The Unix timestamp at which the current rate limit window resets"}}}},"400":{"$ref":"#/paths/~1follow-lists/get/responses/400"},"401":{"$ref":"#/paths/~1follow-lists/get/responses/401"},"403":{"$ref":"#/paths/~1follow-lists/get/responses/403"},"404":{"$ref":"#/paths/~1follow-lists/get/responses/404"},"500":{"$ref":"#/paths/~1follow-lists/get/responses/500"}}},"put":{"tags":["Business Subscriptions"],"parameters":[{"name":"follow_list_id","in":"path","required":true,"description":"The ID of the Follow List that the Subscription belongs to.","schema":{"$ref":"#/components/schemas/ID"}},{"name":"subscription_id","in":"path","required":true,"description":"The ID of the Subscription that will be updated.","schema":{"$ref":"#/components/schemas/ID"}}],"requestBody":{"description":"Subscription payload.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/NewBusinessSubscription"}],"example":{"data":{"type":"subscriptions","attributes":{"name":"BMI Corporation","countries":["US"]}}}}}}},"responses":{"200":{"description":"OK","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/UpdatedBusinessSubscription"},"example":{"data":{"id":"01ARZ3NDEKTSV4RRFFQ69G5FAV","type":"subscriptions","attributes":{"name":"BMI Corporation","countries":["US"]},"links":{"self":"https://example.com/follow-lists/93CVS1NDEKTSV4RRFFQ69F2FDC/subscriptions/businesses/01ARZ3NDEKTSV4RRFFQ69G5FAV"}}}}},"headers":{"X-Correlation-Id":{"schema":{"type":"string","format":"uuid","description":"Unique request identifier"}},"X-Ratelimit-Limit":{"schema":{"type":"integer","description":"The number of request available in a rate limit window"}},"X-Ratelimit-Remaining":{"schema":{"type":"integer","description":"The number of requests left for the rate limit window"}},"X-Ratelimit-Reset":{"schema":{"type":"integer","description":"The Unix timestamp at which the current rate limit window resets"}}}},"400":{"$ref":"#/paths/~1follow-lists/get/responses/400"},"401":{"$ref":"#/paths/~1follow-lists/get/responses/401"},"403":{"$ref":"#/paths/~1follow-lists/get/responses/403"},"404":{"$ref":"#/paths/~1follow-lists/get/responses/404"},"500":{"$ref":"#/paths/~1follow-lists/get/responses/500"}}},"delete":{"tags":["Business Subscriptions"],"parameters":[{"name":"follow_list_id","in":"path","required":true,"description":"The ID of the Follow List that the Subscription belongs to.","schema":{"$ref":"#/components/schemas/ID"}},{"name":"subscription_id","in":"path","required":true,"description":"The ID of the Subscription that will be deleted.","schema":{"$ref":"#/components/schemas/ID"}}],"responses":{"204":{"description":"No Content","headers":{"X-Correlation-Id":{"schema":{"type":"string","format":"uuid","description":"Unique request identifier"}},"X-Ratelimit-Limit":{"schema":{"type":"integer","description":"The number of request available in a rate limit window"}},"X-Ratelimit-Remaining":{"schema":{"type":"integer","description":"The number of requests left for the rate limit window"}},"X-Ratelimit-Reset":{"schema":{"type":"integer","description":"The Unix timestamp at which the current rate limit window resets"}}}},"400":{"$ref":"#/paths/~1follow-lists/get/responses/400"},"401":{"$ref":"#/paths/~1follow-lists/get/responses/401"},"403":{"$ref":"#/paths/~1follow-lists/get/responses/403"},"404":{"$ref":"#/paths/~1follow-lists/get/responses/404"},"500":{"$ref":"#/paths/~1follow-lists/get/responses/500"}}}},"/follow-lists/{follow_list_id}/subscriptions/businesses/{subscription_id}/alerts":{"get":{"tags":["Business Alerts"],"parameters":[{"name":"follow_list_id","in":"path","required":true,"description":"The ID of the Follow List where a Subscription will be created.","schema":{"$ref":"#/components/schemas/ID"}},{"name":"subscription_id","in":"path","required":true,"description":"The ID of the Subscription that is used to get Alerts. All Alerts are the matching profiles for the given Subscription.","schema":{"$ref":"#/components/schemas/ID"}},{"name":"page","in":"query","style":"deepObject","description":"`size`defines the number of records to return in each page.  default value: 10, maximum value: 20.  <br>`cursor`specifies the next page cursor.","schema":{"$ref":"#/components/schemas/Page"}}],"responses":{"200":{"description":"OK","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/ListOfBusinessAlerts"},"example":{"data":[{"type":"reviews","id":"NQZGEVkxH3oUZAFaFRA=","attributes":{"countries":["US"],"currentStatus":"true-positive","datasets":["RRE","POI"],"match":"BMI Corporation","matchVersion":7,"name":"BMI Corporation","businessID":"NQZGEVkxH3pAYV0KQhQTXV0gFFJ9QAFKUXJZWmENWl1SJ2QhBnlBKWYmElp2QFp5f28EURVGFFxTdgBaCABXGWFTVwFUchY=","score":100,"version":1673422459727},"links":{"self":"https://example.com/follow-lists/01H3T8GTDTYBFDSE99N7QZ9KK8/subscriptions/businesses/01H2TC48NQGJ1RXJBQC3GR72QC/alerts/NQZGEVkxH3oUZAFaFRA="}}],"links":{"next":"https://example.com/follow-lists/01H3T8GTDTYBFDSE99N7QZ9KK8/subscriptions/businesses/alerts?page[cursor]=eyJnc2kxaGFQ0dHUjdUUVYifQ==&page[size]=1","self":"https://example.com/follow-lists/01H3T8GTDTYBFDSE99N7QZ9KK8/subscriptions/businesses/alerts?page[size]=1"}}}},"headers":{"X-Correlation-Id":{"schema":{"type":"string","format":"uuid","description":"Unique request identifier"}},"X-Ratelimit-Limit":{"schema":{"type":"integer","description":"The number of request available in a rate limit window"}},"X-Ratelimit-Remaining":{"schema":{"type":"integer","description":"The number of requests left for the rate limit window"}},"X-Ratelimit-Reset":{"schema":{"type":"integer","description":"The Unix timestamp at which the current rate limit window resets"}}}},"400":{"$ref":"#/paths/~1follow-lists/get/responses/400"},"401":{"$ref":"#/paths/~1follow-lists/get/responses/401"},"403":{"$ref":"#/paths/~1follow-lists/get/responses/403"},"404":{"$ref":"#/paths/~1follow-lists/get/responses/404"},"500":{"$ref":"#/paths/~1follow-lists/get/responses/500"}}}},"/follow-lists/{follow_list_id}/subscriptions/businesses/{subscription_id}/alerts/{monitoring_id}":{"get":{"tags":["Business Alerts"],"parameters":[{"name":"follow_list_id","in":"path","required":true,"description":"The ID of the Follow List where a Subscription will be created.","schema":{"$ref":"#/components/schemas/ID"}},{"name":"subscription_id","in":"path","required":true,"description":"The ID of the Subscription that is used to get an Alert. Alert is a matching profile for the given Subscription.","schema":{"$ref":"#/components/schemas/ID"}},{"name":"monitoring_id","in":"path","required":true,"description":"The ID of the Alert that contains matching profile.","schema":{"$ref":"#/components/schemas/ID"}}],"responses":{"200":{"description":"OK","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/FullBusinessAlert"},"example":{"data":{"type":"alerts","id":"NQZGEVkxH3oUZAFaFRA=","attributes":{"countries":["us"],"currentStatus":"true-positive","datasets":["RRE","PEP-FORMER"],"match":"BMI Corporation","matchVersion":7,"name":"BMI Corporation","businessID":"NQZGEVkxH3pAYc0KQhqTXV0gFFJ9QAFKUXdZWmENWl1SJ2QhBnlBKWYmElp2QFp5f28EURVGFFxTdgBaCABXGWFTVwFUchY=","score":100,"version":1673422459727},"links":{"self":"https://example.com/follow-lists/01H3T8GTDTYBFDSE99N7QZ9KK8/subscriptions/businesses/01H2TC48NQGJ1RXJBQC3GR72QC/alerts/NQZGEVkxH3oUZAFaFRA="}}}}},"headers":{"X-Correlation-Id":{"schema":{"type":"string","format":"uuid","description":"Unique request identifier"}},"X-Ratelimit-Limit":{"schema":{"type":"integer","description":"The number of request available in a rate limit window"}},"X-Ratelimit-Remaining":{"schema":{"type":"integer","description":"The number of requests left for the rate limit window"}},"X-Ratelimit-Reset":{"schema":{"type":"integer","description":"The Unix timestamp at which the current rate limit window resets"}}}},"400":{"$ref":"#/paths/~1follow-lists/get/responses/400"},"401":{"$ref":"#/paths/~1follow-lists/get/responses/401"},"403":{"$ref":"#/paths/~1follow-lists/get/responses/403"},"404":{"$ref":"#/paths/~1follow-lists/get/responses/404"},"500":{"$ref":"#/paths/~1follow-lists/get/responses/500"}}}},"/follow-lists/{follow_list_id}/subscriptions/businesses/{subscription_id}/alerts/{monitoring_id}/reviews":{"get":{"tags":["Business Alerts"],"parameters":[{"name":"follow_list_id","in":"path","required":true,"description":"The ID of the Follow List that the Subscription belongs to.","schema":{"$ref":"#/components/schemas/ID"}},{"name":"subscription_id","in":"path","required":true,"description":"The ID of the Subscription that will be returned.","schema":{"$ref":"#/components/schemas/ID"}},{"name":"monitoring_id","in":"path","required":true,"description":"The ID of the Alert that contains matching profile.","schema":{"$ref":"#/components/schemas/ID"}},{"name":"page","in":"query","style":"deepObject","description":"`size`defines the number of records to return in each page.  default value: 10, maximum value: 20.  <br>`cursor`specifies the next page cursor.","schema":{"$ref":"#/components/schemas/Page"}},{"name":"order","schema":{"type":"string","enum":["asc","desc"]},"in":"query","required":false,"example":"desc","description":"Defines the order of the data returned. Use desc to sort in descending order or asc to sort in ascending order. Defaults to asc if not provided."}],"responses":{"200":{"description":"OK","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/ListOfAlertReviews"},"example":{"data":[{"type":"reviews","attributes":{"dateTimeISO":"2023-06-13T18:09:37.748Z","status":"open"}},{"type":"reviews","attributes":{"riskComment":"very risky","riskRating":"risky","userID":"123","dateTimeISO":"2023-06-19T15:24:02.333Z","status":"true-positive"}}],"links":{"next":"https://example.com/follow-lists/01H2T8GTATYBFDSE99N7QZ9KK8/subscriptions/persons/01H2TC48NQGJ1RXJBQCGGR7TQV/alerts/NQZGEVkxH3oUZAFaFRA=/reviews?page[cursor]=eyJzb3J0S2V5IjoiTUhTVC0xMTI5MdM1lVYwMDAwMDIiLCJwYXJ0aXRpb25LZXkiOiJNVC01NjlfVEVTVC0wMUgyVDhHVEFUWUJGRFNFOTlON1FaOUtLOC0wMUgyVEM0OE5RR0oxUlhKQlFDR0dSN1RRViJ9","self":"https://example.com/follow-lists/01H2T8GTATYBFDSE99N7QZ9KK8/subscriptions/persons/01H2TC48NQGJ1RXJBQCGGR7TQV/alerts/NQZGEVkxH3oUZAFaFRA=/reviews"}}}},"headers":{"X-Correlation-Id":{"schema":{"type":"string","format":"uuid","description":"Unique request identifier"}},"X-Ratelimit-Limit":{"schema":{"type":"integer","description":"The number of request available in a rate limit window"}},"X-Ratelimit-Remaining":{"schema":{"type":"integer","description":"The number of requests left for the rate limit window"}},"X-Ratelimit-Reset":{"schema":{"type":"integer","description":"The Unix timestamp at which the current rate limit window resets"}}}},"400":{"$ref":"#/paths/~1follow-lists/get/responses/400"},"401":{"$ref":"#/paths/~1follow-lists/get/responses/401"},"403":{"$ref":"#/paths/~1follow-lists/get/responses/403"},"404":{"$ref":"#/paths/~1follow-lists/get/responses/404"},"500":{"$ref":"#/paths/~1follow-lists/get/responses/500"}}}},"/follow-lists/{follow_list_id}/subscriptions/businesses/{subscription_id}/alerts/reviews":{"put":{"tags":["Business Alerts"],"parameters":[{"name":"follow_list_id","in":"path","required":true,"description":"The ID of the Follow List that the Subscription belongs to.","schema":{"$ref":"#/components/schemas/ID"}},{"name":"subscription_id","in":"path","required":true,"description":"The ID of the Subscription.","schema":{"$ref":"#/components/schemas/ID"}}],"requestBody":{"description":"Batch reviews payload.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/BatchAlertReviews"}],"example":{"data":[{"type":"reviews","attributes":{"monitoringID":"NQZGEVkxH3oUZAFaFRA=","status":"true-positive","matchVersion":6,"riskRating":"not risky","riskComment":"not a risk for the business","userID":"123"}}]}}}}},"responses":{"200":{"description":"OK","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/BatchResponse"},"example":{"data":[{"type":"reviews","attributes":{"status":"success","review":{"monitoringID":"NQZGEVsxH3oUZAFaFRA=","status":"true-positive","matchVersion":2,"riskRating":"not risky","riskComment":"not a risk for the business","userID":"123"}}},{"type":"reviews","attributes":{"review":{"monitoringID":"NDZGEVsxH3oUZAFsFRA=","status":"false-positive","matchVersion":1,"riskRating":"not risky","riskComment":"not a risk for the business","userID":"123"},"error":{"code":"ERR-01","message":"Resource not found"},"status":"error"}}]}}},"headers":{"X-Correlation-Id":{"schema":{"type":"string","format":"uuid","description":"Unique request identifier"}},"X-Ratelimit-Limit":{"schema":{"type":"integer","description":"The number of request available in a rate limit window"}},"X-Ratelimit-Remaining":{"schema":{"type":"integer","description":"The number of requests left for the rate limit window"}},"X-Ratelimit-Reset":{"schema":{"type":"integer","description":"The Unix timestamp at which the current rate limit window resets"}}}},"400":{"$ref":"#/paths/~1follow-lists/get/responses/400"},"401":{"$ref":"#/paths/~1follow-lists/get/responses/401"},"403":{"$ref":"#/paths/~1follow-lists/get/responses/403"},"404":{"$ref":"#/paths/~1follow-lists/get/responses/404"},"500":{"$ref":"#/paths/~1follow-lists/get/responses/500"}}}},"/follow-lists/{follow_list_id}/subscriptions/businesses/{subscription_id}/alerts/auto-reviews":{"put":{"tags":["Business Alerts"],"parameters":[{"name":"follow_list_id","in":"path","required":true,"description":"The ID of the Follow List that the Subscription belongs to.","schema":{"$ref":"#/components/schemas/ID"}},{"name":"subscription_id","in":"path","required":true,"description":"The ID of the Subscription.","schema":{"$ref":"#/components/schemas/ID"}}],"requestBody":{"description":"Batch reviews payload.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/BatchAlertReviews"}],"example":{"data":[{"type":"reviews","attributes":{"monitoringID":"NQZGEVsxH3oUZAFaFRA=","status":"true-positive","matchVersion":6,"riskRating":"not risky","riskComment":"not a risk for the business","userID":"123"}}]}}}}},"responses":{"200":{"description":"OK","content":{"application/vnd.api+json":{"schema":{"$ref":"#/components/schemas/BatchResponse"},"example":{"data":[{"type":"reviews","attributes":{"status":"success","review":{"monitoringID":"NQZGEVsxH3oUZAFaFRA=","status":"true-positive","matchVersion":2,"riskRating":"not risky","riskComment":"not a risk for the business","userID":"123"}}},{"type":"reviews","attributes":{"review":{"monitoringID":"NDZGEVsxH3oUZAFsFRA=","status":"false-positive","matchVersion":1,"riskRating":"not risky","riskComment":"not a risk for the business","userID":"123"},"error":{"code":"ERR-01","message":"Resource not found"},"status":"error"}}]}}},"headers":{"X-Correlation-Id":{"schema":{"type":"string","format":"uuid","description":"Unique request identifier"}},"X-Ratelimit-Limit":{"schema":{"type":"integer","description":"The number of request available in a rate limit window"}},"X-Ratelimit-Remaining":{"schema":{"type":"integer","description":"The number of requests left for the rate limit window"}},"X-Ratelimit-Reset":{"schema":{"type":"integer","description":"The Unix timestamp at which the current rate limit window resets"}}}},"400":{"$ref":"#/paths/~1follow-lists/get/responses/400"},"401":{"$ref":"#/paths/~1follow-lists/get/responses/401"},"403":{"$ref":"#/paths/~1follow-lists/get/responses/403"},"404":{"$ref":"#/paths/~1follow-lists/get/responses/404"},"500":{"$ref":"#/paths/~1follow-lists/get/responses/500"}}}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-KEY"}},"schemas":{"FullFollowList":{"title":"Follow List","description":"All the information about a Follow List. Follow List is a collection of Subscriptions","type":"object","properties":{"data":{"$ref":"#/components/schemas/FullFollowListObject"}}},"ListOfFollowList":{"title":"List of Follow Lists","description":"Paginated response with list of Follow Lists","type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/FollowListObject"}},"links":{"type":"object","properties":{"next":{"title":"JSON:API Link","description":"A JSON:API link can be either a URL string or a structured link object.","oneOf":[{"type":"string","format":"url","example":"https://example.com/"},{"title":"JSON:API Link Object","description":"a structured representation of a URL","type":"object","required":["href"],"properties":{"href":{"type":"string","example":"/organizations/<cin>"},"meta":{"type":"object","example":{"count":"10"}}}}]},"self":{"$ref":"#/components/schemas/ListOfFollowList/properties/links/properties/next"}}}}},"FullFollowListObject":{"title":"Follow List object","description":"a Follow List object structure including statistics","type":"object","required":["dateOfBirthMatching","dateOfBirthRequired","countryRequired","matching","pepTiers"],"properties":{"id":{"$ref":"#/components/schemas/ID"},"type":{"type":"string","example":"follow-lists"},"attributes":{"allOf":[{"$ref":"#/components/schemas/BaseFollowList"},{"$ref":"#/components/schemas/FollowListStatistics"}]},"links":{"type":"object","properties":{"self":{"$ref":"#/components/schemas/ListOfFollowList/properties/links/properties/next"}}}}},"FollowList":{"title":"Follow List","description":"All the information about a Follow List. Follow List is a collection of Subscriptions","type":"object","properties":{"data":{"$ref":"#/components/schemas/FollowListObject"}}},"FollowListObject":{"title":"Follow List object","description":"a Follow List object structure","type":"object","required":["dateOfBirthMatching","dateOfBirthRequired","countryRequired","matching","pepTiers"],"properties":{"id":{"$ref":"#/components/schemas/ID"},"type":{"type":"string","example":"follow-lists"},"attributes":{"allOf":[{"$ref":"#/components/schemas/BaseFollowList"}]},"links":{"type":"object","properties":{"self":{"$ref":"#/components/schemas/ListOfFollowList/properties/links/properties/next"}}}}},"NewFollowList":{"title":"New Follow List","description":"a new Follow List object structure","type":"object","required":["dateOfBirthMatching","dateOfBirthRequired","countryRequired","matching","pepTiers"],"properties":{"data":{"type":"object","properties":{"type":{"type":"string","example":"follow-lists"},"attributes":{"$ref":"#/components/schemas/BaseFollowList"}}}}},"FollowListStatistics":{"type":"object","required":["businessSubscriptionsCount","personSubscriptionsCount","personOpenSubscriptionsCount","personOpenAlertsCount","personFalsePositiveAlertsCount","personTruePositiveAlertsCount","personDiscardedAlertsCount","businessOpenSubscriptionsCount","businessOpenAlertsCount","businessFalsePositiveAlertsCount","businessTruePositiveAlertsCount","businessDiscardedAlertsCount"],"properties":{"lastScreenedDateISO":{"type":"string","example":"2022-06-11T00:00:00.000Z","description":"Date of the last completed screening."},"businessSubscriptionsCount":{"type":"integer","example":5,"description":"The number of business Subscriptions in the given Follow List."},"personSubscriptionsCount":{"type":"integer","example":5,"description":"The number of person Subscriptions in the given Follow List."},"personOpenSubscriptionsCount":{"type":"integer","example":5,"description":"The number of open person Subscriptions in the given Follow List."},"personOpenAlertsCount":{"type":"integer","example":5,"description":"The number of open person Alerts in the given Follow List."},"personFalsePositiveAlertsCount":{"type":"integer","example":5,"description":"The number of false-positive person Alerts in the given Follow List."},"personTruePositiveAlertsCount":{"type":"integer","example":5,"description":"The number of true-positive person Alerts in the given Follow List."},"personDiscardedAlertsCount":{"type":"integer","example":5,"description":"The number of discarded person Alerts in the given Follow List."},"businessOpenSubscriptionsCount":{"type":"integer","example":5,"description":"The number of open business Subscriptions in the given Follow List."},"businessOpenAlertsCount":{"type":"integer","example":5,"description":"The number of open business Subscriptions in the given Follow List."},"businessFalsePositiveAlertsCount":{"type":"integer","example":5,"description":"The number of false-positive business Alerts in the given Follow List."},"businessTruePositiveAlertsCount":{"type":"integer","example":5,"description":"The number of true-positive business Alerts in the given Follow List."},"businessDiscardedAlertsCount":{"type":"integer","example":5,"description":"The number of discarded business Alerts in the given Follow List."}}},"BaseFollowList":{"type":"object","required":["name","threshold","frequency","datasets"],"properties":{"name":{"type":"string","maxLength":100,"minLength":1,"example":"Follow List - 1","description":"A name of the Follow List."},"threshold":{"type":"integer","minimum":75,"maximum":100,"example":85,"description":"Alerts with matching profiles with scores below this value will not be shown."},"frequency":{"type":"string","enum":["daily","weekly","monthly","halfAYear","annual"],"example":"daily","description":"The frequency with which all Subscriptions in the Follow List will be screened."},"datasets":{"type":"array","minItems":1,"description":"Specifies which datasets will be searched\n * PEP - Politically Exposed Persons (All)\n * PEP-CURRENT - Only current PEPs\n * PEP-FORMER - Only former PEPs\n * PEP-LINKED - Only linked PEPs (PEP by Association)\n * SAN - Sanctioned (All)\n * SAN-CURRENT - Only current Sanctions\n * SAN-FORMER - Only former Sanctions\n * INS - Insolvency\n * RRE - Reputational Risk Exposure\n * DD - Disqualified Director\n * POI - Profile Of Interest\n * REL - Regulatory Enforcement List\n * SOE - State Owned Enterprise\n * SOE-CURRENT - Only current SOEs\n * SOE-FORMER - Only former SOEs","example":["PEP"],"items":{"type":"string","enum":["PEP","PEP-CURRENT","PEP-FORMER","PEP-LINKED","SAN","SAN-CURRENT","SAN-FORMER","INS","RRE","DD","POI","REL","SOE","SOE-CURRENT","SOE-FORMER"]}},"scheduleDayOfTheWeek":{"type":"string","enum":["monday","tuesday","wednesday","thursday","friday","saturday","sunday"],"example":"friday","description":"Specifies a day of the week on which screening should be done.\nIt is required and allowed only when the frequency is set to weekly."},"scheduleDayOfTheMonth":{"type":"integer","minimum":1,"maximum":31,"example":31,"description":"Specifies a day of the month on which screening should be done.\nIt is required and allowed only when the frequency is set to monthly, halfAYear or annual."},"scheduleMonth":{"type":"string","enum":["january","february","march","april","may","june","july","august","september","october","november","december"],"example":"january","description":"Specifies a month on which screening should be done.\nIt is required and allowed only when the frequency is set to halfAYear or annual."},"dateOfBirthMatching":{"type":"string","enum":["exact","sameYear","withinOneYear","withinTwoYears","withinThreeYears","withinFourYears","withinFiveYears"],"default":"sameYear","example":"withinThreeYears","description":"Determines the accuracy of the date of birth matching\n * exact - The date of birth must be a perfect match to produce a hit.\n * sameYear - The date of birth just needs to be in the same calendar year to produce a hit.\n * withinOneYear - The date of birth must be within 1 year of the date specified in order to produce a hit.\n * withinTwoYears - The date of birth must be within 2 years of the date specified in order to produce a hit.\n * withinThreeYears - The date of birth must be within 3 years of the date specified in order to produce a hit.\n * withinFourYears - The date of birth must be within 4 years of the date specified in order to produce a hit.\n * withinFiveYears - The date of birth must be within 5 years of the date specified in order to produce a hit.\n"},"dateOfBirthRequired":{"type":"boolean","default":false,"example":false,"description":"Tells if profiles with unknown dates of birth should be filtered out of the screening results for Subscriptions with a specified date of birth.\n\nIf set to false (default value), and dateOfBirth is specified, profiles with no date of birth will appear in the results with a small penalty applied due to the lack of dateOfBirth match.\n\nIf set to true, and dateOfBirth is specified, profiles with no date of birth will NOT appear in the results.\n\nIf the dateOfBirth is not specified in the Subscription, the attribute is ignored (profiles with no date of birth will appear in the screening results with no penalty)."},"countryRequired":{"type":"boolean","default":false,"example":false,"description":"Tells if profiles with unknown country and no nationality should be filtered out of the Alerts for a Subscription with a specified country.\n\nIf set to false (default value), and country is specified, profiles with no country and no nationality will appear in the results with a small penalty applied due to the lack of a country match.\n\nIf set to true, and country is specified, profiles with no country and no nationality will NOT appear in the results.\n\nIf the country is not specified in the Subscription, the attribute is ignored (profiles with no country and no nationality will appear in screening results with no penalty)."},"matching":{"type":"string","enum":["fuzzy","strict"],"default":"fuzzy","example":"fuzzy","description":"Defines what name matching algorithm is used for profile screening.\n\nThe Fuzzy algorithm is the default and applies all of our fuzzy matching techniques to ensure the most accurate results.\n\nThe Strict algorithm uses some fuzzy matching, but is more restrictive in its approach and may miss some alerts (matching profiles) if the exact name is not known. \n\nWe strongly recommend using the Fuzzy algorithm for the best results and only using the Strict algorithm to reduce the number of Alerts to the bare minimum, when the exact name is known."},"pepTiers":{"type":"array","minItems":0,"items":{"type":"string","enum":["PEP Tier 1","PEP Tier 2","PEP Tier 3"]},"example":["PEP Tier 1"],"description":"When screening the PEP dataset, define what tiers of the PEP profiles should be included in the results. Where PEP Tier 1 indicates senior roles, PEP Tier 2 - middle-ranking, and PEP Tier 3 - junior officials. If the PEP Dataset is NOT included on the list of datasets to screen, then this value is ignored. The PEP Tier filter does not apply to PEP-LINKED Profiles."}}},"FullPersonSubscription":{"title":"Person Subscription","description":"All the information about a Person Subscription. Person Subscription is a record in a Follow List with search criteria for a profile that you want to monitor.","type":"object","properties":{"data":{"$ref":"#/components/schemas/FullPersonSubscriptionObject"}}},"UpdatedPersonSubscription":{"title":"Person Subscription","description":"The information about a Person Subscription without statistics like number of Alerts, etc. Person Subscription is a record in a Follow List with search criteria for a profile that you want to monitor.","type":"object","properties":{"data":{"type":"object","properties":{"id":{"$ref":"#/components/schemas/ID"},"type":{"type":"string","example":"follow-lists"},"attributes":{"$ref":"#/components/schemas/BasePersonSubscription"},"links":{"type":"object","properties":{"self":{"$ref":"#/components/schemas/ListOfFollowList/properties/links/properties/next"}}}}}}},"ListOfPersonSubscriptions":{"title":"List of Person Subscriptions","description":"Paginated response with list of Person Subscriptions","type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/FullPersonSubscriptionObject"}},"links":{"type":"object","properties":{"next":{"$ref":"#/components/schemas/ListOfFollowList/properties/links/properties/next"},"self":{"$ref":"#/components/schemas/ListOfFollowList/properties/links/properties/next"}}},"meta":{"$ref":"#/components/schemas/SubscriptionStatistics"}}},"FullPersonSubscriptionObject":{"title":"Person Subscription object","description":"a Person Subscription object structure","type":"object","properties":{"id":{"$ref":"#/components/schemas/ID"},"type":{"type":"string","example":"subscriptions"},"attributes":{"allOf":[{"$ref":"#/components/schemas/BaseSubscription"},{"$ref":"#/components/schemas/BasePersonSubscription"}]},"links":{"type":"object","properties":{"self":{"$ref":"#/components/schemas/ListOfFollowList/properties/links/properties/next"}}}}},"NewPersonSubscription":{"title":"New Person Subscription object","description":"a new Person Subscription object structure","type":"object","properties":{"data":{"type":"object","properties":{"type":{"type":"string","example":"subscriptions"},"attributes":{"$ref":"#/components/schemas/BasePersonSubscription"}}}}},"SubscriptionStatistics":{"type":"object","required":["subscriptionsCount","openSubscriptionsCount","openAlertsCount","falsePositiveAlertsCount","truePositiveAlertsCount","discardedAlertsCount"],"properties":{"subscriptionsCount":{"type":"integer","example":5,"description":"The number of subscriptions in the given Follow List."},"openSubscriptionsCount":{"type":"integer","example":1,"description":"The number of open subscriptions in the given Follow List."},"openAlertsCount":{"type":"integer","example":3,"description":"The number of open Alerts (matching profiles) in all subscriptions in the given Follow List."},"falsePositiveAlertsCount":{"type":"integer","example":3,"description":"The number of false-positive Alerts (matching profiles) in all subscriptions in the given Follow List."},"truePositiveAlertsCount":{"type":"integer","example":1,"description":"The number of true-positive Alerts (matching profiles) in all subscriptions in the given Follow List."},"discardedAlertsCount":{"type":"integer","example":1,"description":"The number of discarded Alerts (matching profiles) in all subscriptions in the given Follow List."}}},"BasePersonSubscription":{"type":"object","required":["name","countries"],"properties":{"name":{"description":"The full name of the person you want to monitor.","minLength":1,"maxLength":200,"type":"string","example":"Jane Doe"},"countries":{"type":"array","example":["US"],"minItems":0,"items":{"type":"string"},"description":"The list of countries from the addresses and nationalities of the profile."},"dateOfBirth":{"type":"string","example":"1991-07-22","description":"Date in either YYYY-MM-DD or YYYY ISO format."},"gender":{"description":"The gender of the person.","type":"string","example":"female","enum":["male","female"]}}},"ListOfPersonAlerts":{"title":"List of Person Alerts","description":"Paginated response with list of Person Alerts. Every Alert contains a matching profile and a reference to full profile in Compliance Screening API.","type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/FullPersonAlertObject"}},"links":{"type":"object","properties":{"next":{"$ref":"#/components/schemas/ListOfFollowList/properties/links/properties/next"},"self":{"$ref":"#/components/schemas/ListOfFollowList/properties/links/properties/next"}}}}},"FullPersonAlert":{"title":"Person Subscription","description":"All the information about a Person Alert. Person Alert is a record with a profile that matches search criteria in the Subscription. Contains an ID that can be used to fetch full profile in Compliance Screening API.","type":"object","properties":{"data":{"$ref":"#/components/schemas/FullPersonAlertObject"}}},"FullPersonAlertObject":{"title":"Person Alert object","description":"a Person Alert object structure","type":"object","properties":{"id":{"$ref":"#/components/schemas/ID"},"type":{"type":"string","example":"alerts"},"attributes":{"$ref":"#/components/schemas/BasePersonAlert"},"links":{"type":"object","properties":{"self":{"$ref":"#/components/schemas/ListOfFollowList/properties/links/properties/next"}}}}},"BasePersonAlert":{"type":"object","required":["currentStatus","datasets","datesOfBirth","version","personID","score","match","name","countries","matchVersion"],"properties":{"currentStatus":{"$ref":"#/components/schemas/MatchStatus"},"version":{"type":"integer","example":15346444345,"description":"The version number can be used to detect when a profile has changed."},"personID":{"type":"string","description":"The profile Id can be used to retrieve the full profile of the person in the Compliance Screening API.","example":"NQZGEVkxH3pAYV0KQhQTXV0gFFJ9QAFKUXJZWmENWl1SJ2QhBnlBKWYmElp2QFp5f28EURVGFFxTdgBaCABXGWFTVwFUchY="},"score":{"minimum":50,"maximum":100,"type":"integer","example":99,"description":"The match score of the profile."},"match":{"type":"string","example":"Jane Doe","description":"The name on the profile that has been matched in the search."},"name":{"type":"string","example":"Jane Marie Doe","description":"The primary name on the profile."},"countries":{"minItems":0,"type":"array","example":["US"],"items":{"type":"string"},"description":"The list of countries from the addresses and nationalities of the profile."},"datesOfBirth":{"minItems":0,"type":"array","example":["1994","1994-08-22"],"items":{"type":"string","description":"Date in either YYYY-MM-DD or YYYY ISO format."}},"gender":{"description":"The gender of the person, if known.","type":"string","example":"male","enum":["male","female"]},"profileImage":{"type":"string","description":"The primary profile image."},"datasets":{"allOf":[{"$ref":"#/components/schemas/PersonProfileDatasetsSchema"}]},"matchVersion":{"type":"number","example":1,"description":"This value can be used for version control.\nPass this value when setting a new alert status.\nIf the provided matchVersion does not match actual value on the server it means the alert has been modified in the meantime and operation will fail."},"pepTier":{"type":"string","enum":["PEP Tier 1","PEP Tier 2","PEP Tier 3"],"example":"PEP Tier 1","description":"Defines the PEP tier of the matched person. Where PEP Tier 1 indicates senior roles, PEP Tier 2 - middle-ranking, and PEP Tier 3 - junior officials."}}},"MatchStatus":{"type":"string","example":"true-positive","description":"The status of the match\n  * open - Indicates that the alert requires review.\n  * true-positive - Indicates that the alert is closed and that the profile was matched correctly.\n  * false-positive - Indicates that the alert is closed and that the profile was matched incorrectly.\n * discarded - Indicates that the profile in the alert no longer matches the subscription due to the changes in the profile, subscription, or the follow list.\n","enum":["open","true-positive","false-positive","discarded"]},"PersonProfileDatasetsSchema":{"type":"array","minItems":1,"description":"The profile datasets\n * PEP-CURRENT - Only current PEPs\n * PEP-FORMER - Only former PEPs\n * PEP-LINKED - Only linked PEPs (PEP by Association)\n * SAN-CURRENT - Only current Sanctions\n * SAN-FORMER - Only former Sanctions\n * INS - Insolvency\n * RRE - Reputational Risk Exposure\n * DD - Disqualified Director\n * POI - Profile Of Interest\n * REL - Regulatory Enforcement List\n * GRI - Gambling Risk Intelligence.\n","example":["DD","INS","PEP-CURRENT","PEP-FORMER","PEP-LINKED","POI","REL","RRE","SAN-CURRENT","SAN-FORMER","GRI"],"items":{"type":"string","enum":["PEP-CURRENT","PEP-FORMER","PEP-LINKED","SAN-CURRENT","SAN-FORMER","INS","RRE","DD","POI","REL","GRI"]}},"BusinessProfileDatasetsSchema":{"type":"array","minItems":1,"description":"The profile datasets\n * PEP-LINKED - Only linked PEPs (PEP by Association)\n * SAN-CURRENT - Only current Sanctions\n * SAN-FORMER - Only former Sanctions\n * INS - Insolvency\n * RRE - Reputational Risk Exposure\n * POI - Profile Of Interest\n * REL - Regulatory Enforcement List\n * SOE-CURRENT - Only current SOE\n * SOE-FORMER - Only former SOE\n * GRI - Gambling Risk Intelligence.\n","example":["INS","PEP-LINKED","POI","REL","RRE","SAN-CURRENT","SAN-FORMER","GRI"],"items":{"type":"string","enum":["PEP-LINKED","SAN-CURRENT","SAN-FORMER","INS","RRE","POI","REL","SOE-CURRENT","SOE-FORMER","GRI"]}},"ListOfAlertReviews":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","example":"reviews"},"attributes":{"type":"object","required":["dateTimeISO"],"allOf":[{"$ref":"#/components/schemas/AlertReview"}],"properties":{"dateTimeISO":{"type":"string","example":"2010-10-10T10:10:10.100Z","description":"The dateTime that the match review was created."}}}}}},"links":{"type":"object","properties":{"next":{"$ref":"#/components/schemas/ListOfFollowList/properties/links/properties/next"},"self":{"$ref":"#/components/schemas/ListOfFollowList/properties/links/properties/next"}}}}},"AlertReview":{"type":"object","properties":{"status":{"allOf":[{"$ref":"#/components/schemas/MatchStatus"}]},"matchVersion":{"type":"number","example":1,"description":"This value can be used for version control.\nPass this value to the PUT endpoints when setting a new alert status.\nIf the provided matchVersion does not match actual value on the server it means the match has been modified in the meantime and operation will fail.\nFor auto-reviews the matchVersion should exactly match the version of the profile that you already reviewed in the Screening API."},"riskRating":{"type":"string","example":"High-Risk","maxLength":40,"description":"This is a user defined optional field that allows to set a custom risk label."},"riskComment":{"type":"string","maxLength":1024,"description":"User defined optional comment added during the review.","example":"Reviewed as true positive, no risk to the business."},"userID":{"type":"string","maxLength":100,"description":"User defined optional user ID of the person/system that performed the operation.","example":"reviewer123"}}},"BatchAlertReviews":{"type":"object","properties":{"data":{"type":"array","minItems":1,"maxItems":1000,"items":{"type":"object","properties":{"type":{"type":"string","example":"reviews"},"attributes":{"allOf":[{"type":"object","required":["monitoringID"],"properties":{"monitoringID":{"type":"string","example":"NQZGEVsxH3oUZAFaFRA=","description":"The ID of the Alert for which review should be added."}}},{"$ref":"#/components/schemas/AlertReview"}]}}}}},"example":{"data":[{"type":"reviews","attributes":{"monitoringID":"NQZGEVsxH3oUZAFaWRx=","status":"true-positive","riskRating":"High-Risk","riskComment":"no risk to the business.","userID":"reviewer123"}},{"type":"reviews","attributes":{"monitoringID":"ZFZGEVsxH3oUZAgaFRd=","status":"false-positive"}},{"type":"reviews","attributes":{"monitoringID":"WDZGEVsxH3oUZAcaLRA=","riskComment":"Pending review."}}]}},"BatchResponse":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","example":"reviews"},"attributes":{"type":"object","required":["review","status"],"properties":{"review":{"allOf":[{"type":"object","required":["monitoringID"],"properties":{"monitoringID":{"type":"string","example":"NQZGEVsxH3oUZAFaFRA=","description":"The ID of the Alert that was reviewed."}}},{"$ref":"#/components/schemas/AlertReview"}]},"status":{"type":"string","description":"result status for a single record.","example":"success","enum":["success","error"]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Identifier of the error.","example":"ERR-001"},"message":{"type":"string","description":"Human readable error description.","example":"Resource not found"}}}}}}}}}},"FullBusinessSubscription":{"title":"Business Subscription","description":"All the information about a business subscription. Business subscription is a record in a Follow List with search criteria for a profile that you want to monitor.","type":"object","properties":{"data":{"$ref":"#/components/schemas/FullBusinessSubscriptionObject"}}},"UpdatedBusinessSubscription":{"title":"Business Subscription","description":"The information about a Business Subscription without statistics like number of Alerts, etc. Business Subscription is a record in a Follow List with search criteria for a profile that you want to monitor.","type":"object","properties":{"data":{"type":"object","properties":{"id":{"$ref":"#/components/schemas/ID"},"type":{"type":"string","example":"follow-lists"},"attributes":{"$ref":"#/components/schemas/BaseBusinessSubscription"},"links":{"type":"object","properties":{"self":{"$ref":"#/components/schemas/ListOfFollowList/properties/links/properties/next"}}}}}}},"ListOfBusinessSubscriptions":{"title":"List of Business Subscriptions","description":"Paginated response with list of Business Subscriptions","type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/FullBusinessSubscriptionObject"}},"links":{"type":"object","properties":{"next":{"$ref":"#/components/schemas/ListOfFollowList/properties/links/properties/next"},"self":{"$ref":"#/components/schemas/ListOfFollowList/properties/links/properties/next"}}},"meta":{"$ref":"#/components/schemas/SubscriptionStatistics"}}},"FullBusinessSubscriptionObject":{"title":"Business Subscription object","description":"a Business Subscription object structure","type":"object","properties":{"id":{"$ref":"#/components/schemas/ID"},"type":{"type":"string","example":"subscriptions"},"attributes":{"allOf":[{"$ref":"#/components/schemas/BaseSubscription"},{"$ref":"#/components/schemas/BaseBusinessSubscription"}]},"links":{"type":"object","properties":{"self":{"$ref":"#/components/schemas/ListOfFollowList/properties/links/properties/next"}}}}},"NewBusinessSubscription":{"title":"New Business Subscription object","description":"a new Business Subscription object structure","type":"object","properties":{"data":{"type":"object","properties":{"type":{"type":"string","example":"subscriptions"},"attributes":{"$ref":"#/components/schemas/BaseBusinessSubscription"}}}}},"BaseBusinessSubscription":{"type":"object","required":["name","countries"],"properties":{"name":{"description":"The full name of the business you want to monitor.","minLength":1,"maxLength":200,"type":"string","example":"BMI Corporation"},"countries":{"type":"array","example":["US"],"minItems":0,"items":{"type":"string"},"description":"The list of countries from the addresses and nationalities of the profile."}}},"ListOfBusinessAlerts":{"title":"List of Business Alerts","description":"Paginated response with list of Business Alerts. Every Alert contains a matching profile and a reference to full profile in Compliance Screening API.","type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/FullBusinessAlertObject"}},"links":{"type":"object","properties":{"next":{"$ref":"#/components/schemas/ListOfFollowList/properties/links/properties/next"},"self":{"$ref":"#/components/schemas/ListOfFollowList/properties/links/properties/next"}}}}},"FullBusinessAlert":{"title":"Business Subscription","description":"All the information about a Business Alert. Business Alert is a record with a profile that matches search criteria in the Subscription. Contains an ID that can be used to fetch full profile in Compliance Screening API.","type":"object","properties":{"data":{"$ref":"#/components/schemas/FullBusinessAlertObject"}}},"FullBusinessAlertObject":{"title":"Business Alert object","description":"a Business Alert object structure","type":"object","properties":{"id":{"$ref":"#/components/schemas/ID"},"type":{"type":"string","example":"alerts"},"attributes":{"$ref":"#/components/schemas/BaseBusinessAlert"},"links":{"type":"object","properties":{"self":{"$ref":"#/components/schemas/ListOfFollowList/properties/links/properties/next"}}}}},"BaseBusinessAlert":{"type":"object","required":["currentStatus","datasets","version","businessID","score","match","name","countries","matchVersion"],"properties":{"currentStatus":{"$ref":"#/components/schemas/MatchStatus"},"version":{"type":"integer","example":15346444345,"description":"The version number can be used to detect when a profile has changed."},"businessID":{"type":"string","description":"The profile Id can be used to retrieve the full profile of the business in the Compliance Screening API.","example":"NQZGEVkxH3pAYV0KQhQTXV0gFFJ9QAFKUXJZWmENWl1SJ2QhBnlBKWYmElp2QFp5f28EURVGFFxTdgBaCABXGWFTVwFUchY="},"score":{"minimum":50,"maximum":100,"type":"integer","example":99,"description":"The match score of the profile."},"match":{"type":"string","example":"Jane Doe","description":"The name on the profile that has been matched in the search."},"name":{"type":"string","example":"BMI Corporation","description":"The primary name on the profile."},"countries":{"minItems":0,"type":"array","example":["US"],"items":{"type":"string"},"description":"The list of countries from the addresses and nationalities of the profile."},"datasets":{"allOf":[{"$ref":"#/components/schemas/BusinessProfileDatasetsSchema"}]},"matchVersion":{"type":"number","example":1,"description":"This value can be used for version control.\nPass this value when setting a new alert status.\nIf the provided matchVersion does not match actual value on the server it means the alert has been modified in the meantime and operation will fail."}}},"Page":{"type":"object","properties":{"size":{"type":"integer","default":10,"description":"The number of records to return in each page."},"cursor":{"type":"string","example":"CEcTEwIRUV9RDw==","description":"Leaving this blank will return the first page. Otherwise you can provide the cursor from a previous request to iterate to the next page."}}},"ID":{"title":"ID of a resource.","type":"string"},"BaseSubscription":{"type":"object","required":["openCount","falsePositiveCount","truePositiveCount","discardedCount","createdDateTimeISO","lastUpdatedDateTimeISO"],"properties":{"openCount":{"type":"integer","example":1,"description":"The number of open Alerts for the Subscription."},"falsePositiveCount":{"type":"integer","example":0,"description":"The number of Alerts already closed as false positive."},"truePositiveCount":{"type":"integer","example":0,"description":"The number of Alerts already closed as true positive."},"discardedCount":{"type":"integer","example":0,"description":"The number of Alerts already discarded."},"createdDateTimeISO":{"type":"string","example":"2021-10-05T10:10:08.270Z","description":"The timestamp that the record was first created."},"lastUpdatedDateTimeISO":{"type":"string","example":"2021-10-05T10:10:08.270Z","description":"The last time the record was updated by the user."}}}}}}