Create Identities

Search…
Create Identities
Step-by-step example to create an Identity
In this example we'll show how to use our APIs to create a valid identity that can go through the KYC process on Public Mint's services.
Before you start
Public Mint's service APIs offer a series of methods that can be used to integrate with Public Mint services and blockchain. Before you start, it's recommended that you review the full documentation available online on developers.publicmint.io.
Become a Partner
To use Public Mint's services, you need to be registered as partner and have the API Key to access the APIs. Please contact [email protected] to apply.
Environments
Public Mint has two publicly available environments that can be used by anyone: production and sandbox
Production
The Production environment is Public Mint's main environment for partners and users. It's connected to real banks and KYC verification systems. 
https://api.publicmint.io
api.publicmint.io
Sandbox
The Sandbox environment is targeted for integration development by Partners and others that want to use Public Mint's services and blockchain. It's not connected to KYC verification systems or actual banking rails. 
https://api.sandbox.publicmint.io
api.sandbox.publicmint.io
Creating Identities
Creating a new identity is as simple as making a POST request to the /identities endpoint and passing all the required information. Read here for more details.
Example
Request
1
curl -X POST \
2
  https://api.sandbox.publicmint.io/identities \
3
  -H 'Content-Type: application/json' \
4
  -H 'apiKey: [MY_API_KEY]' \
5
  -d '{
6
    "name": "John Doe",
7
    "email": "[email protected]",
8
    "companyOfficer": false,
9
    "birthday": "1998-09-09",
10
    "gender": "Male",
11
    "identityType": "person",
12
    "address": {
13
        "street": "24404 Karianne Club",
14
        "postalCode": "98605",
15
        "city": "Bingen",
16
        "country": "US",
17
        "state": "WA"
18
    },
19
    "phone": {
20
        "number": "5015321379",
21
        "sms": true
22
    },
23
    "tax": {
24
        "idNumber": "872343907",
25
        "state": "WA",
26
        "country": "US"
27
    }
28
}'
Copied!
Response
1
{
2
    "id": "4da8aa4f-4a01-4bf6-a72d-a8bac268c304",
3
    "app_id": "3f488bf9-52c1-4236-83d2-a99caacd3dc4",
4
    "verification_status": "pending",
5
    "blocked": false,
6
    "status": "active",
7
    ...
8
}
Copied!
Take note of the id field from the response. That is the identity unique identifier and will be used on the remaining steps.
Upload Identity documents
The identity verification process requires the confirmation of the personal details supplied: identity and address. That is done by uploading the necessary documents and linking them to the newly created identity. Learn more here.
Example
Request
1
curl -X POST \
2
  https://api.sandbox.publicmint.io/documents \
3
  -H 'Content-Length: [TOTAL_SIZE]' \
4
  -H 'Content-Type: multipart/form-data; boundary=--------------------------943719922750551202326880' \
5
  -H 'apiKey: [MY_API_KEY]' \
6
  -H 'content-type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' \
7
  -F description=Passport \
8
  -F label=passport \
9
  -F identityId=4da8aa4f-4a01-4bf6-a72d-a8bac268c304 \
10
  -F documentType=Passport \
11
  -F documentSide=FrontSide \
12
  -F file=@[PATH_TO_FILE]/passport.jpeg
Copied!
Response
1
{
2
    "id": "2f0a3fad-3e1c-4628-a757-70aa3bfef3cd",
3
    "identity_id": "4da8aa4f-4a01-4bf6-a72d-a8bac268c304",
4
    "status": "active",
5
    ...
6
}
Copied!
You should upload as many documents as necessary (making one POST request per document) to prove and confirm the identity created.
Verify Identity
With the identity created and the documents uploaded, the KYC process will start automatically. When the process ends, the identity's verification_status field will be updated to reflect the final result. Only identities with verification_status tagged as approved can execute fiat operations.
Sandbox
In the sandbox environment you can override the standard KYC process and do a manual approval of the identity. To do that, you must make a POST request to the /identities/:id/sandbox-approve-kyc endpoint. Note that this is only possible in the sandbox environment.
Example
Request
1
https://api.sandbox.publicmint.io/identities/4da8aa4f-4a01-4bf6-a72d-a8bac268c304/sandbox-approve-kyc \
2
  -H 'apiKey: [MY_API_KEY]'
Copied!
Response
1
{
2
    "message": "Identity sent for approval"
3
}
Copied!
Tutorials [WIP]
Create a Blockchain Address
Last modified 2yr ago
Copy link
Contents
Upload Identity documents