# 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](https://docs.namirial.app/products/leandisposable/enterprise-documentation/developer-documentation/api-references/lean-documents/lean-getDisposableContractWithEidAssertion-method) and [How to enroll with eID assertion](https://docs.namirial.app/products/leandisposable/enterprise-documentation/developer-documentation/integration-guide/lean-ig-how-to-enroll-disposable-eid-assertion).

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

## Security:

  - `basicAuth` (unknown)
    http basic

  - `sslCertificate` (unknown)
    mutualTLS

## Path parameters:

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

## Request fields (application/json):

  - `eIDAssertionHolder` (object)
    eID assertion holder data. The `country` and `eIDType` together identify the eID method (e.g., IT-SPID, IT-EIDNAMIRIAL, AT-EID). The `assertion` format depends on the eID type.

  - `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)

  - `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. See [allowed values](https://docs.namirial.app/products/leandisposable/enterprise-documentation/developer-documentation/api-references/lean-enum-types#disposabletype). Default: `DISPOSABLE`.
    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)
    Holder contact information. Required if `otpType=SMS` or `otpType=EMAIL`. Provide `mobile` if `otpType=SMS`, `email` if `otpType=EMAIL`.

  - `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

## Request examples:

  - `IT-EIDNAMIRIAL with pre-filled contract` (unknown)
    Get contract with IT-EIDNAMIRIAL eID assertion. The contract will be pre-filled with holder and contact information.

## Response 200:

  - `200` (unknown)
    Contract documents retrieved successfully. Returns an array of contract documents (Mod_NAMCA22D) with privacy and T&C links. The contract is pre-filled if `eIDAssertionHolder` and `contacts` are provided.

## 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:

  - `500` (unknown)
    Application error. The backend returns HTTP 500 for all application errors, including validation failures and authentication errors.

## 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}]

## Response 500 examples:

  - `Validation error — missing or invalid field (code 242)` (unknown)

  - `Expired eID assertion (code 237)` (unknown)

  - `Invalid eID assertion (code 235 or 238)` (unknown)

  - `Contract template not found (code 2083)` (unknown)

  - `Language not found (code 2084)` (unknown)

  - `Authentication or authorization error (code 11002)` (unknown)

  - `Authorization error — user not authorized for this method or LRA (code 11002)` (unknown)

