> ## Documentation Index
> Fetch the complete documentation index at: https://docs.taidalos.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Media Search Execution



## OpenAPI

````yaml GET /v1/media-searches/execution/{media_search_execution_id}
openapi: 3.0.0
info:
  title: Taidalos API Documentation
  termsOfService: https://www.taidalos.com/gtc/
  contact:
    name: Customer Support
    url: https://www.taidalos.com
    email: cs@taidalos.com
  version: '1.0'
servers:
  - url: https://api.taidalos.com
security: []
tags:
  - description: Operations about subjects
    name: Subjects
  - description: Operations about media search configuration
    name: Media Search Configuration
  - description: Operations about media search
    name: Media Search
externalDocs:
  description: Get started with guides
  url: https://taidalos.com/tags/guide/
paths:
  /v1/media-searches/execution/{media_search_execution_id}:
    get:
      tags:
        - Media Search
      summary: Media Search Execution
      parameters:
        - description: media_search_execution_id
          name: media_search_execution_id
          in: path
          required: true
          schema:
            type: string
        - description: 'Remove Markdown (options: true, false, default: false)'
          name: remove_markdown
          in: query
          schema:
            type: string
        - description: <Authorization Token>
          name: Authorization
          in: header
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/main.getSearchExecutionResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/main.problemJson'
components:
  schemas:
    main.getSearchExecutionResponse:
      type: object
      properties:
        data:
          description: >-
            `data` represents the main content of the search execution response,
            encapsulating details about the media search execution.
          allOf:
            - $ref: '#/components/schemas/main.getSearchExecutionResponseItem'
    main.problemJson:
      type: object
      properties:
        context:
          description: >-
            `context` provides additional information about the error, including
            the HTTP method and path where it occurred.
          allOf:
            - $ref: '#/components/schemas/main.defaultProblemContext'
        details:
          description: >-
            `details` provides a detailed human-readable explanation of the
            specific error.
          type: string
          example: Details explaining the error
        instance:
          description: >-
            `instance` specifies a unique URI identifying the context of the
            error, such as organisation, user, and request details.
          type: string
          example: /org/{org_id}/user/{user_id}/request-id/{request_id}
        title:
          description: >-
            `title` provides a short, human-readable summary of the problem type
            or error encountered.
          type: string
          example: Error ShortName
        type:
          description: >-
            `type` is a URI reference that identifies the problem type, allowing
            clients to recognize the type of error encountered.
          type: string
          example: https://errors.taidalos.com/common/{error-type}
    main.getSearchExecutionResponseItem:
      type: object
      properties:
        created_at:
          description: >-
            `created_at` represents the timestamp indicating when the resource
            was created.
          type: string
        created_by:
          description: >-
            `created_by` represents the user who initiated or authored the
            entity, identified by their unique UserId.
          type: object
          properties:
            user_id:
              description: >-
                `user_id` represents the unique identifier of the user who
                created the associated entity.
              type: string
        media_article_aggregates:
          description: >-
            `media_article_aggregates` represents a collection of media article
            aggregates associated with a media search execution.
          type: array
          items:
            $ref: '#/components/schemas/main.mediaArticleAggregate'
        media_search_config:
          description: >-
            `media_search_config` represents the configuration details for a
            media search execution.
          type: object
          properties:
            media_search_configuration_id:
              description: >-
                `media_search_configuration_id` is the unique identifier of the
                media search configuration.
              type: string
            media_search_configuration_version:
              description: >-
                `media_search_configuration_version` specifies the version of
                the media search configuration.
              type: integer
        media_search_execution_id:
          description: >-
            `media_search_execution_id` is the unique identifier for a media
            search execution.
          type: string
        media_search_id:
          description: >-
            `media_search_id` represents the unique identifier for a specific
            media search associated with this execution.
          type: string
        organisation_id:
          description: >-
            `organisation_id` represents the unique identifier for the
            organisation associated with the media search execution.
          type: string
        status:
          description: >-
            `status` represents the current state of the media search execution.
            Possible values: INITIATED, PENDING, PROCESSING, DONE, ERROR.
          type: string
          enum:
            - INITIATED
            - PENDING
            - PROCESSING
            - DONE
            - ERROR
        subject:
          description: >-
            `subject` represents the entity containing a unique identifier for a
            subject involved in a media search execution.
          type: object
          properties:
            subject_id:
              description: >-
                `subject_id` represents the unique identifier of the subject
                associated with the media search execution.
              type: string
        updated_at:
          description: >-
            `updated_at` represents the timestamp when the record was last
            modified.
          type: string
    main.defaultProblemContext:
      type: object
      required:
        - method
        - path
      properties:
        method:
          description: >-
            `method` specifies the HTTP method (e.g., GET, POST) that was used
            in the problematic request.
          type: string
          example: '{method}'
        path:
          description: >-
            `path` specifies the HTTP request path associated with the
            encountered problem.
          type: string
          example: '{path}'
        timestamp:
          type: string
    main.mediaArticleAggregate:
      type: object
      properties:
        dispositions:
          description: >-
            `dispositions` represents a collection of disposition records
            related to a media article in the aggregate.
          type: array
          items:
            $ref: '#/components/schemas/main.disposition'
        media_article:
          description: >-
            `media_article` represents a media article associated with a media
            search execution and its related metadata.
          allOf:
            - $ref: '#/components/schemas/main.mediaArticle'
    main.disposition:
      type: object
      required:
        - risk
      properties:
        created_at:
          description: '`created_at` represents the timestamp when the record was created.'
          type: string
          example: '2024-10-22T07:37:56.676Z'
        created_by:
          description: >-
            `created_by` represents the user who created the media search
            article disposition.
          allOf:
            - $ref: '#/components/schemas/main.createdBy'
        justification:
          description: >-
            `justification` provides the reasoning or explanation behind a
            particular disposition in a media search article.
          type: string
          example: >-
            Jan Marsalek, an Austrian executive and fugitive, is central to
            Austria's biggest espionage scandal. He is wanted by German police
            for alleged fraud and is believed to be in Russia. Marsalek is
            accused of commissioning former security officials to pass sensitive
            information to Russia. He fled to Moscow in 2020 and was reportedly
            recruited by Russian agents in 2014.
        media_search_article_disposition_id:
          description: >-
            `media_search_article_disposition_id` represents the unique
            identifier for the disposition assigned to a media search article.
          type: string
          example: f0127405-c357-469a-a145-df77c5f0810f
        media_search_article_id:
          description: >-
            `media_search_article_id` represents the unique identifier for a
            specific media search article.
          type: string
          example: ca6993d5-c4a5-4227-a957-81a76d8279b4
        media_search_execution_id:
          description: >-
            `media_search_execution_id` represents the unique identifier for a
            media search execution.
          type: string
          example: f0549515-ffb9-4dfd-a116-efb4143afda4
        media_search_id:
          description: >-
            `media_search_id` represents the unique identifier for a media
            search.
          type: string
          example: 4ccd19dc-c60b-4ce7-b512-bba106f1cb16
        organisation_id:
          description: >-
            `organisation_id` represents the unique identifier for an
            organisation.
          type: string
          example: d43a4ec2-3eb8-46ad-9ca9-09a26540968f
        risk:
          description: >-
            `risk` represents the risk level associated with a media search
            article.
          type: string
          enum:
            - RISKY
            - NOT_RISKY
        risk_categories:
          description: >-
            `risk_categories` holds an array of strings that represent various
            risk categories associated with a media search article.
          type: array
          items:
            type: string
          example:
            - Fraud
            - Money Laundering
            - Sanctions
            - Human Rights Abuse
            - Terrorism
            - Organized Crime
            - Corruption
            - Tax Crimes
    main.mediaArticle:
      type: object
      properties:
        created_at:
          description: >-
            `created_at` indicates the timestamp when the media article was
            created.
          type: string
          example: '2024-10-22T07:37:56.676Z'
        dispositions:
          description: >-
            `dispositions` holds an array of disposition records related to the
            media article.
          type: array
          items:
            $ref: '#/components/schemas/main.disposition'
        headline:
          description: >-
            `headline` represents the title or main heading of the media
            article.
          type: string
          example: Spy scandal revives fears of Austrian exposure to Russia
        media_search_article_id:
          description: >-
            `media_search_article_id` represents the unique identifier for a
            specific media search article.
          type: string
          example: 4ccd19dc-c60b-4ce7-b512-bba106f1cb16
        media_search_execution_id:
          description: >-
            `media_search_execution_id` (uuid) represents the unique identifier
            for a media search execution.
          type: string
          example: 0a1a489b-50df-41a1-920d-6c6df381031e
        media_search_id:
          description: >-
            `media_search_id` represents the unique identifier for a media
            search.
          type: string
          example: 4ccd19dc-c60b-4ce7-b512-bba106f1cb16
        organisation_id:
          description: >-
            `organisation_id` represents the unique identifier for an
            organisation.
          type: string
          example: d43a4ec2-3eb8-46ad-9ca9-09a26540968f
        publication_date:
          description: >-
            `publication_date` indicates the date when the media article was
            published.
          type: string
          example: '2024-10-22T07:37:56.676Z'
        rank:
          description: '`rank` represents the position or order of the media article.'
          type: integer
          example: 1
        subject_match:
          description: >-
            `subject_match` represents additional contextual information or
            resolution for ambiguous data fields in an article.
          allOf:
            - $ref: '#/components/schemas/main.subjectMatch'
        url:
          description: '`url'' represents the web address of the media article.'
          type: string
          example: >-
            https://www.wired.com/story/spy-scandal-revives-fears-austrian-exposure-russia/
    main.createdBy:
      type: object
      properties:
        user_id:
          description: '`user_id` represents the unique identifier for the user.'
          type: string
          example: d43a4ec2-3eb8-46ad-9ca9-09a26540968f
    main.subjectMatch:
      type: object
      properties:
        industry_match:
          type: object
          properties:
            match_score:
              type: integer
              example: 8
            match_type:
              type: string
              example: STRONG_MATCH
            match_type_description:
              type: string
              example: Very similar
            matches:
              type: array
              items:
                type: object
                properties:
                  match_score:
                    type: number
                    example: 8
                  match_type:
                    type: string
                    example: STRONG_MATCH
                  match_type_description:
                    type: string
                    example: Very similar
                  subject_industry:
                    type: string
                    example: Banking
                  subject_industry_article:
                    type: string
                    example: Finance
            subject_industries:
              type: array
              items:
                type: string
              example:
                - Banking
                - Insurance
                - Telecommunications
            subject_industries_article:
              type: array
              items:
                type: string
              example:
                - Banking
                - Finance
                - Telecommunications
        match_score:
          type: number
          example: 7
        match_type:
          type: string
          example: MODERATE_MATCH
        match_type_description:
          type: string
          example: Similar
        nationality_matches:
          type: object
          properties:
            match_score:
              type: number
              example: 7
            match_type:
              type: string
              example: MODERATE_MATCH
            match_type_description:
              type: string
              example: Similar
            matches:
              type: array
              items:
                type: object
                properties:
                  match_score:
                    type: number
                    example: 0
                  match_type:
                    type: string
                    example: TOTAL_MISMATCH
                  match_type_description:
                    type: string
                    example: Not similar at all
                  subject_nationality:
                    type: string
                    example: US
                  subject_nationality_article:
                    type: string
                    example: DE
            subject_nationalities:
              type: array
              items:
                type: string
              example:
                - US
                - GB
            subject_nationalities_article:
              type: array
              items:
                type: string
              example:
                - US
                - DE
        place_matches:
          type: object
          properties:
            match_score:
              type: integer
              example: 7
            match_type:
              type: string
              example: MODERATE_MATCH
            match_type_description:
              type: string
              example: Similar
            matches:
              type: array
              items:
                type: object
                properties:
                  distance:
                    type: object
                    properties:
                      kilometers:
                        type: number
                        example: 1
                      miles:
                        type: number
                        example: 0.621371
                  match_score:
                    type: number
                    example: 7
                  match_type:
                    type: string
                    example: MODERATE_MATCH
                  match_type_description:
                    type: string
                    example: Similar
                  matching_values:
                    type: array
                    items:
                      type: object
                      properties:
                        value:
                          type: string
                  subject_article_place_id:
                    type: string
                    example: 12fve345-1234-1234-1234-123456789012
                  subject_place_id:
                    type: string
                    example: 12fve345-1234-1234-1234-123456789012
            subject_places:
              type: array
              items:
                type: object
                properties:
                  description:
                    type: string
                    example: Head Office
                  geo_code_place:
                    type: object
                    properties:
                      lat:
                        type: number
                        example: 40.7128
                      lng:
                        type: number
                        example: -74.006
                  place:
                    type: string
                    example: 123 Main Street, New York, USA
                  place_id:
                    type: string
                    example: 12fve345-1234-1234-1234-123456789012
            subject_places_article:
              type: array
              items:
                type: object
                properties:
                  description:
                    type: string
                    example: Home
                  place:
                    type: string
                    example: 112 Main Street, New York, USA
                  place_id:
                    type: string
                    example: 12fve345-1234-1234-1234-123456789012
        start_date_match:
          type: object
          properties:
            match_score:
              type: number
              example: 10
            match_type:
              type: string
              example: TOTAL_MATCH
            match_type_description:
              type: string
              example: Exact match
            subject_start_date:
              type: string
              example: '1980-04-07T00:00:00.000Z'
            subject_start_date_article:
              type: string
              example: '1980-04-07T00:00:00.000Z'
        type_match:
          type: object
          properties:
            match_score:
              type: number
              example: 10
            match_type:
              type: string
              example: TOTAL_MATCH
            match_type_description:
              type: string
              example: Exact match
            subject_type:
              type: string
              example: INDIVIDUAL
            subject_type_article:
              type: string
              example: INDIVIDUAL

````