Individual

Individual Registry

Maintain and manage individual registries.

Create/Add a new Individual

Create a new Individual

post

/individual/v1/_create

Query parameters

echoResourceboolean · default: true

Client can specify if the resource in request body needs to be sent back in the response. This is being used to limit amount of data that needs to flow back from the server to the client in low bandwidth scenarios. Server will always send the server generated id for validated requests.

Body

RequestInfoobjectrequired

RequestInfo should be used to carry meta information about the requests to the server as described in the fields below. All eGov APIs will use requestinfo as a part of the request body to carry this meta information. Some of this information will be returned back from the server as part of the ResponseInfo in the response body to ensure correlation.

Individualobjectrequired

A representation of an Individual.

Responses

*/*

*/*

*/*

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/individual/v1/_create' \
  --header 'Content-Type: application/json' \
  --data '{"RequestInfo":{"apiId":"text","ver":"text","ts":1,"action":"text","msgId":"text","userInfo":{"tenantId":"text","userName":"text","primaryrole":[{"name":"text"}],"additionalroles":[{"tenantId":"text","roles":[{"name":"text"}]}]}},"Individual":{"tenantId":"tenantA","name":{},"dateOfBirth":"14/10/2022","gender":"MALE","additionalFields":{"schema":"HOUSEHOLD","version":2,"fields":[{"key":"height","value":180}]},"auditDetails":{},"address":[{"tenantId":"tenantA","locality":{"code":"text","name":"text","children":["[Circular Reference]"]}}],"identifiers":[{"identifierType":"SYSTEM_GENERATED","identifierId":"ABCD-1212"}],"skills":[{"type":"text"}]}}'

202

400

500

202

{
  "ResponseInfo": {
    "apiId": "text",
    "ver": "text",
    "ts": 1,
    "resMsgId": "text",
    "msgId": "text",
    "status": "SUCCESSFUL"
  },
  "Individual": {
    "id": "text",
    "individualId": "text",
    "tenantId": "tenantA",
    "clientReferenceId": "text",
    "userId": "text",
    "name": {},
    "dateOfBirth": "14/10/2022",
    "gender": "MALE",
    "mobileNumber": "text",
    "altContactNumber": "text",
    "email": "[e-mail]",
    "fatherName": "text",
    "husbandName": "text",
    "relationship": "text",
    "photo": "text",
    "additionalFields": {
      "schema": "HOUSEHOLD",
      "version": 2,
      "fields": [
        {
          "key": "height",
          "value": 180
        }
      ]
    },
    "isDeleted": true,
    "isSystemUser": true,
    "rowVersion": 1,
    "auditDetails": {},
    "address": [
      {
        "tenantId": "tenantA",
        "locality": {
          "code": "text",
          "name": "text",
          "children": [
            "[Circular Reference]"
          ]
        }
      }
    ],
    "identifiers": [
      {
        "identifierType": "SYSTEM_GENERATED",
        "identifierId": "ABCD-1212"
      }
    ],
    "skills": [
      {
        "type": "text"
      }
    ],
    "bloodGroup": [
      "AB+"
    ]
  }
}

Accepted

Create/Add Individuals

Create a new Individuals

post

/individual/v1/bulk/_create

Query parameters

echoResourceboolean · default: true

Client can specify if the resource in request body needs to be sent back in the response. This is being used to limit amount of data that needs to flow back from the server to the client in low bandwidth scenarios. Server will always send the server generated id for validated requests.

Body

RequestInfoobjectrequired

RequestInfo should be used to carry meta information about the requests to the server as described in the fields below. All eGov APIs will use requestinfo as a part of the request body to carry this meta information. Some of this information will be returned back from the server as part of the ResponseInfo in the response body to ensure correlation.

Individualsobject[]

Responses

*/*

*/*

*/*

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/individual/v1/bulk/_create' \
  --header 'Content-Type: application/json' \
  --data '{"RequestInfo":{"apiId":"text","ver":"text","ts":1,"action":"text","msgId":"text","userInfo":{"tenantId":"text","userName":"text","primaryrole":[{"name":"text"}],"additionalroles":[{"tenantId":"text","roles":[{"name":"text"}]}]}},"Individuals":[{"tenantId":"tenantA","name":{},"dateOfBirth":"14/10/2022","gender":"MALE","additionalFields":{"schema":"HOUSEHOLD","version":2,"fields":[{"key":"height","value":180}]},"auditDetails":{},"address":[{"tenantId":"tenantA","locality":{"code":"text","name":"text","children":["[Circular Reference]"]}}],"identifiers":[{"identifierType":"SYSTEM_GENERATED","identifierId":"ABCD-1212"}],"skills":[{"type":"text"}]}]}'

