---
title: "Order Swiss Client Authentication Certificate"
source_url: https://dev.digicert.com/certcentral-apis/services-api/orders/order-swiss-client-auth.html
api_method: POST
api_endpoint: "/services/v2/order/certificate/dtm_client_authentication_ch"
api_url: "https://certcentral.digicert.eu/services/v2/order/certificate/dtm_client_authentication_ch"
---

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

Use this endpoint to order a Swiss Client Authentication certificate. Swiss Client Authentication certificates authenticate individuals, applications, or devices when connecting to protected services.


> **Warning**
>
> The Swiss Client Authentication Certificate is only available in CertCentral Europe. Only use the CertCentral Europe base URL, `https://certcentral.digicert.eu/services/v2`,  to construct your Swiss Qualified Certificate for Individual API request.


## Example requests and responses

## cURL

```bash
curl -X POST \
  'https://certcentral.digicert.eu/services/v2/order/certificate/dtm_client_authentication_ch' \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}' \
  -d '{
    "certificate": {
      "common_name": "Estrella Daugherty",
      "emails": [
        "estrella.daugherty@example.com"
      ],
      "signature_hash": "sha256",
      "csr": "{{csr}}"
    },
    "auto_renew": 2,
    "organization": {
      "id": 2042709
    },
    "container": {
      "id": 2003927
    },
    "csa_agreed_to": true,
    "order_validity": {
      "years": 2
    },
    "payment_method": "balance"
  }'
```


**201 Created**

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

**201 Created (on immediate approval)**

