| Time | Status | User Agent |  |
| :-- | :-- | :-- | :-- |
| Make a request to see history. |

#### URL Expired

The URL for this request expired after 30 days.

The request for the CreateDraftIssuer endpoint.

## draftIssuer

**object**

The top-level object defining the draft issuer.

### The Draft Issuer data object

# `` 200      A successful response.

**object**

The response for the CreateDraftIssuer endpoint.

## draftIssuer

**object**

The top-level object defining the draft issuer.

### id

**string**

length ≤ 50

The identifier of the draft issuer. Ignored if submitted in a Create Draft Issuer request.

### details

**object**

required

Details about the draft issuer, including name, address, and contact information.

### details object

#### shareClass

**object**

required

The draft issuer shares.

### shareClass object

#### resultantIssuerId

**string**

length ≤ 50

The identifier of the issuer created as a result of this draft issuer. This is an output-only field and values provided by clients will be ignored when creating draft issuers.

#### state

**string**

enum

The draft issuer operational state.

This is an output-only field and values provided by clients will be ignored when creating draft issuers.

#### transitionToIssuerTime

**object**

The timestamp of when the draft issuer's `state` transitioned from `ACTIVE` to `TRANSITIONED_TO_ISSUER`.

This is an output-only field and values provided by clients will be ignored when creating draft issuers.

### transitionToIssuerTime object

#### clientSource

**string**

length ≤ 100

An optional value provided by clients to identify the source of the draft issuer. This is leveraged to drive customer experiences and differentiate between client workflow sources.

# `` 400      Returned if required fields are omitted or if provided fields fail validation.

# `` 401      Returned if a valid `Authorization` header has not been included with the request.

# `` 403      Returned when the user does not have permission to access the resource.

# `` 500      Returned if an unexpected internal server error is encountered.

# `` default      An unexpected error response.

## Updated about 2 months ago

---

### Shell examples

```

xxxxxxxxxx

curl --request POST \
     --url https://mock-api.carta.com/v1alpha1/draftIssuers \
     --header 'accept: application/json' \
     --header 'content-type: application/json'
```

```

xxxxxxxxxx

```

```json
{
  "draftIssuer": {
    "id": "c1e82913-da74-4ce7-88c0-a70398efa101",
    "resultantIssuerId": "612",
    "state": "TRANSITIONED_TO_ISSUER",
    "transitionToIssuerTime": {
      "value": "2023-01-01T01:00:00"
    },
    "clientSource": "MY_SOURCE",
    "details": {
      "name": "XYZ Widget Company",
      "countryOfIncorporation": {
        "value": "US"
      },
      "currency": {
        "value": "USD"
      },
      "website": "http://www.example.com/XYZwidget",
      "llc": false,
      "employerIdentificationNumber": "123456789",
      "doingBusinessAs": "XYZ Widget",
      "industry": "INFORMATION_TECHNOLOGY",
      "stateOfIncorporation": {
        "value": "US-NY"
      },
      "dateOfIncorporation": {
        "value": "2018-10-31"
      },
      "address": {
        "line1": "123 Main Street",
        "city": "New York",
        "countrySubdivision": {
          "value": "US-NY"
        },
        "country": {
          "value": "US"
        },
        "postalCode": "10010"
      },
      "primaryContact": {
        "name": "Jane Doe",
        "title": "CEO",
        "email": "jane.doe@example.com",
        "registrationUrl": "https://app.carta.com/register?token=a9d06955-4b42-42bb-9ee3-8f025c863f59"
      },
      "certificateOfIncorporation": {
        "fileId": "cfa1313f-3607-4a52-9f9b-908dc94af6ee",
        "effectiveDate": {
          "value": "2018-10-31"
        }
      }
    },
    "shareClass": {
      "prefix": "CS",
      "name": "CommonShares",
      "type": "COMMON",
      "parValue": {
        "value": "0.001"
      },
      "seniority": 1,
      "authorizedShares": 1000,
      "authorizedDate": {
        "value": "2019-01-10"
      },
      "certificates": [
        {
          "quantity": 100,
          "issueDate": {
            "value": "2019-06-16"
          },
          "rule144Date": {
            "value": "2019-06-16"
          },
          "vestingSchedule": {
            "name": "2019 Vesting Schedule",
            "length": 48,
            "terms": "double-trigger",
            "vesting": {
              "frequency": "MONTHLY",
              "onDay": "SAME"
            },
            "cliff": {
              "cliffPercentage": {
                "value": "0.25"
              },
              "cliffValue": {
                "value": "1"
              },
              "cliffDuration": "YEARS"
            }
          },
          "legendName": "Default",
          "legend": "(I) THE SECURITIES REFERENCED HEREIN HAVE NOT BEEN REGISTERED UNDER THE SECURITIES ACT OF 1933, AND HAVE BEEN ACQUIRED FOR INVESTMENT AND NOT WITH A VIEW TO, OR IN CONNECTION WITH, THE SALE OR DISTRIBUTION THEREOF. NO SUCH SALE OR DISTRIBUTION MAY BE EFFECTED WITHOUT AN EFFECTIVE REGISTRATION STATEMENT RELATED THEREOF OR AN OPINION OF COUNSEL IN A FORM SATISFACTORY TO THE COMPANY THAT SUCH REGISTRATION IS NOT REQUIRED UNDER THE SECURITIES ACT OF 1933. (II) THE SECURITIES REFERENCED HEREIN MAY BE TRANSFERRED ONLY IN ACCORDANCE WITH THE TERMS OF AN AGREEMENT BETWEEN THE COMPANY AND THE STOCKHOLDER, A COPY OF WHICH IS ON FILE WITH AND MAY BE OBTAINED FROM THE SECRETARY OF THE COMPANY AT NO CHARGE. (III) THE TRANSFER OF SECURITIES REFERENCED HEREIN IS SUBJECT TO RESTRICTIONS REQUIRING APPROVAL OF THE COMPANY PURSUANT TO AND IN ACCORDANCE WITH THE COMPANY’S BYLAWS, COPIES OF WHICH MAY BE OBTAINED UPON WRITTEN REQUEST TO THE COMPANY AT ITS PRINCIPAL PLACE OF BUSINESS. THE COMPANY SHALL NOT REGISTER OR OTHERWISE RECOGNIZE OR GIVE EFFECT TO ANY PURPORTED TRANSFER OF SHARES OF STOCK THAT DOES NOT COMPLY WITH THE COMPANY’S BYLAWS.",
          "pricePerShare": {
            "value": "1.00"
          },
          "cashPaid": {
            "value": "100"
          },
          "accelerationTermsName": "double-trigger",
          "accelerationTerms": "double-trigger description",
          "stakeholder": {
            "name": "John Smith",
            "email": "john.smith@example.com",
            "relationship": "EXECUTIVE",
            "type": "INDIVIDUAL"
          },
          "stockPurchaseAgreementFileId": "945a53ed-c628-46d2-85d2-19bdc3633020"
        }
      ]
    }
  }
}
```