---
title: "Order AATL Natural Person Certificate"
source_url: https://dev.digicert.com/certcentral-apis/services-api/orders/order-aatl-natural-person-certificate.html
api_method: POST
api_endpoint: "/services/v2/order/certificate/aatl_np"
api_url: "https://certcentral.digicert.eu/services/v2/order/certificate/aatl_np"
---

**POST** `https://certcentral.digicert.eu/services/v2/order/certificate/aatl_np`

Use this endpoint to order a Adobe Approved Trust List (AATL) natural person certificate. AATL natural person certificate is issued to you to apply electronic signatures. This assures the recipients that the document is from you and that the document's integrity has not been compromised or altered. 

AATL is a program that allows users worldwide to create trusted digital signatures in Adobe® Acrobat® or Reader®, and DigiCert® is a vetted member whose certificates are automatically trusted because they chain to an approved root.

## Example requests and responses

**Preconfigured hardware token (ship_token)**

```
curl -X POST \
  'https://certcentral.digicert.eu/services/v2/order/certificate/aatl_np' \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}' \
  -d '{
    "certificate": { 
        "signature_hash": "sha256",
        "usage_designation": {
            "primary_usage": "signing",
            "additional_usages": [                
                "ms_document_signing",
                "document_signing"
            ]
        }       
    },
    "cs_provisioning_method": "ship_token",
    "ship_info": {
      "name": "John Doe",
      "addr1": "360 Taylor Street",
      "addr2": "Floor 74",
      "city": "Amsterdam",
      "state": "Amsterdam",
      "zip": "1013 AA",
      "country": "NL",
      "method": "STANDARD"
    },   
    "additional_emails": [
		"jill.valentine@example.com",
		"leon.kennedy@example.com"
     ],
    "order_validity": {  
        "years": 1    
    },
    "common_name_indicator": "given_name_surname",
    "individual": {
        "first_name": "John",
        "last_name": "Doe",
        "email": "john.doe@example.com",
        "telephone": "+31202547999",
        "country": "NL",        
        "city": "Amsterdam",
        "state": "Amsterdam",
        "zip": "1013 AA"
    },    
    "csa_agreed_to": true,
    "payment_method": "balance"
}
```

**Use existing token (client_app)**

```
curl -X POST \
  'https://certcentral.digicert.eu/services/v2/order/certificate/aatl_np' \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}' \
  -d '{
    "certificate": {      
        "signature_hash": "sha256",
        "usage_designation": {
            "primary_usage": "signing",
            "additional_usages": [
                "ms_document_signing",
                "document_signing"
            ]
        }
    },
    "cs_provisioning_method": "client_app",
    "additional_emails": [
		"jill.valentine@example.com",
		"leon.kennedy@example.com"
     ],
    "order_validity": {  
        "years": 1    
    },
    "common_name_indicator": "pseudonym",
    "individual": {        
        "first_name": "John",
        "last_name": "Doe",
        "pseudonym": "John Doe",
        "email": "john.doe@example.com",
        "telephone": "+31202547999",
        "country": "NL",        
        "city": "Amsterdam",
        "state": "Amsterdam",
        "zip": "1013 AA"
    },    
    "csa_agreed_to": true,
    "payment_method": "balance"
}
```

**Install on HSM (email)**

```
curl -X POST \
  'https://certcentral.digicert.eu/services/v2/order/certificate/aatl_np' \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}' \
  -d '{
    "certificate": {
        "csr": "<csr>",
        "key_size": 2048,
        "csr_key_type": "rsa",
        "signature_hash": "sha256",
        "usage_designation": {
            "primary_usage": "signing",
            "additional_usages": [                
                "ms_document_signing",
                "document_signing"
            ]
        }
    },
    "cs_provisioning_method": "email",    
    "additional_emails": [
		"jill.valentine@example.com",
		"leon.kennedy@example.com"
     ],
    "order_validity": {  
        "years": 1    
    },
    "individual": {
        "id": 21
    },
  "common_name_indicator": "given_name_surname",
  "csa_agreed_to": true,
  "payment_method": "balance"
}
```


**201 Created (one-step)**

```json
{
  "id": 112233,
  "requests": [
    {
      "id": 113,
      "status": "pending"
    }
  ]
}
```

**201 Created (two-step)**

```json
{
  "id": 112233,
  "requests": [
    {
      "id": 113,
      "status": "submitted"
    }
  ]
}
```

**201 Created (auto)**

```json
{
  "id": 112233,
  "requests": [
    {
      "id": 113,
      "status": "approved"
    }
  ],  
  "certificate_id": 113
}
```

**201 Created (skip)**

```json
{
  "id": 112233,  
  "certificate_id": 845166333113
}
```


