Sikoia PEPs & Sanctions API
The PEPs & Sanctions API from Sikoia — 2 operation(s) for peps & sanctions.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/sikoia-peps-sanctions-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
OpenAPI Specification
openapi: 3.2.0
info:
title: Sikoia Adverse Media PEPs & Sanctions API
termsOfService: https://sikoia.com/About/Terms
version: '1.0'
servers:
- url: https://api.sikoia.com
description: API (Production)
- url: https://oauth2.sikoia.com
description: Authorization Server (Production)
- url: https://api-staging.sikoia.com
description: API (Staging)
- url: https://oauth2-staging.sikoia.com
description: Authorization Server (Staging)
security:
- authorizationHeader: []
- apiKeyHeader: []
tags:
- name: PEPs & Sanctions
paths:
/v2/peps-sanctions:
post:
tags:
- PEPs & Sanctions
summary: Request PEPs & Sanctions search
description: '### Requests a PEPs & Sanctions search for an entity.
Check if the entity is listed in any Politically Exposed Persons (PEPs) or Sanctions lists.
* If the `entity_type` is case, a `search_term` must be included.
* If the `entity_type` is person or company, the search term is taken from the name on the entity. If the `search_term` is included, the entity data is overridden.
* If `entity_type` is person, providing a `birth_date` enhances search accuracy.
* Adjust the `fuzziness` level (ranging from 0-1) to control spelling variations. Lower levels yield fewer variations, while higher levels increase flexibility.
This endpoint returns the number of matches the entity has. For detailed match information, refer to the Sikoia Dashboard.
'
operationId: POST_v2-peps-sanctions
requestBody:
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/SikoiaSharedModels.BusinessSupport.ComplyAdvantage.AntiMoneyLaunderingRequest'
example:
search_term: Acme Inc
entity_type: company
entity_id: 78662640-73fc-4fa9-8367-ef4660d35cee
birth_date: string
monitored: 'true'
fuzziness: '0.2'
responses:
'201':
description: PEPs & Sanctions Search
content:
application/json:
schema:
$ref: '#/components/schemas/SikoiaSharedModels.BusinessSupport.ComplyAdvantage.AntiMoneyLaunderingResponse'
example:
request_id: e6b1b4d6-d5cf-426e-a4dc-d9c0264299df
search_ref: 1729289992-b91nmEFh
status: Complete
entity_type: company
entity_id: 78662640-73fc-4fa9-8367-ef4660d35cee
search_term: Acme Inc
birthdate: '1950-08-08'
monitored: 'true'
datetime_requested: '2024-02-12T16:02:06.9000000+00:00'
total_matches: '9'
search_certificate_uri: https://sikoialake.blob.core.windows.net/sikoia/complyadvantagecertificate/01929b28-c39d-739e-beb8-6ceda5136d24.pdf?sv=2021-08-06&se=2024-10-17T15%3A56%3A33Z&sr=b&sp=r&sig=4E4X3hxHkpVvCS2pJvBVxGM6MvHcgpdZryC%2BpJmNRHE%3D
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/SikoiaCore.Common.SikoiaErrorResponse'
example:
type: InvalidToken
status: 401
title: Invalid Token
detail: Invalid token
correlation_id: a83b5de5-68f0-4e96-a254-8a8a1392ed8b
'404':
description: Details Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/SikoiaCore.Common.SikoiaErrorResponse'
example:
type: ResourceNotFound
status: 404
title: Resource Not Found
detail: No resources found with id 2cd278b5-eb0d-4813-82ee-1755bfbaaa26.
correlation_id: f574a91c-1ee3-47bb-afaf-0cbdd957d666
'429':
description: Too Many Requests
content:
application/json:
schema:
$ref: '#/components/schemas/SikoiaCore.Common.SikoiaErrorResponse'
example:
type: RateLimit
status: 429
title: Too Many Requests
detail: You've exceeded the maximum API request limit per minute. Please try again later.
correlation_id: 6c1018af-58c0-4bd5-a8b3-723237c8cf05
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/SikoiaCore.Common.SikoiaErrorResponse'
example:
type: ServerError
status: 500
title: Internal Server Error
detail: Something has gone wrong, please try again
correlation_id: 5c1b6b40-2c45-4bfd-9384-d487cdab5f16
/v2/{entity_type}/{entity_id}/peps-sanctions:
get:
tags:
- PEPs & Sanctions
summary: List all PEPs & Sanctions searches
description: '### Returns a list of all PEPs & Sanctions searches for an entity.
The response returns the number of matches returned in each search.
For detailed match information, refer to the Sikoia Dashboard.
'
operationId: GET_v2-entity_type-entity_id-peps-sanctions
parameters:
- name: entity_type
in: path
description: The type of entity (company, person, case)
required: true
schema:
enum:
- Companies
- Persons
- Cases
type: string
- name: entity_id
in: path
description: The company_id, person_id or case_id of the entity
required: true
schema:
type: string
responses:
'200':
description: Adverse Media Retrieved
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/SikoiaSharedModels.BusinessSupport.ComplyAdvantage.AntiMoneyLaunderingResponse'
example:
- request_id: e6b1b4d6-d5cf-426e-a4dc-d9c0264299df
search_ref: 1729289992-b91nmEFh
status: Complete
entity_type: company
entity_id: 78662640-73fc-4fa9-8367-ef4660d35cee
search_term: Acme Inc
birthdate: '1950-08-08'
monitored: 'true'
datetime_requested: '2024-02-12T16:02:06.9000000+00:00'
total_matches: '9'
search_certificate_uri: https://sikoialake.blob.core.windows.net/sikoia/complyadvantagecertificate/01929b28-c39d-739e-beb8-6ceda5136d24.pdf?sv=2021-08-06&se=2024-10-17T15%3A56%3A33Z&sr=b&sp=r&sig=4E4X3hxHkpVvCS2pJvBVxGM6MvHcgpdZryC%2BpJmNRHE%3D
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/SikoiaCore.Common.SikoiaErrorResponse'
example:
type: InvalidToken
status: 401
title: Invalid Token
detail: Invalid token
correlation_id: 584f3e31-8319-4ca8-8fed-659a59e34cee
'404':
description: Entity Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/SikoiaCore.Common.SikoiaErrorResponse'
example:
type: ResourceNotFound
status: 404
title: Resource Not Found
detail: No resources found with id 06ed4634-9775-4c59-8fbf-326f1729ce2d.
correlation_id: 5089355a-3b89-490f-8143-8efedce5c609
'429':
description: Too Many Requests
content:
application/json:
schema:
$ref: '#/components/schemas/SikoiaCore.Common.SikoiaErrorResponse'
example:
type: RateLimit
status: 429
title: Too Many Requests
detail: You've exceeded the maximum API request limit per minute. Please try again later.
correlation_id: ca604701-282d-42a1-a684-fb4cfb6a8f70
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/SikoiaCore.Common.SikoiaErrorResponse'
example:
type: ServerError
status: 500
title: Internal Server Error
detail: Something has gone wrong, please try again
correlation_id: a00d2b49-2fc3-43f8-9e42-d1fddb76a52b
components:
schemas:
SikoiaSharedModels.BusinessSupport.ComplyAdvantage.AntiMoneyLaunderingResponse:
title: Anti Money Laundering Response
type: object
properties:
request_id:
type:
- string
- 'null'
description: Sikoia ID for the request
example: e6b1b4d6-d5cf-426e-a4dc-d9c0264299df
search_ref:
type:
- string
- 'null'
description: Data provider’s search ID
example: 1729289992-b91nmEFh
status:
type:
- string
- 'null'
description: The status of the request(`Complete` `Failed`)
example: Complete
entity_type:
enum:
- company
- person
- case
type:
- string
- 'null'
description: The type of entity
example: company
entity_id:
type:
- string
- 'null'
description: The `company_id`, `person_id` or `case_id` of the entity
example: 78662640-73fc-4fa9-8367-ef4660d35cee
search_term:
type:
- string
- 'null'
description: The name of the entity
example: Acme Inc
birthdate:
type:
- string
- 'null'
description: The date of birth of the person
example: '1950-08-08'
monitored:
type: boolean
description: Indicates if search should be automatically updated when new data is found. Set to `true` by default
example: 'true'
datetime_requested:
type:
- string
- 'null'
description: The time the request was made
example: '2024-02-12T16:02:06.9Z'
total_matches:
type: integer
description: The total number of potential matches found
format: int32
example: '9'
search_certificate_uri:
type:
- string
- 'null'
description: The URI of the Search Certificate
example: https://sikoialake.blob.core.windows.net/sikoia/complyadvantagecertificate/01929b28-c39d-739e-beb8-6ceda5136d24.pdf?sv=2021-08-06&se=2024-10-17T15%3A56%3A33Z&sr=b&sp=r&sig=4E4X3hxHkpVvCS2pJvBVxGM6MvHcgpdZryC%2BpJmNRHE%3D
additionalProperties: false
SikoiaCore.Common.SikoiaErrorResponse:
title: Error Response
type: object
properties:
type:
type: string
description: The error type
readOnly: true
status:
type: integer
description: HTTP status code of the error
format: HttpCode
readOnly: true
title:
type: string
description: A short description of the error
readOnly: true
detail:
type: string
description: More details about what went wrong
readOnly: true
correlation_id:
type: string
description: Correlation ID, please include this in any support tickets raised
readOnly: true
additionalProperties: false
description: 'See the [Response Guide](https://docs.sikoia.com/docs/api-behaviour#responses) for more detail '
SikoiaSharedModels.BusinessSupport.ComplyAdvantage.AntiMoneyLaunderingRequest:
title: Anti Money Laundering Request
required:
- entity_id
- entity_type
type: object
properties:
search_term:
type:
- string
- 'null'
description: The name of the entity
example: Acme Inc
entity_type:
minLength: 1
enum:
- company
- person
- case
type: string
description: The type of entity
example: company
entity_id:
minLength: 1
type: string
description: The `company_id`, `person_id` or `case_id` of the entity
example: 78662640-73fc-4fa9-8367-ef4660d35cee
birth_date:
type:
- string
- 'null'
description: The date of birth of the person
format: date-time
monitored:
type: boolean
description: Indicates if search should be automatically updated when new data is found.Set to `true` by default
example: 'true'
fuzziness:
type:
- number
- 'null'
description: Float to control for spelling variations
format: float
example: '0.2'
additionalProperties: false
securitySchemes:
authorizationHeader:
type: http
scheme: bearer
bearerFormat: JWT
apiKeyHeader:
type: apiKey
name: apikey
in: header