202

400

500

202

{
  "ResponseInfo": {
    "apiId": "text",
    "ver": "text",
    "ts": 1,
    "resMsgId": "text",
    "msgId": "text",
    "status": "SUCCESSFUL"
  }
}

Accepted

Update the details of a existing Individual

Update the details of a existing Individual

post

/individual/v1/_update

Query parameters

echoResourceboolean · default: true

Client can specify if the resource in request body needs to be sent back in the response. This is being used to limit amount of data that needs to flow back from the server to the client in low bandwidth scenarios. Server will always send the server generated id for validated requests.

Body

RequestInfoobjectrequired

RequestInfo should be used to carry meta information about the requests to the server as described in the fields below. All eGov APIs will use requestinfo as a part of the request body to carry this meta information. Some of this information will be returned back from the server as part of the ResponseInfo in the response body to ensure correlation.

Individualobjectrequired

A representation of an Individual.

Responses

*/*

*/*

*/*

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/individual/v1/_update' \
  --header 'Content-Type: application/json' \
  --data '{"RequestInfo":{"apiId":"text","ver":"text","ts":1,"action":"text","msgId":"text","userInfo":{"tenantId":"text","userName":"text","primaryrole":[{"name":"text"}],"additionalroles":[{"tenantId":"text","roles":[{"name":"text"}]}]}},"Individual":{"tenantId":"tenantA","name":{},"dateOfBirth":"14/10/2022","gender":"MALE","additionalFields":{"schema":"HOUSEHOLD","version":2,"fields":[{"key":"height","value":180}]},"auditDetails":{},"address":[{"tenantId":"tenantA","locality":{"code":"text","name":"text","children":["[Circular Reference]"]}}],"identifiers":[{"identifierType":"SYSTEM_GENERATED","identifierId":"ABCD-1212"}],"skills":[{"type":"text"}]}}'

202

400

500

202

{
  "ResponseInfo": {
    "apiId": "text",
    "ver": "text",
    "ts": 1,
    "resMsgId": "text",
    "msgId": "text",
    "status": "SUCCESSFUL"
  },
  "Individual": {
    "id": "text",
    "individualId": "text",
    "tenantId": "tenantA",
    "clientReferenceId": "text",
    "userId": "text",
    "name": {},
    "dateOfBirth": "14/10/2022",
    "gender": "MALE",
    "mobileNumber": "text",
    "altContactNumber": "text",
    "email": "[e-mail]",
    "fatherName": "text",
    "husbandName": "text",
    "relationship": "text",
    "photo": "text",
    "additionalFields": {
      "schema": "HOUSEHOLD",
      "version": 2,
      "fields": [
        {
          "key": "height",
          "value": 180
        }
      ]
    },
    "isDeleted": true,
    "isSystemUser": true,
    "rowVersion": 1,
    "auditDetails": {},
    "address": [
      {
        "tenantId": "tenantA",
        "locality": {
          "code": "text",
          "name": "text",
          "children": [
            "[Circular Reference]"
          ]
        }
      }
    ],
    "identifiers": [
      {
        "identifierType": "SYSTEM_GENERATED",
        "identifierId": "ABCD-1212"
      }
    ],
    "skills": [
      {
        "type": "text"
      }
    ],
    "bloodGroup": [
      "AB+"
    ]
  }
}

Accepted

Update the details of existing Individuals

Update the details of existing Individuals

post

/individual/v1/bulk/_update

Query parameters

echoResourceboolean · default: true

Client can specify if the resource in request body needs to be sent back in the response. This is being used to limit amount of data that needs to flow back from the server to the client in low bandwidth scenarios. Server will always send the server generated id for validated requests.

Body

RequestInfoobjectrequired

RequestInfo should be used to carry meta information about the requests to the server as described in the fields below. All eGov APIs will use requestinfo as a part of the request body to carry this meta information. Some of this information will be returned back from the server as part of the ResponseInfo in the response body to ensure correlation.

Individualsobject[]

Responses

*/*

