Start
Introduction
Core Concepts
Partner setup
Tutorials [WIP]
Public Mint Widget
Getting started
Embed Widget
Public Mint API
Getting started
Creating identities
Connecting to the blockchain
Executing Transactions
Sandbox
API Reference
Withdrawals
Verifications
Identity Relations
Identities
Documents
Deposits
Authentication
Pagination
Errors
Core Resources
Public Mint Blockchain
Getting started
Transacting
Interoperability [WIP]
Other Information
Public Mint Wallet
Users and Accounts
Powered by GitBook

Verifications

The following endpoints are used to insert and retrieve entries representing verifications (of an identity's documents) from the database.

VERIFICATIONS ENDPOINTS
VERIFICATIONS ENDPOINTS
GET /verifications/:id
GET /verifications

The verification object

The verification object represents the result of a document's check by a KYC partner.

A verification is identified by a unique, random id and relates to a user's identityId.

VERIFICATIONS OBJECT
VERIFICATIONS OBJECT
{
    "id": "3519322a-6881-472f-8e1f-2486d5f3cb15",
    "identityId": "e0564926-96e0-42e2-a544-68bc18598e40",
    "status": "pending",
    "exceptionDetails": "",
    "createdAt": "2020-01-09T10:21:05.760Z",
    "updatedAt": "2020-01-15T13:12:21.860Z"
}

get
GET /verifications/:id

https://api.publicmint.com/verifications/:id
This endpoint retrieves a specific verification by its unique id attribute.
Request
Response
Request
Path Parameters
id
required
string
Id of the verification
Response
200: OK
{
    "id": "1c1b39a2-f8ec-4680-82cd-09926e1a2c95",
    "identity_id": "7d0e05c3-73b3-45a7-af03-0ec7e89c9dd7",
    "status": "pending",
    "exception_details": "",
    "external_id": "5b161fd6-66a3-4a44-9e1e-738d2b5a573f",
    "external_system": "PrimeTrust",
    "integ_status": "waiting",
    "integ_messages": null,
    "created_at": "2019-11-11T17:47:13.221Z",
    "updated_at": "2019-11-11T17:50:14.83

​

Request

Request
Curl
Response
Request
GET https://api.sandbox.publicmint.io/verifications/ddec6616-b29f-4517-98f9-612ec7859120
Curl
curl -X GET \
  https://api.sandbox.publicmint.io/verifications/1c1b39a2-f8ec-4680-82cd-09926e1a2c95 \
  -H 'apikey: {INSERT API KEY HERE}'
Response
{
    "id": "3519322a-6881-472f-8e1f-2486d5f3cb15",
    "identityId": "e0564926-96e0-42e2-a544-68bc18598e40",
    "status": "pending",
    "exceptionDetails": "",
    "createdAt": "2020-01-09T10:21:05.760Z",
    "updatedAt": "2020-01-15T13:12:21.860Z"
}

get
GET /verifications

https://api.publicmint.com/verifications
This endpoint returns a list of all verifications associated with you. This endpoint supports pagination.
Request
Response
Request
​
Response
200: OK
{
    "total": 32,
    "data": [
        {
            "id": "3519322a-6881-472f-8e1f-2486d5f3cb15",
            "identityId": "e0564926-96e0-42e2-a544-68bc18598e40",
            "status": "pending",
            "exceptionDetails": "",
            "createdAt": "2020-01-09T10:21:05.760Z",
            "updatedAt": "2020-01-15T13:12:21.860Z"
        }
    ]
}

​

Example Call

Request
Curl
Response
Request
GET https://api.sandbox.publicmint.io/verifications
​
// Paginated
​
GET https://api.sandbox.publicmint.io/verifications?page[number]=1&page[size]=1
Curl
curl -X GET \
  'https://api.sandbox.publicmint.io/verifications?page[number]=1&page[size]=1' \
  -H 'apikey: {INSERT API KEY HERE}'
Response
{
    "total": 32,
    "data": [
        {
            "id": "3519322a-6881-472f-8e1f-2486d5f3cb15",
            "identityId": "e0564926-96e0-42e2-a544-68bc18598e40",
            "status": "pending",
            "exceptionDetails": "",
            "createdAt": "2020-01-09T10:21:05.760Z",
            "updatedAt": "2020-01-15T13:12:21.860Z"
        }
    ]
}

​

Previous
Withdrawals
Next
Identity Relations
Last updated 9 months ago
Contents
The verification object
get
GET /verifications/:id
get
GET /verifications