# Get disposable contract

Returns the disposable contract (Mod_NAMCA22D), the privacy document URL, and the T&C document URL for the specified LRA.

The contract is pre-filled with holder data if disposableHolder, disposableContacts and disposableDoc are all provided. If omitted, the contract is returned blank.

See getDisposableContract.

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

## Path parameters:

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

## Request fields (application/json):

  - `languageCode` (array, required)
    Languages of the document. ISO 639-1 alpha-2 codes. You can specify more than one value.
    Example: ["IT"]

  - `docTypes` (array, required)
    Type of document to return. 1 = PDF, 2 = TXT. You can specify more than one value.
    Example: [1,2]

  - `productType` (string, required)
    Type of disposable certificate. See [DisposableType](https://docs.namirial.app/products/leandisposable/enterprise-documentation/developer-documentation/api-references/lean-enum-types#disposabletype).
    Example: "DISPOSABLE"

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

  - `disposableHolder` (object)
    Holder data. Optional — if provided together with disposableContacts and disposableDoc, the contract (Mod_NAMCA22D) is pre-filled.

  - `disposableHolder.firstName` (string, required)
    First name of the holder (UTF-8). See [allowed characters rules](https://docs.namirial.app/products/leandisposable/enterprise-documentation/developer-documentation/integration-guide/lean-faq-allowed-characters).

  - `disposableHolder.lastName` (string, required)
    Last name of the holder (UTF-8). See [allowed characters rules](https://docs.namirial.app/products/leandisposable/enterprise-documentation/developer-documentation/integration-guide/lean-faq-allowed-characters).

  - `disposableHolder.identificationType` (string, required)
    Type of identification document. Together with identificationCode and identificationCountry it composes the certificate serial number.
    Enum: "ITALIAN_TAX_CODE", "FOREIGN_TAX_CODE", "PASSPORT", "PERSONAL_NUMBER", "NATIONAL_IDENTITY_CARD", "DRIVING_LICENSE", "RESIDENCE_PERMIT", "RESIDENCE_PERMIT_TEMP", "EMBASSY_DOCUMENT", "AM"

  - `disposableHolder.identificationCode` (string, required)
    Unique code of the identification document. Together with identificationType and identificationCountry it composes the certificate serial number. See [allowed characters rules](https://docs.namirial.app/products/leandisposable/enterprise-documentation/developer-documentation/integration-guide/lean-faq-allowed-characters).

  - `disposableHolder.identificationCountry` (string, required)
    Country where identification was issued. ISO 3166-1 alpha-2 code.

  - `disposableHolder.birthDate` (string)
    Date of birth in ISO 8601 format (yyyy-MM-dd). Example: 1980-01-01. Note: the date is not validated semantically by the backend.
    Example: "1980-01-01"

  - `disposableHolder.birthCity` (string)
    City of birth. See [allowed characters rules](https://docs.namirial.app/products/leandisposable/enterprise-documentation/developer-documentation/integration-guide/lean-faq-allowed-characters).

  - `disposableHolder.citizenShip` (string)
    Citizenship country. ISO 3166-1 alpha-2 code.

  - `disposableContacts` (object)
    Holder contact information. Required if otpType=SMS or otpType=EMAIL. Provide mobile if otpType=SMS, email if otpType=EMAIL.

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

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

  - `disposableDoc` (object)
    Identity document information.

Not required if one of the following conditions is true:
- DisposableIdentification.identificationType is AML
- DisposableHolder.identificationType is one of: PASSPORT, PERSONAL_NUMBER, NATIONAL_IDENTITY_CARD, DRIVING_LICENSE, RESIDENCE_PERMIT, RESIDENCE_PERMIT_TEMP, EMBASSY_DOCUMENT

  - `disposableDoc.documentType` (string, required)
    Identity document type. See [allowed values](https://docs.namirial.app/products/leandisposable/enterprise-documentation/developer-documentation/api-references/data-objects#disposabledoc).
    Enum: "CI", "PASS", "PA", "RP", "CIE", "RT", "DC", "AT"

  - `disposableDoc.documentNr` (string, required)
    Document number.

  - `disposableDoc.documentIssuer` (string)
    Entity that issued the document.

  - `disposableDoc.documentIssuerDate` (string, required)
    Date on which the document was issued. ISO 8601 format yyyy-MM-dd. Other formats are not accepted.

  - `disposableDoc.documentIssuerCountry` (string, required)
    Country where document was issued. ISO 3166-1 alpha-2 code.

  - `disposableDoc.documentExpirationDate` (string, required)
    Date on which the document was expires. ISO 8601 format yyyy-MM-dd. Other formats are not accepted.

  - `disposableCertificate` (object)
    Disposable Certificate configuration.

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

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

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

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

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

  - `disposableCertificate.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"

  - `disposableCertificate.transactionLimit` (object)

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

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

  - `disposableCertificate.limitationOfUse` (object)

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

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

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