Skip to content
DEVELOPER DOCUMENTATION
/
API Overview
/
/
Get error list

Lean Disposable Services (26.1.0.3)

REST API for enrolling and managing lean disposable certificates for secure digital signatures.

Authenticate every request with Basic Auth credentials and a client SSL certificate (mTLS). All requests require the Content-Type: application/json header.

For the full integration guide, see the Lean Disposable documentation.

Lean Disposable documentation
Download OpenAPI description
openapi.json
openapi.yaml
Languages
Servers
Production environment
https://lean.namirialtsp.com/RAWS_DISPOSABLE
Development and testing environment
https://lean.test.namirialtsp.com/RAWS_DISPOSABLE

Certificate

Methods to validate holder data, enroll disposable certificates, and send OTP codes.

Operations

Document

Methods to retrieve disposable contracts and upload documents related to the issued certificate.

Operations

Utility

Methods to verify service status and retrieve error information.

Operations

Get error list

Request

Returns the human-readable description of an error code in the requested language.

Note: requires Content-Type: application/json header.

See getErrors.

Security
basicAuth and sslCertificate
Query
codeinteger(int32)required

The error code to look up.

Example: code=1027
languagestringrequired

Language for the error text. Use ISO 639-1 alpha-2 codes: EN (English), IT (Italian), DE (German), ES (Spanish), RO (Romanian). ISO 639-2 alpha-3 codes (ENG, ITA, DEU, SPA, RON) are accepted for legacy compatibility but will not be extended to new languages.

Enum"EN""ENG""IT""ITA""DE""DEU""ES""SPA""RO""RON"
Example: language=EN
curl -i -X GET \
  -u <username>:<password> \
  'https://lean.namirialtsp.com/RAWS_DISPOSABLE/api/utility/errors?code=1027&language=EN'

Responses

Error description returned.

If the error code does not exist, errorText is "Unspecified error".

Bodyapplication/json
errorCodeinteger(int32)

The error code.

Example: 1027
errorLanguagestring

ISO 639-2 alpha-3 language code of the response.

Example: "ENG"
errorLanguage2string

ISO 639-1 alpha-2 language code of the response.

Example: "EN"
errorTextstring

Human-readable description of the error in the requested language. Returns "Unspecified error" if the error code does not exist.

Example: "The file is duplicated"
Response
application/json
{
  "errorCode": 1027,
  "errorLanguage": "ENG",
  "errorLanguage2": "EN",
  "errorText": "The file is duplicated"
}

Verify Lean service status

Request

Returns HTTP 200 if the Lean Disposable service is operational. Use this endpoint to monitor service availability.

If the service is completely unavailable, this endpoint will return 503 Service Unavailable — implement appropriate error handling for this case.

Security
basicAuth and sslCertificate
curl -i -X GET \
  -u <username>:<password> \
  https://lean.namirialtsp.com/RAWS_DISPOSABLE/api/utility/verifyLeanStatus

Responses

Service is operational. Response body is empty.

Verify web service status

Request

Returns HTTP 200 if the Lean Disposable web service (WS) is operational. Use this endpoint to monitor web service availability.

If the service is completely unavailable, this endpoint will return 503 Service Unavailable — implement appropriate error handling for this case.

Security
basicAuth and sslCertificate
curl -i -X GET \
  -u <username>:<password> \
  https://lean.namirialtsp.com/RAWS_DISPOSABLE/api/utility/verifyStatusWs

Responses

Service is operational. Response body is empty.

Get LRA capabilities

Request

Retrieves the configuration of a LRA: allowed OTP types, identification types, eID methods, certificate types, contract templates, and One Platform info. See getLraCapabilities.

Security
basicAuth and sslCertificate
Path
lraIdstringrequired

Local Registration Authority (LRA) identifier.

curl -i -X GET \
  -u <username>:<password> \
  'https://lean.namirialtsp.com/RAWS_DISPOSABLE/api/utility/{lraId}/capabilities'

Responses

LRA configuration.

Bodyapplication/json
companystring(CompanyCode)
Enum"SPA""LTD""NONE"
configobject(LraConfiguration)
otpobject(Otp)

Allowed OTP types and their constraints with DisposableIdentificationType.

disposableIdentificationTypeobject(DisposableIdentificationTypeCapabilities)

Allowed DisposableIdentificationType values for this LRA.

eidobject(Eid)

Allowed eID methods for this LRA.

certobject(Cert)
opobject(OnePlatform)
legalEntityobject(LegalEntity)

Legal entity information stored in the TSP.

contractobject(Contract)

Available contract templates for this LRA, grouped by DisposableType.

Response
application/json
{
  "company": "SPA",
  "config": {
    "maxMobileReuseInRangeDaysDisposable": 1,
    "rangeDaysMobileDisposable": 0
  },
  "otp": {
    "allowed": [ … ],
    "constraintsDisposableIdentificationType": [ … ]
  },
  "disposableIdentificationType": {
    "allowed": [ … ]
  },
  "eid": {
    "allowed": [ … ]
  },
  "cert": {
    "allowed": [ … ]
  },
  "op": {
    "legalEntityId": "00000",
    "customerId": null,
    "buReId": { … }
  },
  "legalEntity": {
    "idLegalEntity": 0,
    "country": "IT"
  },
  "contract": {
    "allowed": { … }
  }
}