openapi: 3.0.0 info: description: Interpol Red, Yellow and UN Notices API version: 1.0.2 title: Interpol Notices API servers: - url: https://ws-public.interpol.int tags: - name: Notices paths: /notices/v1/red: get: summary: Get Red Notices responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/RedNotices' parameters: - in: query required: false name: forename schema: type: string description: First name example: MAX - in: query required: false name: name schema: type: string description: Last name example: Mustermann - in: query required: false name: nationality schema: type: string description: Two digit country code example: DE - in: query required: false name: ageMax schema: type: integer description: maximum age example: 120 - in: query required: false name: ageMin schema: type: integer description: minimum age example: 18 - in: query required: false name: freeText schema: type: string description: Free text query example: '' - in: query required: false name: sexId schema: type: string enum: - '' - F - M - U description: Free text query example: F - in: query required: false name: arrestWarrantCountryId schema: type: string description: Two digit country code example: DE - in: query required: false name: page schema: type: integer description: pagination - starts with 1 example: 1 - in: query required: false name: resultPerPage schema: type: integer description: resultPerPage example: 200 tags: - Notices /notices/v1/red/{noticeID}: get: summary: Get Red Notice Details responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/RedNoticeDetail' parameters: - in: path required: true name: noticeID schema: type: string description: Notice ID example: 1993-27493 tags: - Notices /notices/v1/red/{noticeID}/images: get: summary: Get Red Notice Images responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/RedNoticeDetailImages' parameters: - in: path required: true name: noticeID schema: type: string description: Notice ID example: 1993-27493 tags: - Notices /notices/v1/yellow: get: summary: Get Yellow Notices responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/YellowNotices' parameters: - in: query required: false name: forename schema: type: string description: First name example: MAX - in: query required: false name: name schema: type: string description: Last name example: Mustermann - in: query required: false name: nationality schema: type: string description: Two digit country code example: DE - in: query required: false name: ageMax schema: type: integer description: maximum age example: 120 - in: query required: false name: ageMin schema: type: integer description: minimum age example: 18 - in: query required: false name: freeText schema: type: string description: Free text query example: '' - in: query required: false name: sexId schema: type: string enum: - '' - F - M - U description: Free text query example: F - in: query required: false name: page schema: type: integer description: pagination - starts with 1 example: 1 - in: query required: false name: resultPerPage schema: type: integer description: resultPerPage example: 200 tags: - Notices /notices/v1/yellow/{noticeID}: get: summary: Get Yellow Notice Details responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/YellowNoticeDetail' parameters: - in: path required: true name: noticeID schema: type: string description: Notice ID example: 2014-5590 tags: - Notices /notices/v1/yellow/{noticeID}/images: get: summary: Get Yellow Notice Images responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/YellowNoticeDetailImages' parameters: - in: path required: true name: noticeID schema: type: string description: Notice ID example: 2014-5590 tags: - Notices /notices/v1/un: get: summary: Get UN Notices responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/UNNotices' parameters: - in: query required: false name: name schema: type: string description: Last name example: Mustermann - in: query required: false name: unReference schema: type: string description: UN-Referenz - in: query required: false name: unResolution schema: type: integer description: UN-Resolution example: 1267 - in: query required: false name: page schema: type: integer description: pagination - starts with 1 example: 1 - in: query required: false name: resultPerPage schema: type: integer description: resultPerPage example: 200 tags: - Notices /notices/v1/un/{noticeType}/{noticeID}: get: summary: Get UN Notice Details responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/YellowNoticeDetail' parameters: - in: path required: true name: noticeID schema: type: string description: Notice ID example: 2014-5590 - in: path required: true name: noticeType schema: type: string description: Notice Type (either 'persons' or 'entities') example: persons tags: - Notices /notices/v1/un/{noticeType}/{noticeID}/images: get: summary: Get UN Notice Images responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/UNNoticeDetailImages' parameters: - in: path required: true name: noticeID schema: type: string description: Notice ID example: 2014-5590 - in: path required: true name: noticeType schema: type: string description: Notice Type (either 'persons' or 'entities') example: persons tags: - Notices components: schemas: YellowNoticeDetailImages: type: object properties: _embedded: type: object properties: images: type: array items: type: object properties: picture_id: type: string example: '59410257' _links: type: object properties: self: type: object properties: href: type: string example: https://ws-public.interpol.int/notices/v1/yellow/2014-5590/images/59410257 _links: type: object properties: self: type: object properties: href: type: string example: https://ws-public.interpol.int/notices/v1/yellow/2014-5590/images notice: type: object properties: href: type: string example: https://ws-public.interpol.int/notices/v1/yellow/2014-5590 thumbnail: type: object properties: href: type: string example: https://ws-public.interpol.int/notices/v1/yellow/2014-5590/images/59410257 YellowNoticeDetail: type: object properties: weight: type: integer format: int32 example: 63 birth_name: type: string entity_id: type: string example: 2022/9888 nationalities: type: array items: type: string example: DE height: type: number example: 1.65 name: type: string example: MAX eyes_colors_id: type: array items: type: string example: BRO place: type: string example: KARLSRUHE date_of_event: type: string example: 2021/02/01 hairs_id: type: array items: type: string example: BLA father_forename: type: string example: MAX mother_forename: type: string example: PAULA forename: type: string example: MAX date_of_birth: type: string example: 1958/11/05 languages_spoken_ids: type: array items: type: string example: GER country: type: string example: DE country_of_birth_id: type: string example: DE sex_id: type: string example: F distinguishing_marks: type: string example: Birthmarks in the face mother_name: type: string example: MUSTERMANN place_of_birth: type: string example: KARLSRUHE _embedded: type: object properties: links: type: array items: type: string _links: type: object properties: self: type: object properties: href: type: string example: https://ws-public.interpol.int/notices/v1/yellow/2022-9888 images: type: object properties: href: type: string example: https://ws-public.interpol.int/notices/v1/yellow/2022-9888/images thumbnail: type: object properties: href: type: string example: https://ws-public.interpol.int/notices/v1/yellow/2022-9888/images/59558401 RedNoticeDetailImages: type: object properties: _embedded: type: object properties: images: type: array items: type: object properties: picture_id: type: string example: '52558228' _links: type: object properties: self: type: object properties: href: type: string example: https://ws-public.interpol.int/notices/v1/red/1993-27493/images/52558228 _links: type: object properties: self: type: object properties: href: type: string example: https://ws-public.interpol.int/notices/v1/red/1993-27493/images notice: type: object properties: href: type: string example: https://ws-public.interpol.int/notices/v1/red/1993-27493 thumbnail: type: object properties: href: type: string example: https://ws-public.interpol.int/notices/v1/red/1993-27493/images/59558401 RedNoticeDetail: type: object properties: arrest_warrants: type: array items: type: object properties: issuing_country_id: type: string example: DE charge: type: string example: Attempted murder coinciding with attempted jointly committed aggravated robbery and kidnapping for ransom coinciding with aggravated robbery and aggravated robbery coinciding with attempted aggravated extortionate assault especially aggravated robbery aggravated robbery in penal cumulation with attempted arson and aggravated robbery charge_translation: type: string format: nullable weight: type: integer format: int32 example: 63 forename: type: string example: DANIELA MARIE LUISE date_of_birth: type: string example: 1958/11/05 entity_id: type: string example: 1993/27493 languages_spoken_ids: type: array items: type: string example: GER nationalities: type: array items: type: string example: DE height: type: number example: 1.65 sex_id: type: string example: F country_of_birth_id: type: string example: DE name: type: string example: KLETTE distinguishing_marks: type: string example: Birthmarks in the face eyes_colors_id: type: array items: type: string example: BRO hairs_id: type: array items: type: string example: BLA place_of_birth: type: string example: KARLSRUHE _embedded: type: object properties: links: type: array items: type: string _links: type: object properties: self: type: object properties: href: type: string example: https://ws-public.interpol.int/notices/v1/red/1993-27493 images: type: object properties: href: type: string example: https://ws-public.interpol.int/notices/v1/red/1993-27493/images thumbnail: type: object properties: href: type: string example: https://ws-public.interpol.int/notices/v1/red/1993-27493/images/59558401 UNNotices: type: object properties: total: type: integer format: int32 example: 0 query: type: object properties: page: type: integer format: int32 example: 1 resultPerPage: type: integer format: int32 example: 160 _embedded: type: object properties: notices: type: array items: type: string _links: type: object properties: self: type: object properties: href: type: string example: https://ws-public.interpol.int/notices/v1/un?nationality=DE&resultPerPage=160&page=1 first: type: object properties: href: type: string example: https://ws-public.interpol.int/notices/v1/un?nationality=DE&resultPerPage=160&page=1 next: type: object properties: href: type: string example: https://ws-public.interpol.int/notices/v1/un?nationality=DE&resultPerPage=160&page=2 last: type: object properties: href: type: string example: https://ws-public.interpol.int/notices/v1/un?nationality=DE&resultPerPage=160&page=8 RedNotices: type: object properties: total: type: integer format: int32 example: 0 query: type: object properties: page: type: integer format: int32 example: 1 resultPerPage: type: integer format: int32 example: 160 _embedded: type: object properties: notices: type: array items: type: string _links: type: object properties: self: type: object properties: href: type: string example: https://ws-public.interpol.int/notices/v1/red?nationality=DE&resultPerPage=160&page=1 first: type: object properties: href: type: string example: https://ws-public.interpol.int/notices/v1/red?nationality=DE&resultPerPage=160&page=1 next: type: object properties: href: type: string example: https://ws-public.interpol.int/notices/v1/red?nationality=DE&resultPerPage=160&page=2 last: type: object properties: href: type: string example: https://ws-public.interpol.int/notices/v1/red?nationality=DE&resultPerPage=160&page=8 YellowNotices: type: object properties: total: type: integer format: int32 example: 0 query: type: object properties: page: type: integer format: int32 example: 1 resultPerPage: type: integer format: int32 example: 160 _embedded: type: object properties: notices: type: array items: type: string _links: type: object properties: self: type: object properties: href: type: string example: https://ws-public.interpol.int/notices/v1/yellow?nationality=DE&resultPerPage=160&page=1 first: type: object properties: href: type: string example: https://ws-public.interpol.int/notices/v1/yellow?nationality=DE&resultPerPage=160&page=1 next: type: object properties: href: type: string example: https://ws-public.interpol.int/notices/v1/yellow?nationality=DE&resultPerPage=160&page=2 last: type: object properties: href: type: string example: https://ws-public.interpol.int/notices/v1/yellow?nationality=DE&resultPerPage=160&page=8 UNNoticeDetailImages: type: object properties: _embedded: type: object properties: images: type: array items: type: object properties: picture_id: type: string example: '62323740' _links: type: object properties: self: type: object properties: href: type: string example: https://ws-public.interpol.int/notices/v1/un/2021-82522/images/62323740 _links: type: object properties: self: type: object properties: href: type: string example: https://ws-public.interpol.int/notices/v1/un/persons/2021-82522/images notice: type: object properties: href: type: string example: https://ws-public.interpol.int/notices/v1/un/persons/2021-82522 thumbnail: type: object properties: href: type: string example: https://ws-public.interpol.int/notices/v1/un/persons/2021-82522/images/62323740