*/*

*/*

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/individual/v1/bulk/_update' \
  --header 'Content-Type: application/json' \
  --data '{"RequestInfo":{"apiId":"text","ver":"text","ts":1,"action":"text","msgId":"text","userInfo":{"tenantId":"text","userName":"text","primaryrole":[{"name":"text"}],"additionalroles":[{"tenantId":"text","roles":[{"name":"text"}]}]}},"Individuals":[{"tenantId":"tenantA","name":{},"dateOfBirth":"14/10/2022","gender":"MALE","additionalFields":{"schema":"HOUSEHOLD","version":2,"fields":[{"key":"height","value":180}]},"auditDetails":{},"address":[{"tenantId":"tenantA","locality":{"code":"text","name":"text","children":["[Circular Reference]"]}}],"identifiers":[{"identifierType":"SYSTEM_GENERATED","identifierId":"ABCD-1212"}],"skills":[{"type":"text"}]}]}'

202

400

500

202

{
  "ResponseInfo": {
    "apiId": "text",
    "ver": "text",
    "ts": 1,
    "resMsgId": "text",
    "msgId": "text",
    "status": "SUCCESSFUL"
  }
}

Accepted

Soft delete the details of a existing Individual and nested entities

Soft delete the details of a existing Individual and nested entities

post

/individual/v1/_delete

Query parameters

echoResourceboolean · default: true

Client can specify if the resource in request body needs to be sent back in the response. This is being used to limit amount of data that needs to flow back from the server to the client in low bandwidth scenarios. Server will always send the server generated id for validated requests.

Body

RequestInfoobjectrequired

RequestInfo should be used to carry meta information about the requests to the server as described in the fields below. All eGov APIs will use requestinfo as a part of the request body to carry this meta information. Some of this information will be returned back from the server as part of the ResponseInfo in the response body to ensure correlation.

Individualobjectrequired

A representation of an Individual.

Responses

*/*

*/*

*/*

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/individual/v1/_delete' \
  --header 'Content-Type: application/json' \
  --data '{"RequestInfo":{"apiId":"text","ver":"text","ts":1,"action":"text","msgId":"text","userInfo":{"tenantId":"text","userName":"text","primaryrole":[{"name":"text"}],"additionalroles":[{"tenantId":"text","roles":[{"name":"text"}]}]}},"Individual":{"tenantId":"tenantA","name":{},"dateOfBirth":"14/10/2022","gender":"MALE","additionalFields":{"schema":"HOUSEHOLD","version":2,"fields":[{"key":"height","value":180}]},"auditDetails":{},"address":[{"tenantId":"tenantA","locality":{"code":"text","name":"text","children":["[Circular Reference]"]}}],"identifiers":[{"identifierType":"SYSTEM_GENERATED","identifierId":"ABCD-1212"}],"skills":[{"type":"text"}]}}'

202

400

500

202

{
  "ResponseInfo": {
    "apiId": "text",
    "ver": "text",
    "ts": 1,
    "resMsgId": "text",
    "msgId": "text",
    "status": "SUCCESSFUL"
  },
  "Individual": {
    "id": "text",
    "individualId": "text",
    "tenantId": "tenantA",
    "clientReferenceId": "text",
    "userId": "text",
    "name": {},
    "dateOfBirth": "14/10/2022",
    "gender": "MALE",
    "mobileNumber": "text",
    "altContactNumber": "text",
    "email": "[e-mail]",
    "fatherName": "text",
    "husbandName": "text",
    "relationship": "text",
    "photo": "text",
    "additionalFields": {
      "schema": "HOUSEHOLD",
      "version": 2,
      "fields": [
        {
          "key": "height",
          "value": 180
        }
      ]
    },
    "isDeleted": true,
    "isSystemUser": true,
    "rowVersion": 1,
    "auditDetails": {},
    "address": [
      {
        "tenantId": "tenantA",
        "locality": {
          "code": "text",
          "name": "text",
          "children": [
            "[Circular Reference]"
          ]
        }
      }
    ],
    "identifiers": [
      {
        "identifierType": "SYSTEM_GENERATED",
        "identifierId": "ABCD-1212"
      }
    ],
    "skills": [
      {
        "type": "text"
      }
    ],
    "bloodGroup": [
      "AB+"
    ]
  }
}

Accepted

Soft delete the details of a existing Individual and nested entities in bulk

Soft delete the details of a existing Individual and nested entities in bulk

post

/individual/v1/bulk/_delete

Query parameters

echoResourceboolean · default: true

Client can specify if the resource in request body needs to be sent back in the response. This is being used to limit amount of data that needs to flow back from the server to the client in low bandwidth scenarios. Server will always send the server generated id for validated requests.

Body

RequestInfoobjectrequired

RequestInfo should be used to carry meta information about the requests to the server as described in the fields below. All eGov APIs will use requestinfo as a part of the request body to carry this meta information. Some of this information will be returned back from the server as part of the ResponseInfo in the response body to ensure correlation.

Individualsobject[]

Responses

*/*

