Die API erlaubt den Zugriff auf Interpols Red Notices, Yellow Notices sowie United Nations Security Council Special Notices (UN Notices).
Interpol zufolge ist eine Red Notice eine Aufforderung an die Strafverfolgungsbehörden weltweit, eine Person bis zu Auslieferung, Übergabe oder ähnlichen rechtlichen Schritten ausfindig zu machen und vorläufig festzunehmen (cf. https://www.interpol.int/How-we-work/Notices/Red-Notices). Eine Red Notice enthält zwei Haupttypen von Informationen:
- Informationen zur Identifizierung der gesuchten Person, wie Name, Geburtsdatum, Nationalität, Haar- und Augenfarbe, Fotos und Fingerabdrücke, sofern verfügbar;
- Informationen im Zusammenhang mit dem Verbrechen, für das sie gesucht werden, was typischerweise Mord, Vergewaltigung, Kindesmissbrauch oder bewaffneter Raub sein kann.
Eine Yellow Notice ist demgegenüber ein globaler Hinweis auf eine vermisste Person. Es wird für Opfer von elterlichen Entführungen, kriminellen Entführungen (Kidnappings) oder ungeklärtem Verschwinden ausgestellt (cf. https://www.interpol.int/en/How-we-work/Notices/Yellow-Notices).
Eine UN Notice warnt die Polizei weltweit vor Einzelpersonen und Organisationen, die Sanktionen des Sicherheitsrats der Vereinten Nationen unterliegen (cf. https://www.interpol.int/How-we-work/Notices/INTERPOL-United-Nations-Security-Council-Special-Notices).
URL: https://ws-public.interpol.int/notices/v1/red
Die API ermöglicht, verfügbare Red Notices über folgende Parameter eines GET-requests zu filtern:
Parameter: forename (Optional)
Vorname (z.B. MAX).
Parameter: name (Optional)
Nachname (z.B. Mustermann).
Parameter: nationality (Optional)
Nationalität (z.B. DE).
Parameter: ageMax (Optional)
Maximalalter (z.B. 120).
Parameter: ageMin (Optional)
Minimalalter (z.B. 18).
Parameter: freeText (Optional)
Freitextanfrage.
Parameter: sexId (Optional)
Geschlechterkürzel (z.B. "F","M","U","").
Parameter: arrestWarrantCountryId (Optional)
Land des Haftbefehlursprungs (z.B. DE).
Parameter: page (Optional)
Seite (z.B. 1).
Parameter: resultPerPage (Optional)
Ergebnisse pro Seite (z.B. 200)
URL: https://ws-public.interpol.int/notices/v1/red/{noticeID}
Die API ermöglicht, Details zu einzelnen Red Notices über den Pfad-Parameter noticeID (z.B. 1993-27493) eines GET-requests anzufragen.
URL: https://ws-public.interpol.int/notices/v1/red/{noticeID}/images
Die API ermöglicht, Images zu einzelnen Red Notices über den Pfad-Parameter noticeID (z.B. 1993-27493) eines GET-requests anzufragen.
URL: https://ws-public.interpol.int/notices/v1/yellow
Die API ermöglicht, verfügbare Yellow Notices über folgende Parameter eines GET-requests zu filtern:
Parameter: forename (Optional)
Vorname (z.B. MAX).
Parameter: name (Optional)
Nachname (z.B. Mustermann).
Parameter: nationality (Optional)
Nationalität (z.B. DE).
Parameter: ageMax (Optional)
Maximalalter (z.B. 120).
Parameter: ageMin (Optional)
Minimalalter (z.B. 18).
Parameter: freeText (Optional)
Freitextanfrage.
Parameter: sexId (Optional)
Geschlechterkürzel (z.B. "F","M","U","").
Parameter: page (Optional)
Seite (z.B. 1).
Parameter: resultPerPage (Optional)
Ergebnisse pro Seite (z.B. 200)
URL: https://ws-public.interpol.int/notices/v1/yellow/{noticeID}
Die API ermöglicht, Details zu einzelnen Yellow Notices über den Pfad-Parameter noticeID (z.B. 2014-5590) eines GET-requests anzufragen.
URL: https://ws-public.interpol.int/notices/v1/yellow/{noticeID}/images
Die API ermöglicht, Images zu einzelnen Yellow Notices über den Pfad-Parameter noticeID (z.B. 2014-5590) eines GET-requests anzufragen.
URL: https://ws-public.interpol.int/notices/v1/un
Die API ermöglicht, verfügbare UN Notices über folgende Parameter eines GET-requests zu filtern:
Parameter: name (Optional)
Nachname (z.B. Mustermann).
Parameter: unReference (Optional)
UN-Referenz (Freitext).
Parameter: unResolution (Optional)
UN-Resolution (z.B. 1267).
Parameter: page (Optional)
Seite (z.B. 1).
Parameter: resultPerPage (Optional)
Ergebnisse pro Seite (z.B. 200)
URL: https://ws-public.interpol.int/notices/v1/un/{noticeType}/{noticeID}
Die API ermöglicht, Details zu einzelnen UN Notices über die Pfad-Parameter noticeType (entweder "persons" oder "entities") und noticeID (z.B. 2021-84506) eines GET-requests anzufragen.
URL: https://ws-public.interpol.int/notices/v1/un/{noticeType}/{noticeID}/images
Die API ermöglicht, Images zu einzelnen UN Notices über die Pfad-Parameter noticeType (entweder "persons" oder "entities") und noticeID (z.B. 2021-84506) eines GET-requests anzufragen.
redNotices=$(curl -m 60 'https://ws-public.interpol.int/notices/v1/red?nationality=DE')
redNoticeDetails=$(curl -m 60 'https://ws-public.interpol.int/notices/v1/red/1993-27493')
redNoticeImages=$(curl -m 60 'https://ws-public.interpol.int/notices/v1/red/1993-27493/images')
yellowNotices=$(curl -m 60 'https://ws-public.interpol.int/notices/v1/yellow?nationality=DE')
yellowNoticeDetails=$(curl -m 60 'https://ws-public.interpol.int/notices/v1/yellow/2014-5590')
yellowNoticeImages=$(curl -m 60 'https://ws-public.interpol.int/notices/v1/yellow/2014-5590/images')
UNNotices=$(curl -m 60 'https://ws-public.interpol.int/notices/v1/yellow?nationality=DE')
UNNoticeDetails=$(curl -m 60 'https://ws-public.interpol.int/notices/v1/un/persons/2021-84506')
UNNoticeImages=$(curl -m 60 'https://ws-public.interpol.int/notices/v1/un/persons/2021-84506/images')