Package ai.extend.types

Class ExtractRunSummary

  • public final class ExtractRunSummary
extends java.lang.Object

    • Method Detail

      • getObject

        public java.lang.String getObject()
        Returns:
        The type of object. Will always be "extract_run".

      • getId

        public java.lang.String getId()
        Returns:
        The unique identifier for this extract run.

      • getExtractor

        public java.util.Optional<ExtractorSummary> getExtractor()
        Returns:
        The extractor that was used for this run.

        Availability: Present when an extractor reference was provided. Not present when using inline config.

      • getExtractorVersion

        public java.util.Optional<ExtractorVersionSummary> getExtractorVersion()
        Returns:
        The version of the extractor that was used for this run.

        Availability: Present when an extractor reference was provided. Not present when using inline config.

      • getFailureReason

        public java.util.Optional<java.lang.String> getFailureReason()
        Returns:
        The reason for failure.

        Availability: Present when status is "FAILED".

        Possible values include:

        • ABORTED - The run was aborted by the user
        • INTERNAL_ERROR - An unexpected internal error occurred
        • FAILED_TO_PROCESS_FILE - Failed to process the file (e.g., OCR failure, file access issues)
        • INVALID_PROCESSOR - The processor configuration is invalid
        • INVALID_CONFIGURATION - The provided configuration is incompatible with the selected model
        • PARSING_ERROR - Failed to parse the extraction output
        • PRE_PROCESSING_FAILURE - An error occurred during preprocessing (e.g., chunking)
        • POST_PROCESSING_FAILURE - An error occurred during postprocessing
        • OUT_OF_CREDITS - Insufficient credits to run the extraction
        • SCHEMA_GENERATION_FAILED - Automatic schema inference failed (only applies when schema is omitted). The file could not be parsed or a schema could not be generated from it.

        Note: Additional failure reasons may be added in the future. Your integration should handle unknown values gracefully.

      • getFailureMessage

        public java.util.Optional<java.lang.String> getFailureMessage()
        Returns:
        A detailed message about the failure.

        Availability: Present when status is "FAILED".

      • getMetadata

        public java.util.Optional<java.util.Map<java.lang.String,​java.lang.Object>> getMetadata()
        Returns:
        Any metadata that was provided when creating the extract run.

        Availability: Present when metadata was provided during creation.

      • getReviewed

        public boolean getReviewed()
        Returns:
        Indicates whether the run has been reviewed by a human.

      • getEdited

        public boolean getEdited()
        Returns:
        Indicates whether the run results have been edited during review.

      • getFile

        public java.util.Optional<FileSummary> getFile()
        Returns:
        The file that was processed. null when the file could not be accessed or processed (for example a run that failed during file ingestion, or a multi-file batch run).

      • getParseRunId

        public java.util.Optional<java.lang.String> getParseRunId()
        Returns:
        The ID of the parse run that was used for this extract run.

        Availability: Present when a parse run was created.

      • getDashboardUrl

        public java.lang.String getDashboardUrl()
        Returns:
        The URL to view the extract run in the Extend dashboard.

      • getUsage

        public java.util.Optional<RunUsageSummary> getUsage()
        Returns:
        Usage credits consumed by this extract run. Omits breakdown — fetch the full extract run by id to see the per-line items.

        Availability: Present when status is "PROCESSED". Will not be returned for runs created before October 7, 2025 or for customers on legacy billing systems.

      • getCreatedAt

        public java.time.OffsetDateTime getCreatedAt()

      • getUpdatedAt

        public java.time.OffsetDateTime getUpdatedAt()

      • equals

        public boolean equals​(java.lang.Object other)
        Overrides:
        equals in class java.lang.Object

      • getAdditionalProperties

        public java.util.Map<java.lang.String,​java.lang.Object> getAdditionalProperties()

      • hashCode

        public int hashCode()
        Overrides:
        hashCode in class java.lang.Object

      • toString

        public java.lang.String toString()
        Overrides:
        toString in class java.lang.Object