Creating identities

Most API calls require an IdentityID to operate on, and there's a few ways to get one.

You can obtain the IdentityID of your account in the Profile section of either the Public Mint Wallet or Partner Portal. Last but not the least, you can create identities via the API, as follows.

Step 1: Create an identity

To create an identity you'll start by issuing a POST request to the /identities endpoint, with the required data.

If you are a business partner, you may be allowed to create and manage multiple identities on behalf of your customers. In this case, your API key will signal the API gateway that you have the proper authorization. Otherwise, trying to create more than one identity per account will return an error. Please refer to the KYC for companies section to learn what you need specifically for creating a company account.

Request
Response
Request
// Request body:
{
"name": "David McGreat",
"email": "david@email.org",
"birthday": "1991-01-01",
"gender": "Male",
"identityType": "person",
"companyOfficer": "false"
"identityOwner": ONLY FOR COMPANIES
"address": {
"street": "W Cass St",
"postalCode": 111222,
"city": "Tampa",
"country": "US"
},
"phone": {
"number": 444555666,
"sms": true
},
"tax": {
"idNumber": 1234567890,
"state": "FL",
"country": "US"
}
}
Response
// Response body:
{
"name": "David McGreat",
"email": "david@email.org",
"birthday": "1991-01-01",
"gender": "Male",
"address": {
"street": "W Cass St",
"postalCode": 111222,
"city": "Tampa",
"country": "US"
},
"phone": {
"number": 444555666,
"sms": true
},
"tax": {
"idNumber": 1234567890,
"state": "FL",
"country": "US"
}
}

Every time you make such an authenticated request, the apikey in the header will be checked, thus ensuring only the owner of an identity can create transactions.

Congratulations! You've successfully created your identity and are ready to start transacting on Public Mint.

Optional: check the verifications status

After you insert the identity, a verification will be created (this may take a moment). You can check the status of the verifications by making a call to the verifications endpoint.

Step 2: Go through KYC

The next step is to go through the KYC process and get your identity verified. The process is slightly different for individuals and companies.

Please note that in order to verify a company, you must first verify a Company Officer - an individual who will have accountability for the business account.

This person must go through the regular KYC as any individual, but flagged with the companyOfficer parameter set to true.