---
title: "Fetch fraud result"
method: GET
path: "/v2/submission/{submission_id}/fraud"
---

# Fetch fraud result

`GET /v2/submission/{submission_id}/fraud`

Fetch fraud analysis result

## Path parameters

- `submission_id` string, required

## Query parameters

- `with_metadata` boolean

## Response `200`

Asynchronous processing finished (either with a success or an error). Result of the processing is described by the specific response object.

- union
  - AnalysisSuccessResponse
    - `status` 'SUCCESS', required
    - `analysis_time` string, required — Timestamp of analysis
    - `file_type` 'unsupported' | 'pdf' | 'image', required — Type of analyzed file
    - `mime_type` string, required — Mime type of the input file, e.g. `application/pdf`, `image/jpeg`, etc.
    - `deployment_version` string, required — Version of quality engine used for analysis
    - `query_id` string, nullable, required — Customer's own submission ID. This field may contain customer's own internal ID of analyzed file (e.g. ID in database).
    - `sha256` string, required — Sha256 of the input file
    - `filtered_parsed_pages` integer[], required — List of pages that were selected from document for processing, empty list means all pages were selected
    - `num_pages` integer, required — Number of pages in submitted document. Note that, for images, this is equal to 1
    - `score` 'NORMAL' | 'TRUSTED' | 'WARNING' | 'HIGH_RISK', required — Fraud score produced by the document analysis.
    - `sample_metadata` SampleMetadata, required — Metadata of an analyzed file.
      - `producer` string, nullable
      - `creator` string, nullable
      - `creation_date` string, nullable
      - `mod_date` string, nullable
      - `author` string, nullable
      - `title` string, nullable
      - `keywords` string, nullable
      - `subject` string, nullable
    - `indicators` Indicator[], required — Indicators contains detailed information about the specific results of our analysis. This field contains detailed observations that the system was able to make about the file. Some indicators may be positive and may increase the Trust score, while the others would be negative and would increase the Risk.
      - `indicator_id` string, required — Unique identifier for the indicator
      - `type` 'RISK' | 'TRUST' | 'INFO', required — Type of a quality indicator.
      - `category` string, required — Category of indicator (e.g. `modifications`, `text_hiding`, etc.)
      - `title` string, required
      - `description` string, required — Detailed description of the indicator.
      - `metadata` union — Additional metadata associated with the indicator. <b>Content of metadata evolves and can change without prior notice</b>. It is intended mainly for visualization in UI and tracking purposes.
        - DataOnlyIndicatorMetadata
          - `type` 'DataOnly', required
          - `column_names` string[], required — Names of individual columns in data table
          - `data` array[], required — Detailed information related to given indicator, e.g. document metadata, details about discrepancies in parsed content, etc.
            - union[]
              - …
        - ElementsCollectionIndicatorMetadata
          - `type` 'ElementsCollection', required
          - `data` IndicatorMetadataElement[] — Metadata elements that represents individual detections, e.g. modified characters, area with flash reflection, etc.
            - union
              - …
          - `columns_definition` ColumnDefinition[] — Definition of columns in data table.
            - `column_name` string, required — Name of column in data table
            - `field_name` string, required — Field name in IndicatorMetadataElement object
        - CombiningIndicatorMetadata
          - `type` 'Combining', required
          - `data` union[] — Metadata elements that represents individual detections, e.g. modified characters, area with flash reflection, etc. and detailed information related to given indicator, e.g. document metadata, details about discrepancies in parsed content, etc.
            - union
              - …
      - `indicator_attributes` union — Additional indicator-specific attributes associated with Indicator
        - object
          - `indicator_id` 'in_transaction_cluster' | 'in_transaction_cluster_benevolent'
          - `serial_fraud_cluster_id` string
          - `cluster_submission_ids_sample` string[]
          - `cluster_query_ids_sample` string[]
        - object
          - `indicator_id` 'has_logo', required
          - `logo_primary` LogoAttributes
            - `authority_id` string, required
            - `authority_name` string
            - `authority_type` 'bank' | 'government' | 'insurance' | 'income' | 'multipurpose' | 'utility' | 'unclassified', required
            - `authority_country` string — Country that issued this document, e.g. USA, DEU, FRA, CZE, SVK, etc. The country code is encoded with ISO-31661 alpha-3 code, see https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3#Officially_assigned_code_elements.
          - `detected_logos` LogoAttributes[], required
            - `authority_id` string, required
            - `authority_name` string
            - `authority_type` 'bank' | 'government' | 'insurance' | 'income' | 'multipurpose' | 'utility' | 'unclassified', required
            - `authority_country` string — Country that issued this document, e.g. USA, DEU, FRA, CZE, SVK, etc. The country code is encoded with ISO-31661 alpha-3 code, see https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3#Officially_assigned_code_elements.
      - `origin` 'fraud' | 'quality', required
    - `document_class` union — This field will be removed from the /fraud API response in November 2025. Please use the /classification endpoint for accessing document classification results.Depracated and replaced by document classification.
      - DocumentClass
        - `id` string, required — Document class that describes type of file submitted for analysis, e.g. invoice, account statement, payslip, etc.
        - `type` 'mixed' | 'unknown' | 'account_confirmation' | 'account_statement' | 'bank_details' | 'delivery_note' | 'company_detail' | 'earnings_confirmation' | 'employer_identification_number' | 'fees_statement' | 'government_registry_confirmation' | 'id_document' | 'incorporation_certificate' | 'insurance_claim' | 'insurance_documentation' | 'invoice' | 'order' | 'order_confirmation' | 'payment' | 'payment_confirmation' | 'payslip' | 'proof_of_address' | 'receipt' | 'registration_certificate' | 'rental_agreement' | 'report' | 'residence_certificate' | 'tax_form' | 'tax_information' | 'ticket' | 'tracking_note' | 'transaction_detail' | 'transaction_history' | 'transport_order' | 'utility_bill' | 'vehicle_appraisal' | 'vehicle_registration_certificate' | 'account_overview' | 'account_passbook' | 'accounting_records' | 'appointment_detail' | 'axel' | 'contract' | 'court_documents' | 'earnings_statement' | 'earnings_summary' | 'email' | 'letter' | 'loan_offer' | 'income_confirmation_form' | 'insurance_claim_notice' | 'insurance_settlement' | 'load_confirmation' | 'medical_documentation' | 'policy' | 'quote' | 'rate_confirmation' | 'request_for_payment' | 'serial_fraud' | 'timesheet' | 'unemployment_certificate' | 'bank_card', required — An enumeration.
        - `document_class_type` 'DocumentClass', required — This field can be used to discriminate the actual type of the serialized object, for more details see http://spec.openapis.org/oas/v3.1.0#composition-and-inheritance-polymorphism. Note that the list is not fixed and additional types may be added without further notice.
      - IdDocumentClass
        - `id` string, required — Document class that describes type of file submitted for analysis, e.g. invoice, account statement, payslip, etc.
        - `type` 'mixed' | 'unknown' | 'account_confirmation' | 'account_statement' | 'bank_details' | 'delivery_note' | 'company_detail' | 'earnings_confirmation' | 'employer_identification_number' | 'fees_statement' | 'government_registry_confirmation' | 'id_document' | 'incorporation_certificate' | 'insurance_claim' | 'insurance_documentation' | 'invoice' | 'order' | 'order_confirmation' | 'payment' | 'payment_confirmation' | 'payslip' | 'proof_of_address' | 'receipt' | 'registration_certificate' | 'rental_agreement' | 'report' | 'residence_certificate' | 'tax_form' | 'tax_information' | 'ticket' | 'tracking_note' | 'transaction_detail' | 'transaction_history' | 'transport_order' | 'utility_bill' | 'vehicle_appraisal' | 'vehicle_registration_certificate' | 'account_overview' | 'account_passbook' | 'accounting_records' | 'appointment_detail' | 'axel' | 'contract' | 'court_documents' | 'earnings_statement' | 'earnings_summary' | 'email' | 'letter' | 'loan_offer' | 'income_confirmation_form' | 'insurance_claim_notice' | 'insurance_settlement' | 'load_confirmation' | 'medical_documentation' | 'policy' | 'quote' | 'rate_confirmation' | 'request_for_payment' | 'serial_fraud' | 'timesheet' | 'unemployment_certificate' | 'bank_card', required — An enumeration.
        - `document_class_type` 'IdDocumentClass', required
        - `detailed_type` 'unknown' | 'birth_certificate' | 'drivers_license' | 'health_insurance_card' | 'id_card' | 'id_certificate' | 'passport' | 'residence_permit', required — An enumeration.
        - `issuing_country` string, required — Country that issued this ID document, e.g. USA, DEU, FRA, CZE, SVK, etc. The country code is encoded with ISO-31661 alpha-3 code, see https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3#Officially_assigned_code_elements.
      - UtilityBillDocumentClass
        - `id` string, required — Document class that describes type of file submitted for analysis, e.g. invoice, account statement, payslip, etc.
        - `type` 'mixed' | 'unknown' | 'account_confirmation' | 'account_statement' | 'bank_details' | 'delivery_note' | 'company_detail' | 'earnings_confirmation' | 'employer_identification_number' | 'fees_statement' | 'government_registry_confirmation' | 'id_document' | 'incorporation_certificate' | 'insurance_claim' | 'insurance_documentation' | 'invoice' | 'order' | 'order_confirmation' | 'payment' | 'payment_confirmation' | 'payslip' | 'proof_of_address' | 'receipt' | 'registration_certificate' | 'rental_agreement' | 'report' | 'residence_certificate' | 'tax_form' | 'tax_information' | 'ticket' | 'tracking_note' | 'transaction_detail' | 'transaction_history' | 'transport_order' | 'utility_bill' | 'vehicle_appraisal' | 'vehicle_registration_certificate' | 'account_overview' | 'account_passbook' | 'accounting_records' | 'appointment_detail' | 'axel' | 'contract' | 'court_documents' | 'earnings_statement' | 'earnings_summary' | 'email' | 'letter' | 'loan_offer' | 'income_confirmation_form' | 'insurance_claim_notice' | 'insurance_settlement' | 'load_confirmation' | 'medical_documentation' | 'policy' | 'quote' | 'rate_confirmation' | 'request_for_payment' | 'serial_fraud' | 'timesheet' | 'unemployment_certificate' | 'bank_card', required — An enumeration.
        - `document_class_type` 'UtilityBillDocumentClass', required
        - `detailed_type` 'unknown' | 'electricity' | 'electricity_gas_water' | 'mobile_phone' | 'internet' | 'internet_mobile_television' | 'municipal_services', required — An enumeration.
  - PipelineFailedResponse
    - `status` 'FAILED', required
    - `message` string, required
    - `deployment_version` string, required — Version of analysis engine used for analysis
    - `analysis_time` string, required — Timestamp of analysis
    - `file_type` 'unsupported' | 'pdf' | 'image' — Type of analyzed file
    - `mime_type` string, nullable — Mime type of the input file, e.g. `application/pdf`, `image/jpeg`, etc.
    - `query_id` string, nullable — Customer's own submission ID. This field may contain customer's own internal ID of analyzed file (e.g. ID in database).
  - PipelineInvalidInputResponse
    - `status` 'INVALID_INPUT', required
    - `message` string, required
    - `deployment_version` string, required — Version of analysis engine used for analysis
    - `analysis_time` string, required — Timestamp of analysis
    - `file_type` 'unsupported' | 'pdf' | 'image' — Type of analyzed file
    - `mime_type` string, nullable — Mime type of the input file, e.g. `application/pdf`, `image/jpeg`, etc.
    - `query_id` string, nullable — Customer's own submission ID. This field may contain customer's own internal ID of analyzed file (e.g. ID in database).
  - PipelineSkippedResponse
    - `status` 'SKIPPED'
    - `message` string, required
    - `deployment_version` string, required — Version of analysis engine used for analysis
    - `analysis_time` string, required — Timestamp of analysis
    - `query_id` string, nullable — Customer's own submission ID. This field may contain customer's own internal ID of analyzed file (e.g. ID in database).

## Other responses

- `400` — Bad request.
- `401` — Missing valid authentication credentials.
- `403` — Access to the requested resource is forbidden.
- `404` — The requested resource was not found.
- `415` — Unsupported media type.
- `429` — Request quota was exceeded

---

[API](https://skmtc.dev/resistant/apis/resistant-documents-api.md) · [All operations](https://skmtc.dev/resistant/apis/resistant-documents-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/resistant/resistant-documents-api/revisions/7c1ce5331e7b/schema)