# Get disposable contract with eID assertion

Retrieves disposable contract documents (Mod_NAMCA22D) using an eID assertion. Returns contract PDF/TXT, privacy document URL (Mod_NAMGDPR03D), and T&C document URL (Mod_NAMCA01D). The contract is pre-filled if eIDAssertionHolder and contacts are provided. See getDisposableContractWitheIDAssertion and How to enroll with eID assertion.

Endpoint: POST /api/document/{lraId}/getDisposableContractWitheIDAssertion
Version: 26.1.0.3
Security: basicAuth, sslCertificate

## Path parameters:

  - `lraId` (string, required)
    Local Registration Authority (LRA) identifier.

## Request fields (application/json):

  - `eIDAssertionHolder` (object)
    eID assertion holder data. If provided, the contract will be pre-filled with holder information.

  - `eIDAssertionHolder.country` (string, required)
    Country code of the eID provider. ISO 3166-1 alpha-2 code. Together with eIDType identifies the eID method (e.g., IT-SPID, IT-EIDNAMIRIAL, AT-EID).
    Example: "IT"

  - `eIDAssertionHolder.eIDType` (string, required)
    Type of eID assertion. Together with country identifies the eID method (e.g., IT-SPID, IT-EIDNAMIRIAL, AT-EID). Allowed values depend on LRA configuration.
    Example: "SPID"

  - `eIDAssertionHolder.assertion` (string, required)
    Base64-encoded eID assertion. The format depends on eIDType.

  - `cert` (object, required)
    Certificate configuration. Specifies certificate type and options.

  - `cert.password` (string, required)
    Certificate PIN.

  - `cert.securityCode` (string, required)
    Certificate security code.

  - `cert.fullData` (boolean)
    Enroll with full profile. Default: false.

  - `cert.withoutUsageLimitLRA` (boolean)
    Omit LRA limitation of use (LoU). Default: false.

  - `cert.type` (string)
    Disposable certificate type.
    Enum: "DISPOSABLE", "DISPOSABLE_30_DAYS", "LONG_LIVED", "DISPOSABLE_FEA"

  - `cert.otpType` (string)
    OTP delivery method. See [allowed values](https://docs.namirial.app/products/leandisposable/enterprise-documentation/developer-documentation/api-references/lean-enum-types#disposableotptype). Default: SMS.
    Enum: "SMS", "EMAIL", "NO_OTP", "EXTERNAL_OTP"

  - `cert.transactionLimit` (object)

  - `cert.transactionLimit.value` (integer)
    Maximum transaction value.

  - `cert.transactionLimit.currency` (string)
    Currency code. ISO 4217.

  - `cert.limitationOfUse` (object)

  - `cert.limitationOfUse.withoutUsageLimitLRA` (boolean)
    Omit LRA limitation of use. Default: false.

  - `cert.limitationOfUse.language` (string)
    Language of the limitation of use text. ISO 639-1 alpha-2 code.

  - `contacts` (object)
    Contact information. If provided, the contract will be pre-filled with contact details.

  - `contacts.email` (string)
    Email address of the holder. Required if otpType=EMAIL.

  - `contacts.mobile` (string)
    Mobile phone number in E.164 format with + prefix (e.g. +390000000000). Required if otpType=SMS.

  - `languageCode` (array, required)
    Languages of the document. ISO 639-1 alpha-2 codes. You can specify multiple values.
    Example: ["EN"]

  - `docTypes` (array, required)
    Document types. Allowed values: 1 (PDF), 2 (TXT). You can specify multiple values.
    Example: [1]

  - `country` (string)
    Country code where the final user is located. ISO 3166-1 alpha-2 code. Optional — if not specified, the default template for the specified languageCode is returned. Required when a LRA needs contracts in several languages but for different legislations (e.g., French contract for France vs. French contract for Belgium).
    Example: "IT"

## Response 200 fields (application/json):

  - `languageCode` (string)
    Language of the document. ISO 639-1 alpha-2 code.
    Example: "IT"

  - `docTypes` (integer)
    Document type. 1 = PDF, 2 = TXT.
    Example: 2

  - `doc` (string)
    Base64-encoded document (Mod_NAMCA22D). Pre-filled with holder data if disposableHolder, disposableContacts and disposableDoc were provided in the request.

  - `privacy_link` (string)
    URL to download the privacy document (Mod_NAMGDPR03D).
    Example: "https://docs.namirialtsp.com/documents/Mod_NAM_GDPR03D_ITA_IT.pdf"

  - `termsAndConditions_link` (string)
    URL to download the terms and conditions document (Mod_NAMCA01D).
    Example: "https://docs.namirialtsp.com/documents/Mod_NAM_CA01D_ITA_IT.pdf"

  - `checkBoxes` (array)
    List of checkbox label strings to be displayed to the user for acceptance.

## Response 500 fields (application/json):

  - `code` (integer, required)
    Application error code.
    Example: 242

  - `message` (string, required)
    Human-readable error description. For validation errors (code 242), includes field-level details in the format Input parameter invalid: [{field=..., message=...}].
    Example: "Input parameter invalid: [{field=disposableHolder, message=must not be null}]"