# enrollDisposableWitheIDAssertion method

This method allows enrolling a disposable with an authorized eID assertion.
Check [How to enroll a disposable with an assertion provided by an authorized eID](/products/leandisposable/enterprise-documentation/developer-documentation/integration-guide/lean-ig-how-to-enroll-disposable-eid-assertion) for more details.

**For the full technical reference, see the [OpenAPI specification](/products/leandisposable/openapi/certificate/enrolldisposablewitheidassertion)**.

REST API
#### Endpoint


```
POST /api/certificate/{lraId}/enrollDisposableWitheIDAssertion
```

#### Headers

| Name | Required | Description |
|  --- | --- | --- |
| `Content-Type` | Yes | Must be `application/json`. |
| `Authorization` | Yes | Basic Auth credentials. |


#### Path parameters

| Parameter | Type | Required | Description |
|  --- | --- | --- | --- |
| `lraId` | integer | Yes | LRA identifier. |


#### Body parameters

| Parameter | Type | Required | Description |
|  --- | --- | --- | --- |
| `eidAssertionHolder` | object | Yes | [`DisposableeIDAssertionHolder` object](/products/leandisposable/enterprise-documentation/developer-documentation/api-references/data-objects#disposableeidassertionholder). |
| `contacts` | object | Yes | [`DisposableContacts` object](/products/leandisposable/enterprise-documentation/developer-documentation/api-references/data-objects#disposablecontacts). |
| `certificate` | object | Yes | [`DisposableCertificate` object](/products/leandisposable/enterprise-documentation/developer-documentation/api-references/data-objects#disposablecertificate). |
| `buReId` | string | No | One Platform — Business Relation ID. |


#### Request example


```json
{
    "eidAssertionHolder": {
        "assertion": "encoded base64 assertion",
        "country": "IT",
        "eIDType": "SPID"
    },
    "contacts": {
        "email": "user@example.com",
        "mobile": "+390000000000"
    },
    "certificate": {
        "fullData": false,
        "otpType": "SMS",
        "password": "YOUR_PASSWORD",
        "securityCode": "YOUR_SECURITY_CODE",
        "type": "DISPOSABLE"
    }
}
```

#### Response examples

**200 — Disposable issued**


```json
{
    "cert": "LS0tLS1CRUdJTiBDRVJU...",
    "certType": "DISPOSABLE",
    "certUsageLimit": "usage limit value",
    "certSerialNumber": "76BC101898E7E2DA",
    "certIdOtp": 1234567,
    "deviceCode": "RHIDP11111111111"
}
```

SOAP API
The SOAP interface is deprecated. Use the REST API instead.

**Method:** enrollDisposableWitheIDAssertion

| **Parameter** | **Description** | **Mandatory** |
|  --- | --- | --- |
| holder | [`DisposableeIDAssertionHolder` object](/products/leandisposable/enterprise-documentation/developer-documentation/api-references/data-objects#disposableeidassertionholder) | YES |
| contacts | [`DisposableContacts object`](/products/leandisposable/enterprise-documentation/developer-documentation/api-references/data-objects#disposablecontacts) | YES |
| cert | [`DisposableCertificate` object](/products/leandisposable/enterprise-documentation/developer-documentation/api-references/data-objects#disposablecertificate) | YES |
| lraid | The LRA identification code | NO |


**Request**


```xml
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://service.ws.nam/">
   <soapenv:Header/>
   <soapenv:Body>
      <ser:enrollDisposableWitheIDAssertion>
      <eIDAssertionHolder>
        <country>IT</country>
        <eIDType>SPID</eIDType>
        <assertion>...Assertion in base64...</assertion>
      </eIDAssertionHolder>
      <contacts>
        <email>email</email>
        <mobile>mobile</mobile>
      </contacts>
      <cert>
        <fullData>false</fullData>
        <otpType>SMS</otpType>
        <password>password</password>
        <securityCode>password</securityCode>
        <type>DISPOSABLE</type>
      </cert>
      <lraid>xxxx</lraid>
    </ser:enrollDisposableWitheIDAssertion>
   </soapenv:Body>
</soapenv:Envelope>
```

**Response Example**


```xml
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Body>
        <ns2:enrollDisposableWitheIDAssertionResponse xmlns:ns2="http://service.ws.nam/">
            <return>
                <cert>cert_value</cert>
                <certIdOtp>id_otp</certIdOtp>
                <certSerialNumber>serial_number</certSerialNumber>
                <certType>DISPOSABLE</certType>
                <certUsageLimit>L utilizzo del certificato e limitato ai rapporti con ca namirial spa/The certificate may be used only for relations with the ca namirial spa</certUsageLimit>
                <deviceCode>device_code</deviceCode>
            </return>
        </ns2:enrollDisposableWitheIDAssertionResponse>
    </soap:Body>
</soap:Envelope>
```

**Errors**: [Check here the main errors triggered.](/products/leandisposable/enterprise-documentation/developer-documentation/api-references/lean-enroll)