```json
{
  "id": 112233,
  "requests": [
    {
      "id": 113,
      "status": "approved"
    }
  ],
  "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>
<td>.. common_name</td>
<td>conditional</td>
<td>string</td>
<td>Common name to include in the certificate subject. Use a name that identifies the certificate holder, such as the individual's full name.</td>
</tr>
<tr>
<td>.. emails</td>
<td>required</td>
<td>array</td>
<td>Email addresses associated with the certificate holder and is included in the certificate.</td>
</tr>
<tr>
<td>.. signature_hash</td>
<td>required</td>
<td>string</td>
<td>Hash algorithm used for signing the certificate.<br>Swiss Client Authentication certificates support only SHA-256 hash algorithm.</td>
</tr>
<tr>
<td>.. dns_names</td>
<td>optional</td>
<td>array</td>
<td>DNS names to include in the certificate's Subject Alternative Name extension.</td>
</tr>
<tr>
<td>.. csr</td>
<td>optional</td>
<td>string</td>
<td>Certificate signing request (CSR) or public key must be 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>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.

<br><strong>Note</strong>: The Services API does not extract information from the CSR to fill in the details of a certificate request. You must provide values for all relevant request parameters, including certificate.common_name, certificate.dns_names, and organization.id.</td>
</tr>
<tr>
<td>.. ca_cert_id</td>
<td>optional</td>
<td>string</td>
<td>ID of the intermediate certificate authority (ICA) certificate to select as the issuing certificate. To get the <code>ca_cert_id</code> value for an ICA, use the <a href="https://dev.digicert.com/md/certcentral-apis/services-api/products/product-list.md">Product list</a> endpoint.<br>Account administrators can customize the default and allowed ICAs for each product at the container or user role level. If you do not provide a value for this parameter, we issue the certificate using the default ICA. If you provide the <code>ca_cert_id</code> value for an ICA that is not allowed, the request returns an error<sup>*</sup>. To see the custom ICA settings for each product, use the <a href="https://dev.digicert.com/md/certcentral-apis/services-api/containers/product-limits.md">Product limits</a> endpoint.<br>*This parameter is ignored if the option for ICA selection is not enabled for your account. For more information, see<a href="https://docs.digicert.com/en/certcentral/manage-certificates/ica-certificate-chain-selection-feature-for-public-tls-certificates/configure-the-ica-certificate-chain-feature-for-your-public-tls-certificates.html" target="_blank" rel="noopener noreferrer">Configure the ICA certificate chain feature for your public TLS certificates</a>.</td>
</tr>

<tr>
<td>auto_renew</td>
<td>optional</td>
<td>int</td>
<td>Number of times the certificate should renew automatically.
<br>
Default: <code>null</code> - if you do not want automatic renewal of the certificate.
<br>Supported values: <code>null</code>, <code>1</code>, <code>2</code>, <code>3</code>, <code>4</code>, <code>5</code>, <code>10</code>, <code>25</code>, <code>99</code>.
</td>
</tr>
<tr>
<td>renewal_of_order_id</td>
<td>optional</td>
<td>int</td>
<td>If order is a renewal, enter the previous order's ID.</td>
</tr>

<td>organization</td>
<td>conditional</td>
<td>object</td>
<td>Object with information about the organization to associate with the request. You can associate the request with an existing organization, or you can create a new organization when you submit the order request.<br>To associate the request with an existing organization, pass the ID of the organization as the value of <code>organization.id</code> in the body of your request. To create a new organization, include the details of the organization in the <code>organization</code> object. For more information about the structure and required parameters of the <code>organization</code> object, see the <a href="https://dev.digicert.com/md/certcentral-apis/services-api/organizations/create-organization.md">Create organization</a> documentation.<br><strong>Note</strong>: When you submit an order with organization details instead of providing an organization ID, we check the organizations that already exist in your account to avoid creating a duplicate.<br><ul><li>If we find <strong>one</strong> matching organization, we automatically associate the order with that organization instead of creating a new one.</li><li>If we find <strong>two or more</strong> matching organizations, we automatically associate the order with the oldest matching organization in your account instead of creating a new one.</li></ul><br><strong>Important</strong>: When you want to associate an order with an existing organization, we recommend always using the ID of the organization instead of the organization's details in the body of your request. To get the ID values for organizations in your account, use the <a href="https://dev.digicert.com/md/certcentral-apis/services-api/organizations/list-organizations.md">List organizations</a> endpoint. Additionally, we recommend deactivating unused organizations to ensure they are never accidentally assigned to a new order request. To deactivate an organization, use the <a href="https://dev.digicert.com/md/certcentral-apis/services-api/organizations/deactivate-organization.md">Deactivate organization</a> endpoint.</td>
</tr>
<tr>
<td>.. id</td>
<td>required<sup>*</sup></td>
<td>int</td>
<td>The ID of an existing organization to associate with the order. To get the ID of organizations in your account, use the <a href="https://dev.digicert.com/md/certcentral-apis/services-api/organizations/list-organizations.md">List organizations</a> endpoint. <br>*Not required if you are creating a new organization with your request.</td>
</tr>

<td>container</td>
<td>optional</td>
<td>object</td>
<td>If needed, specify the container the order should be placed under.</td>
</tr>
<tr>
<td>.. id</td>
<td>optional</td>
<td>int</td>
<td>Container ID.</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</td>
</tr>

<tr>
<td>order_validity</td>
<td>required</td>
<td>object</td>
<td>Defines the validity period of the certificate and order.</td>
</tr>
<tr>
<td>.. years</td>
<td>required<sup>*</sup></td>
<td>int</td>
<td>Number of years the certificate and order are valid.<br>*Can be replaced by <code>order_validity.days</code> or <code>order_validity.custom_expiration_date</code>.
<br>Range: 1-3</td>
</tr>
<tr>
<td>.. days</td>
<td>optional</td>
<td>int</td>
<td>Number of days the certificate and order are valid. <br>Overrides <code>order_validity.years</code>.</td>
</tr>
<tr>
<td>.. custom_expiration_date</td>
<td>optional</td>
<td>string</td>
<td>Custom expiration date for the certificate and order. <br>Overrides <code>order_validity.days</code> and <code>order_validity.years</code>.<br>Format: YYYY-MM-DD (for example, "2026-12-26")</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>
<tr>
<td>organization</td>
<td>object</td>
<td>Container for new organization details. Only returned if a new organization was created with the order.</td>
</tr>
<tr>
<td>.. id</td>
<td>int</td>
<td>ID of the newly created organization.</td>
</tr>
</tbody>
</table>