Creating identities

Search…

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
1
// Request body:
2
​
3
{
4
  "name": "David McGreat",
5
  "email": "[email protected]",
6
  "birthday": "1991-01-01",
7
  "gender": "Male",
8
  "identityType": "person",
9
  "companyOfficer": "false"
10
  "identityOwner": ONLY FOR COMPANIES
11
  "address": {
12
    "street": "W Cass St",
13
    "postalCode": 111222,
14
    "city": "Tampa",
15
    "country": "US"
16
  },
17
  "phone": {
18
    "number": 444555666,
19
    "sms": true
20
  },
21
  "tax": {
22
    "idNumber": 1234567890,
23
    "state": "FL",
24
    "country": "US"
25
  }
26
}
Copied!
1
// Response body:
2
​
3
{
4
  "name": "David McGreat",
5
  "email": "[email protected]",
6
  "birthday": "1991-01-01",
7
  "gender": "Male",
8
  "address": {
9
    "street": "W Cass St",
10
    "postalCode": 111222,
11
    "city": "Tampa",
12
    "country": "US"
13
  },
14
  "phone": {
15
    "number": 444555666,
16
    "sms": true
17
  },
18
  "tax": {
19
    "idNumber": 1234567890,
20
    "state": "FL",
21
    "country": "US"
22
  }
23
}
Copied!
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.
KYC for individuals
KYC for 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.

Public Mint API - Previous

Getting started

KYC for individuals

Last modified 1yr ago

Copy link

Contents

Step 1: Create an identity

Optional: check the verifications status

Step 2: Go through KYC