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
Transfer Methods
Withdrawals
Verifications
Identity Relations
Identities
Documents
Deposits
Authentication
Pagination
Errors
Core Resources
Public Mint Blockchain
Getting started
Transacting
Configuring Metamask for the Public Mint blockchain
Interoperability [WIP]
Other Information
Public Mint Wallet
Users and Accounts
Powered by GitBook

Identity Relations

The following endpoints are used to insert, retrieve, or delete entries representing identity relations from the database.

IDENTITY RELATIONS ENDPOINTS
IDENTITY RELATIONS ENDPOINTS
GET /identity-relations/:id
POST /identity-relations/
DELETE /identity-relations/:id

The identity-relation object

The identity-relation object establishes the relation between a company identity and a person/company that is also a company officer.

A given identity-relation is identified by a unique, random id parameter.

IDENTITY RELATION OBJECT
IDENTITY RELATION OBJECT
{
    "id": "8b5e19fd-424f-4187-bb5f-a33a54bb38fa",
    "fromIdentity": "6030f456-bcf7-4309-8de2-5ef2871c07d0",
    "toIdentity": "a5b1857d-919f-4faa-859c-be665e5a6d9f",
    "label": "CEO",
    "createdAt": "2020-02-19T15:47:39.993Z",
    "updatedAt": "2020-02-19T15:47:39.993Z"
}

get
GET /identity-relations/:id

[ENVIRONMENT HOSTNAME]/identity-relations/:id
This endpoint allows to retrieve a specific identity relation.
Request
Response
Request
Path Parameters
id
required
string
Id of the identity relation
Response
200: OK
{
    "id": "8b5e19fd-424f-4187-bb5f-a33a54bb38fa",
    "fromIdentity": "6030f456-bcf7-4309-8de2-5ef2871c07d0",
    "toIdentity": "a5b1857d-919f-4faa-859c-be665e5a6d9f",
    "label": "CEO",
    "createdAt": "2020-02-19T15:47:39.993Z",
    "updatedAt": "2020-02-19T15:47:40.944Z"
}

​

Example Call

Request
Curl
Response
Request
GET [ENVIRONMENT HOSTNAME]/identity-relations/8b5e19fd-424f-4187-bb5f-a33a54bb38fa
​
Curl
curl -X POST \
  [ENVIRONMENT HOSTNAME]/identity-relations/8b5e19fd-424f-4187-bb5f-a33a54bb38fa \
  -H 'Content-Type: application/json' \
  -H 'apikey: {INSERT YOUR API KEY HERE}' \
Response
{
    "id": "8b5e19fd-424f-4187-bb5f-a33a54bb38fa",
    "fromIdentity": "6030f456-bcf7-4309-8de2-5ef2871c07d0",
    "toIdentity": "a5b1857d-919f-4faa-859c-be665e5a6d9f",
    "label": "CEO",
    "createdAt": "2020-02-19T15:47:39.993Z",
    "updatedAt": "2020-02-19T15:47:39.993Z"
}

post
POST /identity-relations

[ENVIRONMENT HOSTNAME]/identity-relations/
This endpoint allows you to submit a new identity relation between two identities on the database. One of the identities must belong to an individual company officer, with the other belonging to the company in question.
Request
Response
Request
Body Parameters
relations
required
array
Array of objects containing the relations information
companyIdentityId
required
string
Id of the company to whom will be associated the relations
Response
200: OK
Deposit successfully inserted in the database.
{
    "id": "8b5e19fd-424f-4187-bb5f-a33a54bb38fa",
    "fromIdentity": "6030f456-bcf7-4309-8de2-5ef2871c07d0",
    "toIdentity": "a5b1857d-919f-4faa-859c-be665e5a6d9f",
    "label": "CEO",
    "createdAt": "2020-02-19T15:47:39.993Z",
    "updatedAt": "2020-02-19T15:47:39.993Z"
}

​

Example Call

Request
Curl
Response
Request
POST [ENVIRONMENT HOSTNAME]/identity-relations/
​
Curl
curl -X POST \
  [ENVIRONMENT HOSTNAME]/identity-relations \
  -H 'Content-Type: application/json' \
  -H 'apikey: {INSERT YOUR API KEY HERE}' \
  -d '{
  "companyIdentityId": "f51c7041-fdab-4f03-acaf-9c34df178724",
	"relations": [
		{
			"id": "f51c7041-fdab-4f03-acaf-9c34df178724",
			"label": "CEO"
		}
	] 
}
Response
{
    "id": "8b5e19fd-424f-4187-bb5f-a33a54bb38fa",
    "fromIdentity": "6030f456-bcf7-4309-8de2-5ef2871c07d0",
    "toIdentity": "a5b1857d-919f-4faa-859c-be665e5a6d9f",
    "label": "CEO",
    "createdAt": "2020-02-19T15:47:39.993Z",
    "updatedAt": "2020-02-19T15:47:39.993Z"
}

delete
DELETE /identity-relations/:id

[ENVIRONMENT HOSTNAME]/identity-relations/:id
This endpoint is used to delete a specific identity-relation.
Request
Response
Request
Path Parameters
id
required
string
Id of the identity relation to be deleted
Response
200: OK
​
​
​
​
​

​

Example Call

Request
Curl
Request
DELETE [ENVIRONMENT HOSTNAME]/identity-relations/edd56760-39e7-45cd-8ca6-21add09ac548
​
Curl
curl -X DELETE \
  [ENVIRONMENT HOSTNAME]/identity-relations/edd56760-39e7-45cd-8ca6-21add09ac548 \
  -H 'apikey: {INSERT API KEY HERE}'
Previous
Verifications
Next
Identities
Last updated 2 years ago
Contents
The identity-relation object
get
GET /identity-relations/:id
post
POST /identity-relations
delete
DELETE /identity-relations/:id