Skip to main content

Global Watchlist

GET /global-watchlist/search

Global Watchlist search

Search entities in the Global Watchlist list by name, date of birth and aliases

Parameters

NameInTypeRequiredDescription
imagequerystringfalseBase64-encoded image for facial recognition (uploaded images are not stored)
namequerystringtrueFull name or alias
dobquerystringfalseDate of birth (YYYY-MM-DD)
yobquerystringfalseYear of birth (YYYY)
country_codequerystringfalseCountry code (e.g. US)
sourcesquerystringfalseComma-separated list of sources to search (default: all)
source_country_codequerystringfalseLimit results to specific watchlists from a country (e.g. US)
fromquerynumberfalsePagination start (default: 0)
x-api-keyheaderstringtrueAPI Authentication Key

Example responses

Lookup results object

{
"dob": [
"1961-04-25"
],
"yob": [
1961
],
"full_name": "maria soledad iparraguirre guenechea",
"first_name": "maria",
"last_name": "iparraguirre guenechea",
"middle_name": "soledad",
"description": "Member ETA.",
"aliases": [
"maria soledad iparraguirre guenechea"
]
}

500 Response

{
"error": "string"
}

Responses

StatusMeaningDescriptionSchema
200OKLookup results objectLookupWatchlistResponse
500Internal Server ErrorAn error messageErrorResponse

Code samples

"""
Python Code Snippet
"""
import requests

headers = {
'Accept': 'application/json',
'x-api-key': 'string'
}

params = {
'name': 'string'
}

r = requests.get('https://data.autohost.ai/v1/global-watchlist/search', headers=headers, params=params)

print(r.json())

/*
TypeScript Code Snippet
*/

import fetch from 'node-fetch';

const headers = {
'Accept':'application/json',
'x-api-key':'string'
};

const response = await fetch('https://data.autohost.ai/v1/global-watchlist/search', {
method: 'get',

headers,
});
const responseJson = await response.json();
console.log(responseJson);

global-watchlist-sources

GET /global-watchlist/sources

Global Watchlist sources

Retrieve a list of sources available in the Global Watchlist

Parameters

NameInTypeRequiredDescription
x-api-keyheaderstringtrueAPI Authentication Key

Example responses

Lookup results object

{
"sources": [
"OFAC",
"INTERPOL",
"UN-NOTICE-RED",
"..."
]
}

500 Response

{
"error": "string"
}

Responses

StatusMeaningDescriptionSchema
200OKLookup results objectLookupWatchlistSourcesResponse
500Internal Server ErrorAn error messageErrorResponse

Code samples

"""
Python Code Snippet
"""
import requests

headers = {
'Accept': 'application/json',
'x-api-key': 'string'
}

r = requests.get('https://data.autohost.ai/v1/global-watchlist/sources', headers=headers)

print(r.json())

/*
TypeScript Code Snippet
*/

import fetch from 'node-fetch';

const headers = {
'Accept':'application/json',
'x-api-key':'string'
};

const response = await fetch('https://data.autohost.ai/v1/global-watchlist/sources', {
method: 'get',

headers,
});
const responseJson = await response.json();
console.log(responseJson);