/cert/new

Create a new certificate.

Endpoint

https://www.tinycert.org/api/v1/cert/new (JSON)
https://www.tinycert.org/api/v1/cert/new.xml (XML)

Parameters

Crequired

ISO 3166-1 alpha-2 country code.

Example value

US

CNrequired

Common Name on the certificate.

Example value

*.example.com

Loptional

Locality (city or town).

Example value

Chicago

Orequired

Organisation name.

Example value

ACME, Inc.

OUoptional

Oranisational Unit name.

Example value

IT Department

SANsoptional

An array of Subject Alternate Names. Each SAN must be specified by an HTTP POST variable named SANs[index][type] where index is a numeric index, starting at 0 for the first SAN and type is one of "DNS", "IP", "email" or "URI". This applies even if a single SAN is specified.

Example values

Two DNS names:
SANs[0][DNS] = www.example.com
SANs[1][DNS] = example.com

or an email address:
SANs[0][email] = demo@example.com

or a combination of an IP address and some DNS names:
SANs[0][IP] = 127.0.0.1
SANs[1][IP] = ::1
SANs[2][DNS] = localhost

SToptional

State or province name.

Example value

Illinois

ca_idrequired

Numeric identifier of the Certification Authority to be used to sign the certificate.

tokenrequired

Session identifier.

Return value

When a certificate has been successfully issued, the API call will return the numeric identifier for the new certificate.

cert_idinteger

New certificate's identifier. This may be used in API calls to /cert/details, /cert/get and /cert/status.

  1. Introduction
    1. Signing requests
    2. Error conditions
  2. API sessions
    1. /connect: Open a new API session
    2. /disconnect: Close an open API session
  3. Certificate Authority management
    1. /ca/list: Get a list of all CAs in your account
    2. /ca/details: Get further details on a given CA
    3. /ca/get: Download the CA's certificate
    4. /ca/delete: Delete a given CA
    5. /ca/new: Create a new CA
  4. Certificate management
    1. /cert/list: Get a list of all certificates for a given CA
    2. /cert/details: Get further details on a given certificate
    3. /cert/get: Download the certificate, signing request, or private key for a certificate
    4. /cert/reissue: Re-issue an existing certificate
    5. /cert/status: Change certificate status
    6. /cert/new: Create a new certificate