*/*

*/*

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/individual/v1/bulk/_delete' \
  --header 'Content-Type: application/json' \
  --data '{"RequestInfo":{"apiId":"text","ver":"text","ts":1,"action":"text","msgId":"text","userInfo":{"tenantId":"text","userName":"text","primaryrole":[{"name":"text"}],"additionalroles":[{"tenantId":"text","roles":[{"name":"text"}]}]}},"Individuals":[{"tenantId":"tenantA","name":{},"dateOfBirth":"14/10/2022","gender":"MALE","additionalFields":{"schema":"HOUSEHOLD","version":2,"fields":[{"key":"height","value":180}]},"auditDetails":{},"address":[{"tenantId":"tenantA","locality":{"code":"text","name":"text","children":["[Circular Reference]"]}}],"identifiers":[{"identifierType":"SYSTEM_GENERATED","identifierId":"ABCD-1212"}],"skills":[{"type":"text"}]}]}'

202

400

500

202

{
  "ResponseInfo": {
    "apiId": "text",
    "ver": "text",
    "ts": 1,
    "resMsgId": "text",
    "msgId": "text",
    "status": "SUCCESSFUL"
  }
}

Accepted

Search existing Individual

Search existing Individual

post

/individual/v1/_search

Query parameters

limitinteger · max: 1000required

Pagination - limit records in response

offsetintegerrequired

Pagination - offset from which records should be returned in response

tenantIdstring · varcharrequired

Unique id for a tenant.

lastChangedSinceinteger · int64

epoch of the time since when the changes on the object should be picked up. Search results from this parameter should include both newly created objects since this time as well as any modified objects since this time. This criterion is included to help polling clients to get the changes in system since a last time they synchronized with the platform.

includeDeletedboolean

Used in search APIs to specify if (soft) deleted records should be included in search results.

Body

RequestInfoobjectrequired

RequestInfo should be used to carry meta information about the requests to the server as described in the fields below. All eGov APIs will use requestinfo as a part of the request body to carry this meta information. Some of this information will be returned back from the server as part of the ResponseInfo in the response body to ensure correlation.

Individualobjectrequired

A representation of an Individual.

Responses

*/*

*/*

*/*

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/individual/v1/_search?limit=1&offset=1&tenantId=text' \
  --header 'Content-Type: application/json' \
  --data '{"RequestInfo":{"apiId":"text","ver":"text","ts":1,"action":"text","msgId":"text","userInfo":{"tenantId":"text","userName":"text","primaryrole":[{"name":"text"}],"additionalroles":[{"tenantId":"text","roles":[{"name":"text"}]}]}},"Individual":{"id":[null],"clientReferenceId":[null],"name":{},"dateOfBirth":"14/10/2022","gender":"MALE","identifier":{"identifierType":"SYSTEM_GENERATED","identifierId":"ABCD-1212"}}}'

200

400

500

200

{
  "ResponseInfo": {
    "apiId": "text",
    "ver": "text",
    "ts": 1,
    "resMsgId": "text",
    "msgId": "text",
    "status": "SUCCESSFUL"
  },
  "Individuals": [
    {
      "id": "text",
      "individualId": "text",
      "tenantId": "tenantA",
      "clientReferenceId": "text",
      "userId": "text",
      "name": {},
      "dateOfBirth": "14/10/2022",
      "gender": "MALE",
      "mobileNumber": "text",
      "altContactNumber": "text",
      "email": "[e-mail]",
      "fatherName": "text",
      "husbandName": "text",
      "relationship": "text",
      "photo": "text",
      "additionalFields": {
        "schema": "HOUSEHOLD",
        "version": 2,
        "fields": [
          {
            "key": "height",
            "value": 180
          }
        ]
      },
      "isDeleted": true,
      "isSystemUser": true,
      "rowVersion": 1,
      "auditDetails": {},
      "address": [
        {
          "tenantId": "tenantA",
          "locality": {
            "code": "text",
            "name": "text",
            "children": [
              "[Circular Reference]"
            ]
          }
        }
      ],
      "identifiers": [
        {
          "identifierType": "SYSTEM_GENERATED",
          "identifierId": "ABCD-1212"
        }
      ],
      "skills": [
        {
          "type": "text"
        }
      ],
      "bloodGroup": [
        "AB+"
      ]
    }
  ]
}

Ok