## Request parameters

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Req/Opt</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>certificate</td>
<td>required</td>
<td>object</td>
<td>Certificate details.</td>
</tr>
<tr>
<td>.. usage_designation</td>
<td>required</td>
<td>object</td>
<td>Object that determines the primary use (KU) and additional uses (EKU) for the certificate.</td>
</tr>
<tr>
<td>.. .. primary_usage</td>
<td>required</td>
<td>string</td>
<td>Primary use for the certificate.<br>Allowed values: <code>signing</code></td>
</tr>
<tr>
<td>.. .. additional_usages</td>
<td>optional</td>
<td>array</td>
<td>List of additional certificate uses.<br>Default: document_signing<br>Allowed values: <code>ms_document_signing</code> or <code>document_signing</code>.</td>
</tr>
<tr>
<td>cs_provisioning_method</td>
<td>required</td>
<td>string</td>
<td>Specify how you want to receive the token.<br>Default: email<br>Allowed values: <code>email</code>, <code>ship_token</code>, or <code>client_app</code>.<br>For more information about the provisioning methods, see <a href="https://dev.digicert.com/md/certcentral-apis/services-api/glossary.md#provisioning-methods">Glossary – Provisioning methods</a></td>
</tr>
<tr>
<td>ship_info</td>
<td>optional</td>
<td>object</td>
<td>For orders with the <code>cs_provisioning_method</code> of <code>ship_token</code>, specify the shipping address for the hardware token.</td>
</tr>
<tr>
<td>.. name</td>
<td>required</td>
<td>string</td>
<td>First and last name of the recipient of the order.</td>
</tr>
<tr>
<td>.. addr1</td>
<td>required</td>
<td>string</td>
<td>Shipping address for the token.</td>
</tr>
<tr>
<td>.. addr2</td>
<td>required</td>
<td>string</td>
<td>Continuation of street address.</td>
</tr>
<tr>
<td>.. city</td>
<td>required</td>
<td>string</td>
<td>Shipping city.</td>
</tr>
<tr>
<td>.. state</td>
<td>required</td>
<td>string</td>
<td>Shipping state.</td>
</tr>
<tr>
<td>.. zip</td>
<td>required</td>
<td>string</td>
<td>Shipping postal code.</td>
</tr>
<tr>
<td>.. country</td>
<td>required</td>
<td>string</td>
<td>Shipping country.</td>
</tr>
<tr>
<td>.. method</td>
<td>required</td>
<td>string</td>
<td>Shipping priority for the token.<br>Allowed values: STANDARD or EXPEDITED (incurs additional cost).</td>
</tr>
<tr>
<td>.. csr</td>
<td>conditional</td>
<td>string</td>
<td>Certificate signing request (CSR) or public key in PEM format. Format the CSR/public key as a base64-encoded string without line breaks or escape characters. Include the PEM headers and footers (such as <code>-----BEGIN CERTIFICATE REQUEST-----...</code> and <code>...-----END CERTIFICATE REQUEST-----</code>). For more information about generating a CSR, see <a href="https://www.digicert.com/kb/csr-creation.htm" target="_blank" rel="noopener noreferrer">Create a CSR</a>.<br>Required if the <code>cs_provisioning_method</code> is <code>email</code>.<br>After placing the order, if the status of the order is <code>pending</code>, you can use the <a href="https://dev.digicert.com/md/certcentral-apis/services-api/orders/update-csr.md">Update CSR</a> endpoint to update the CSR. To check the status of the order, use the [Order validation status](https://dev.digicert.com/md/certcentral-apis/services-api/orders/validation-status.md) endpoint.<br><strong>Note:</strong> The Services API does not extract information from the CSR to fill in the details of a certificate request.</td>
</tr>
<tr>
<td>.. key_size</td>
<td>optional</td>
<td>int</td>
<td>Number of bits used in the key.<br>Default: 2048<br>Allowed values for RSA key type: 2048, 3072, or 4096.<br>Allowed values for ECC key type: p-256 or p-354.</td>
</tr>
<tr>
<td>.. csr_key_type</td>
<td>optional</td>
<td>string</td>
<td>Key type for the CSR.<br>Default: RSA<br>Allowed values: rsa or ecc.</td>
</tr>
<tr>
<td>.. signature_hash</td>
<td>optional</td>
<td>string</td>
<td>Hash algorithm used for signing the certificate.<br><strong>Default:</strong> <code>sha-256</code><br><strong>Allowed values:</strong>: <code>sha256</code>, <code>sha384</code>, <code>sha512</code>.</td>
</tr>
<tr>
<td>comments</td>
<td>optional</td>
<td>string</td>
<td>Comments about the order for the administrator or approver reviewing the order request. The <code>comments</code> value is stored on the order <code>request</code>. If the order skips the approval step (<code>skip_approval</code> is set to <code>true</code>), any provided <code>comments</code> value is ignored since CertCentral creates the order directly without creating a corresponding <code>request</code>.</td>
</tr>
<tr>
<td>additional_emails</td>
<td>optional</td>
<td>array</td>
<td>Additional email addresses to receive certificate notification emails (for example, certificate issuance, duplicate certificate, and certificate renewals).</td>
</tr>
<tr>
<td>user_id_assignments</td>
<td>optional</td>
<td>array</td>
<td>List of User IDs that can manage the order.</td>
</tr>
<tr>
<td>csa_agreed_to</td>
<td>required</td>
<td>boolean</td>
<td>Specify if the Certificate Subscriber Agreement (CSA) has been agreed to. Set this parameter to <code>true</code> to indicate agreement and <code>false</code> for disagreement.<br>Default: true<br>Allowed values: true or false.</td>
</tr>
<tr>
<td>promo_code</td>
<td>optional</td>
<td>string</td>
<td>Promotional code for the order.</td>
</tr>
<tr>
<td>order_validity</td>
<td>required</td>
<td>object</td>
<td>Defines the validity period of the order.</td>
</tr>
<tr>
<td>.. years</td>
<td>required<sup>*</sup></td>
<td>int</td>
<td>Number of years the order is valid.<br>*Can be replaced by order_validity.days or order_validity.custom_expiration_date.<br>Range: 1</td>
</tr>
<tr>
<td>.. days</td>
<td>optional</td>
<td>int</td>
<td>Number of days the order is valid. Overrides order_validity.years.<br>Max value: 397</td>
</tr>
<tr>
<td>.. custom_expiration_date</td>
<td>optional</td>
<td>string</td>
<td>Custom expiration date for the order. Overrides order_validity.days and order_validity.years.<br>Format: dd MMM YYYY (for example, "09 JUN 2025")<br>Range: Must be within 397 days of the date you request the order.</td>
</tr>
</tr>
<tr>
<td>common_name_indicator</td>
<td>conditional</td>
<td>string</td>
<td>Specifies how the common name value is derived for the certificate. <br>Allowed values: <code>given_name_surname</code> or <code>pseudonym</code>. <br>In most cases, <code>given_name_surname</code> is used, and the common name is constructed from <code>individual.first_name</code> and <code>individual.last_name</code>. <br>Use <code>pseudonym</code> only when the certificate should display an alternate name instead of the individual’s legal name.
</td>
</tr>
<tr>
<td>individual</td>
<td>required</td>
<td>object</td>
<td>Information about the individual who is the intended certificate holder.</td>
</tr>
<tr>
<td>.. first_name</td>
<td>required</td>
<td>string</td>
<td>Individual's first name (given name). This can include middle names or initials, but do not include titles or prefixes such as "Dr.". </td>
</tr>
<tr>
<td>.. last_name</td>
<td>required</td>
<td>string</td>
<td>Individual's last name (surname). This can include middle names or initials, but do not include titles or prefixes such as "Dr.". </td>
</tr>

<tr>
<td>.. pseudonym</td>
<td>conditional</td>
<td>string</td>
<td>Individual's pseudonym or alternate name to be used as the certificate’s common name when <code>common_name_indicator</code> is set to <code>pseudonym</code>. This value replaces the individual’s first and last name in the certificate subject. Use only in specific cases where a non-legal display name is required. <br>Required when <code>common_name_indicator = pseudonym</code>.<br>Adding an assumed name requires additional validation and may delay certificate issuance.</td>
</tr>

<tr>
<td>.. email</td>
<td>required</td>
<td>string</td>
<td>Individual's email address. This email address is used for processing the order request and receiving order approval notifications. This email address does not appear on the certificate.</td>
</tr>
<tr>
<td>.. telephone</td>
<td>required</td>
<td>string</td>
<td>Individual’s phone number with the country code (for example, +1-555-555-5555).</td>
</tr>
<tr>
<td>.. country</td>
<td>required</td>
<td>string</td>
<td>Individual's country, represented by a two-letter country code.</td>
</tr>
<tr>
<td>.. state</td>
<td>required</td>
<td>string</td>
<td>Individual's state or province.</td>
</tr>
<tr>
<td>.. city</td>
<td>optional</td>
<td>string</td>
<td>Iindividual's city.</td>
</tr>
<tr>
<td>.. zip</td>
<td>optional</td>
<td>string</td>
<td>Individual's postal code.</td>
</tr>
<tr>
<td>.. id</td>
<td>conditional</td>
<td>integer</td>
<td>Unique identifier for the individual.<br><strong>Note:</strong> Use this parameter only if you are ordering the certificate for an existing individual, whose details are already stored in the CertCentral database. If you are adding a new individual, omit this parameter and provide the full details instead.</td>
</tr>
<tr>
<td>payment_method</td>
<td>required</td>
<td>string</td>
<td>Payment method for the order. Allowed values:<br><ul><li><code>balance</code> (default): Pay with account balance. Returns an error if the option to bill to account balance is disabled for the account, or if the account balance has insufficient funds. <a href="https://docs.digicert.com/en/certcentral/manage-account/add-a-credit-card-to-your-certcentral-account/set-up-account-credit.html" target="_blank" rel="noopener noreferrer">Learn how to debit purchases against your CertCentral account balance</a>.</li><li><code>profile</code>: Pay with the account’s default credit card. Returns an error if no default credit card is configured for the account. <a href="https://docs.digicert.com/manage-account/add-credit-card-your-certcentral-account/" target="_blank" rel="noopener noreferrer">Learn how to set up a default credit card</a>.</li><li><code>card</code>: Pay with a new credit card. Requests that use <code>card</code> as the payment method must include a <code>credit_card</code> and <code>billing_address</code> object. Returns an error if the option to pay with a credit card is disabled for the account.</li></ul></td>
</tr>
<tr>
<td>credit_card</td>
<td>required (if payment_method is card)</td>
<td>object</td>
<td>Object with information about the credit card charged for the order. Required if <code>payment_method</code> is <code>card</code>.</td>
</tr>
<tr>
<td>.. number</td>
<td>required</td>
<td>string</td>
<td>Credit card number.</td>
</tr>
<tr>
<td>.. expiration_month</td>
<td>required</td>
<td>string</td>
<td>Credit card expiration month. Format as a two-digit number between <code>01</code> (Jan) and <code>12</code> (Dec).</td>
</tr>
<tr>
<td>.. expiration_year</td>
<td>required</td>
<td>string</td>
<td>Credit card expiration year. Format as a four-digit number. For example: <code>2026</code></td>
</tr>
<tr>
<td>.. cvv</td>
<td>required</td>
<td>string</td>
<td>Card verification value (CVV). Format as a three- or four-digit number. For example: <code>333</code> or <code>4444</code></td>
</tr>
<tr>
<td>.. cardholder_name</td>
<td>required</td>
<td>string</td>
<td>Cardholder’s first and last name.</td>
</tr>
<tr>
<td>.. save_credit_card</td>
<td>optional</td>
<td>null</td>
<td>Specify whether to save the credit card details. <code>true</code> for saving the details, <code>false</code> for not saving the details, and <code>null</code> for not indicating the preference.<br>Allowed Values: true, false, or null.</td>
</tr>
<tr>
<td>.. set_as_default</td>
<td>required</td>
<td>string</td>
<td>Set the card as the default payment option or method. To set this card as your default payment method, use <code>1</code>. To keep your default payment method, use <code>0</code>.<br>Allowed Values: 1 or 0.</td>
</tr>
<tr>
<td>billing_address</td>
<td>conditional</td>
<td>object</td>
<td>Object with information about the billing address. Required if <code>payment_method</code> is <code>card</code>.</td>
</tr>
<tr>
<td>.. address</td>
<td>required</td>
<td>string</td>
<td>Billing street address.</td>
</tr>
<tr>
<td>.. address2</td>
<td>optional</td>
<td>string</td>
<td>Continuation of street address.</td>
</tr>
<tr>
<td>.. city</td>
<td>required</td>
<td>string</td>
<td>Billing city.</td>
</tr>
<tr>
<td>.. state</td>
<td>conditional</td>
<td>string</td>
<td>Billing state or province. Optional for some countries.</td>
</tr>
<tr>
<td>.. country</td>
<td>required</td>
<td>string</td>
<td>Billing country.</td>
</tr>
<tr>
<td>.. zip</td>
<td>conditional</td>
<td>string</td>
<td>Billing zip or postal code. Optional for some countries.</td>
</tr>
</tbody>
</table>

## Response parameters

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>int</td>
<td>Order ID.</td>
</tr>

<tr>
<td>requests</td>
<td>array</td>
<td>Contains information about the request.</td>
</tr>
<tr>
<td>.. id</td>
<td>int</td>
<td>Request ID.</td>
</tr>
<tr>
<td>.. status</td>
<td>string</td>
<td>Request status.<br>Possible values:pending, submitted, approved, rejected</td>
</tr>
<tr>
<td>certificate_id</td>
<td>int</td>
<td>Certificate ID. Returned if request status is approved.</td>
</tr>
</tbody>
</table>