To receive validation data of signed document.
1. Validation information is returned for the specified file;
2. If the file is not signed, an error message is returned;
The Service provider's application sends the following GET request using TLS:
|String (64)||Mandatory||File processing session identifier|
|String (64)||Mandatory||Document identifier, received from "upload" or "list" operation as "id" property|
The request must contain an Authorization header with an OAuth Introspect access token obtained via Integration Platform a Service provider's credentials grant flow.
General structure of validation response (JSON object):
|Array||Information about files included in the ASIC container.|
|String||Name of the faile included in the ASIC container.|
|String||Format (and optionally version) of the digitally signed document container.|
|Array||Collection of signatures found in digitally signed document|
|String||Signature ID attribute|
|Object||Object containing trusted signing time information.|
Time value that is regarded as trusted signing time, denoting the earliest time when it can be trusted by the validation application (because proven by some Proof-of-Existence present in the signature) that a signature has existed.
The source of the value depends on the signature profile (see also SignatureFormat parameter):
- Signature with time-mark (LT_TM level) - the producedAt value of the earliest valid time-mark (OCSP confirmation of the signer's certificate) in the signature.
- Signature with time-stamp (LT or LTA level) - the genTime value of the earliest valid signature time-stamp token in the signature.
- Signature with BES or EPES level - the value is empty, i.e. there is no trusted signing time value available.
|String||Signature/Seal Creator. CN (common name) value portion in signer's certificate's subject distinguished name|
|Array||Information about validation error(s), array of error messages.|
|Array||Block of validation warnings that do not affect the overall validation result.|
Overall result of the signature's validation process, according to ETSI EN 319 102-1 "Table 5: Status indications of the signature validation process".
Note that the validation results of different signatures in one signed document (signature container) may vary.
|signaturesExt.subindication||String||Additional subindication in case of failed or indeterminate validation result, according to ETSI EN 319 102-1 "Table 6: Validation Report Structure and Semantics"|
Legal level of the signature, according to Regulation (EU) No 910/2014.
- Possible values on positive validation result:
QES_EDL - "ADES_QC" signature, which according to Latvian Electronic Documents Law is equivalent to a handwritten signature
- Possible values on indeterminate validation result:
prefix INDETERMINATE is added to the level described in positive result. For example INDETERMINATE_QESIG
- Possible values on negative validation result:
In addition to abovementioned
Format and profile (according to Baseline Profile) of the signature. See XAdES Baseline Profile, CAdES Baseline Profile and PAdES Baseline Profile for detailed description of the Baseline Profile levels.
XAdES_BASELINE_LT - long-term level XAdES signature where time-stamp is used as a assertion of trusted signing time
XAdES_BASELINE_LT_TM - long-term level XAdES signature where time-mark is used as a assertion of trusted signing time.
|String||SERIALNUMBER value portion in signer's (natural person) certificate's subject distinguished name.|
|String||OID 22.214.171.124 (organizationIdentifier) value portion in signer's (legal person) certificate's subject distinguished name.|
|Date||Time of validating the signature by the service.|
|Number||Number of signatures found inside digitally signed file.|
|Number||Signatures count that have validated to TOTAL-PASSED. See also SignatureExt.Indication field.|
Validation process against what the document is validated, only applicable on DSS based validations.
|Object||Object containing information about validated document.|
|String||Digitally signed document's file name.|