MOSIP Docs 1.1.5
GitHubCommunityTech Blogs
  • Home
  • Architecture
    • Guiding Principles
    • MOSIP Architecture
      • Technology Stack
    • MOSIP and Data
      • Naming Standards
      • Data-Model
    • Privacy & Security
      • Cryptography in MOSIP
    • Anonymous Profiling Support
  • Modules
    • Pre-Registration
      • Pre-Registration Functionality
      • UI Specification for Pre-registration
      • Pre-Registration Configuration
    • Registration
      • Registration Functionality
      • Registration Packet
      • Registration Client Setup
      • First User Registration and Onboarding
      • Guide to Configure MOSIP for Biometrics
      • Guide to On-board Biometric Devices
      • Device Integration Specifications
      • UI Specification for Registration Client
    • Registration Processor
      • Registration Processor Functionality
      • Deduplication and Manual Adjudication
      • MOSIP ID Object Definition
    • ID Repository
    • ID Authentication
      • ID Authentication Functionality
    • Resident Services
      • Resident Services Functionality
    • Partner Management
      • Partner Management Functionality
      • MOSIP Partner Secure Communication
      • Partner Self Service Portal
    • Administration
      • Admin Services Functionality
      • Download Card
    • Kernel
      • Audit Manager Functionality
        • Admin Service Audits
        • Resident Service Audits
        • Partner Management Audits
        • Registration Client Audits
        • Registration Processor Audits
        • ID Repository Audits
        • ID Authentication Audits
        • Pre-registration Audits
      • Authentication and Authorization Functionality
      • Auth Adapter
      • Auth Implementation
      • Common Services Functionality
      • Data Services Functionality
      • Master Data Services Functionality
      • UIN and VID Generation Service Functionality
      • VID Generator
  • Biometrics
    • ABIS
    • Biometric SDK
    • MDS Specification
    • Biometric Specification
    • CBEFF XML
    • Compliance Tool Kit
  • Build & Deploy
    • Sandbox Installer
    • Deployment Architectures
    • Cell Based Deployment Architecture
    • Hardware Security Module HSM Specifications
    • Hardware Sizing
    • Customizations for a Country
    • Other Installation Guides
      • Steps to Install and Configure HDFS
      • Steps to Install and use PostgreSQL Version 10.2 on RHEL 7.5
      • Steps to Install Clam AntiVirus Version 0.101.0
      • Steps to Install Keycloak Standalone Server
    • Services in MOSIP
  • Glossary
  • Contribute
    • Call for Contribution
    • Contributor's Guide
    • Code of Conduct
    • Issue Reporting Guideline
    • Coding Standards
      • Auth Angular User Guide
      • Auth SpringBoot User Guide
      • Gitub Workflow
      • MOSIP Java Coding Standards
      • MOSIP REST API guidelines
      • Registration Client UI Developer Document
      • Registration Client Developer Documentation
      • Security Tools
    • Testing
      • Test Rig Design
      • Tester Documentation
      • Testing Attachments Kernel
  • APIs
    • ABIS APIs
    • Admin APIs
    • AuthN and AuthZ APIs
    • Biometric SDK APIs
    • BlacklistedWords APIs
    • Common APIs
    • Device APIs
    • Device Type and Subtype APIs
    • Device Management APIs
    • Document APIs
    • Dynamic Fields APIs
    • Holiday APIs
    • ID Authentication APIs
    • ID Repository APIs
    • ID Schema APIs
    • Kernel APIs
    • Machine APIs
    • Master Data Biometric APIs
    • Packet APIs
    • Packet Manager APIs
    • Partner Management Service APIs
    • Pre Registration APIs
    • Registration Center APIs
    • Registration Processor APIs
    • Resident Service APIs
    • Sync Data APIs
    • Template APIs
    • Zone APIs
  • Older Releases
    • Release Notes 1.1.5
      • Enhancements
      • Defect Fixes
      • Patches
        • Patch 1.1.5.5
        • Patch 1.1.5.5-P1
    • Release Notes 1.1.4
      • Enhancements
      • Defect Fixes
    • Release Notes 1.1.3
      • Features
      • Bug Fixes
    • Release Notes 1.1.2
      • Features
      • Bug Fixes
    • Release Notes 1.1.1
      • Bug Fixes
      • Artifact Version
    • Release Notes 1.1.0
      • Features
      • Bug Fixes
      • 1.2.0 Features
      • Artifact Version
    • Release Notes 1.0.6
    • Release Notes 1.0.5
    • Release Notes 1.0.0
      • Features
    • Release Notes 0.9.0
  • Roadmap
    • Roadmap Activities
  • Revision History
  • License
Powered by GitBook
On this page
  • Overview
  • Resident Services APIs
  • POST /resident/v1/rid/check-status
  • POST /resident/v1/req/euin
  • POST /resident/v1/req/print-uin
  • POST /resident/v1/req/uin
  • POST /resident/v1/req/rid
  • POST /resident/v1/req/update-uin
  • POST /resident/v1/vid
  • PATCH /resident/v1/vid/{vid}
  • POST /resident/v1/req/auth-lock
  • POST /resident/v1/req/auth-unlock
  • POST /resident/v1/req/auth-history

Was this helpful?

Export as PDF
  1. APIs

Resident Service APIs

PreviousRegistration Processor APIsNextSync Data APIs

Last updated 3 years ago

Was this helpful?

Overview

This section details out all Resident Service REST APIs

Resident Services APIs

POST /resident/v1/rid/check-status

Resource URL

https://mosip.io/resident/v1/rid/check-status

Resource details

Resource Details
Description

Response format

JSON

Requires Authentication

Yes

Request Body Parameters

Name
Required
Description
Default Value
Example

id

Y

API Id

mosip.resident.uinstatus

version

Y

API version

v1

requestTime

Y

Time when Request was captured

2018-12-09T06:39:04.683Z

request: transactionID

N

Transaction ID of request

dabed834-974f-11e9-bc42-526af7764f64

request: individualId

Y

RID

9830872690593682

request: individualIdType

Y

Allowed Type of Individual ID - RID

RID

Request Body

{
  "id": "mosip.resident.checkstatus",
  "version": "v1",
  "requestTime": "2018-12-09T06:39:04.683Z",
  "request": {
  "individualId": "9830872690593682",
  "individualIdType": "RID"
  }
}

Responses

Success Response

{
  "id": "mosip.resident.checkstatus",
  "version": "v1",
  "responseTime": "2018-12-09T06:39:04.683Z",
  "response": {
    "ridStatus": "PROCESSING"
  },
  "errors": null
}

Status Code : 200 (OK)

Failed Response:

{
  "id": "mosip.resident.checkstatus",
  "version": "v1",
  "responseTime": "2018-12-09T06:39:04.683Z",
  "response": {

  },
  "errors": [
    {
      "errorCode": "XXX-XXX-002",
      "errorMessage": "Invalid RID"
    }
  ]
}

Status Code : 200 (OK)

Failure details

Error Code
Error Message
Error Description

RES-SER-001

RID not found

RES-SER-002

One or more input parameter is invalid or does not exist

RES-SER-003

Token generation failed

RES-SER-005

API resource is not available

RES-SER-006

Unable to access API resource

RES-SER-009

Invalid Input Parameter

RES-SER-012

Invalid RID

RES-SER-015

Template exception

RES-SER-016

Template subject exception

RES-SER-017

Sending notification(Email and SMS) to resident failed.

RES-SER-020

Bad Request

RES-SER-021

Invalid APi response

RES-SER-SYS-001

System exception occured

RES-SER-SYS-002

IO Exception occured

RES-SER-SYS-003

JSON Processing Exception occured

POST /resident/v1/req/euin

This request will authenticate an Individual based on provided OTP and respond with e-UIN. Notification will be sent to phone/email.

Resource URL

https://mosip.io/resident/v1/req/euin

Resource details

Resource Details
Description

Response format

JSON

Requires Authentication

Yes

Request Body Parameters

Name
Required
Description
Default Value
Example

id

Y

API Id

mosip.resident.euin

version

Y

API version

v1

requestTime

Y

Time when Request was captured

2018-12-09T06:39:04.683Z

request: transactionID

Y

Transaction ID of request

dabed834-974f-11e9-bc42-526af7764f64

request: individualId

Y

VID

9830872690593682

request: individualIdType

Y

Allowed Type of Individual ID - VID, UIN

VID

request: cardType

Y

Allowed Type of cardType - MASKED_UIN, UIN

request: otp

Y

OTP

Request Body

{
  "id": "mosip.resident.euin",
  "version": "v1",
  "requestTime": "2018-12-09T06:39:04.683Z",
  "request": {
  "transactionID": "dabed834-974f-11e9-bc42-526af7764f64",
  "individualId": "9830872690593682",
  "individualIdType": "VID",
  "cardType": "MASKED_UIN",
  "otp": "123456"
  }
}

Responses

Success Response

{
  "id": "mosip.resident.euin",
  "version": "v1",
  "responseTime": "2018-12-09T06:39:04.683Z",
  "response": {
    "euin": "<uin-pdf byte string>",
    "message": "Notification has been sent to the provided contact detail(s)"
  },
  "errors": null
}

Status Code : 200 (OK)

Failed Response

{
  "id": "mosip.resident.euin",
  "version": "v1",
  "responseTime": "2018-12-09T06:39:04.683Z",
  "response": {

  },
  "errors": [
    {
      "errorCode": "XXX-XXX-002",
      "errorMessage": "OTP Authentication Failed"
    }
  ]
}

Status Code : 200 (OK)

Failure details

Error Code
Error Message
Error Description

RES-SER-002

One or more input parameter is invalid or does not exist

RES-SER-003

Token generation failed

RES-SER-004

Invalid OTP

RES-SER-005

API resource is not available

RES-SER-006

Unable to access API resource

RES-SER-009

Invalid Input Parameter

RES-SER-010

Invalid VID

RES-SER-011

Invalid UIN

RES-SER-013

Invalid UIN for given VID

RES-SER-014

Your request is not successful, please try again later.

RES-SER-015

Template exception

RES-SER-016

Template subject exception

RES-SER-017

Sending notification(Email and SMS) to resident failed.

RES-SER-018

Invalid individualId

RES-SER-020

Bad Request

RES-SER-021

Invalid APi response

RES-SER-023

Could not find the submitted document

RES-SER-SYS-001

System exception occured

RES-SER-SYS-002

IO Exception occured

RES-SER-SYS-003

JSON Processing Exception occured

POST /resident/v1/req/print-uin

This request will authenticate an Individual based on provided OTP and post a request for UIN re-print to Postal Service. Notification will be sent to phone/email.

Resource URL

https://mosip.io/resident/v1/req/print-uin

Resource details

Resource Details
Description

Response format

JSON

Requires Authentication

Yes

Request Body Parameters

Name
Required
Description
Default Value
Example

id

Y

API Id

mosip.resident.reprintuin

version

Y

API version

v1

requestTime

Y

Time when Request was captured

2018-12-09T06:39:04.683Z

request: transactionID

Y

Transaction ID of request

dabed834-974f-11e9-bc42-526af7764f64

request: individualId

Y

VID

9830872690593682

request: individualIdType

Y

Allowed Type of Individual ID - VID, UIN

VID

request: cardType

Y

Allowed Type of cardType - MASKED_UIN, UIN

request: otp

Y

OTP

Request Body

{
  "id": "mosip.resident.reprintuin",
  "version": "v1",
  "requestTime": "2018-12-09T06:39:04.683Z",
  "request": {
  "transactionID": "dabed834-974f-11e9-bc42-526af7764f64",
  "individualId": "9830872690593682",
  "individualIdType": "VID",
  "cardType": "MASKED_UIN",
  "otp": "123456"
  }
}

Responses

Success Response

{
  "id": "mosip.resident.reprintuin",
  "version": "v1",
  "responseTime": "2018-12-09T06:39:04.683Z",
  "response": {
	"rid": "770872690593682",
    "message": "Notification has been sent to the provided contact detail(s)"
  },
  "errors": null
}

Status Code : 200 (OK)

Failed Response

{
  "id": "mosip.resident.reprintuin",
  "version": "v1",
  "responseTime": "2018-12-09T06:39:04.683Z",
  "response": {

  },
  "errors": [
    {
      "errorCode": "XXX-XXX-002",
      "errorMessage": "OTP Authentication Failed"
    }
  ]
}

Status Code : 200 (OK)

Failure details

Error Code
Error Message
Error Description

RES-SER-002

One or more input parameter is invalid or does not exist

RES-SER-003

Token generation failed

RES-SER-004

OTP validation failed

RES-SER-005

API resource is not available

RES-SER-006

Unable to access API resource

RES-SER-009

Invalid Input Parameter

RES-SER-010

Invalid VID

RES-SER-011

Invalid UIN

RES-SER-013

Invalid UIN for given VID

RES-SER-014

Your request is not successful, please try again later.

RES-SER-015

Template exception

RES-SER-016

Template subject exception

RES-SER-017

Sending notification(Email and SMS) to resident failed.

RES-SER-018

Invalid individualId

RES-SER-019

Re print UIN request failed

RES-SER-020

Bad Request

RES-SER-021

Invalid APi response

RES-SER-SYS-001

System exception occured

RES-SER-SYS-002

IO Exception occured

RES-SER-SYS-003

JSON Processing Exception occured

POST /resident/v1/req/uin

This request will authenticate an Individual based on provided OTP and respond with UIN. Notification will be sent to phone/email.

This API is yet to be developed.

Resource URL

https://mosip.io/resident/v1/req/uin

Resource details

Resource Details
Description

Response format

JSON

Requires Authentication

Yes

Request Body Parameters

Name
Required
Description
Default Value
Example

id

Y

API Id

mosip.resident.lostuin

version

Y

API version

v1

requestTime

Y

Time when Request was captured

2018-12-09T06:39:04.683Z

request: transactionID

Y

Transaction ID of request

dabed834-974f-11e9-bc42-526af7764f64

request: individualIdType

Y

Allowed Type of Individual ID - demo

demo

request: otp

Y

OTP

request: demographics

N

Demographic data of an Individual

Request Body

{
  "id": "mosip.resident.lostuin",
  "version": "v1",
  "requestTime": "2018-12-09T06:39:04.683Z",
  "request": {
  "transactionID": "dabed834-974f-11e9-bc42-526af7764f64",
  "individualIdType": "demo",
  "otp": "123456",
  "demographics": {
      "name": [
        {
          "language": "ara",
          "value": "ابراهيم بن علي"
        },
        {
          "language": "fra",
          "value": "Ibrahim Ibn Ali"
        }
      ],
      "gender": [
        {
          "language": "ara",
          "value": "الذكر"
        },
        {
          "language": "fra",
          "value": "mâle"
        }
      ],
      "postalCode": {
          "type": "10004"
        },
      "phone": {
          "type": "998989989809"
        },
      "email": {
          "type": "abcdefgh@xyz.com"
        }
    }
  }
}

Responses

Success Response

{
  "id": "mosip.resident.lostuin",
  "version": "v1",
  "responseTime": "2018-12-09T06:39:04.683Z",
  "response": {
	"uin": "989768897876565",
    "message": "Notification has been sent to the provided contact detail(s)"
  },
  "errors": null
}

Status Code : 200 (OK)

Failed Response

{
  "id": "mosip.resident.lostuin",
  "version": "v1",
  "responseTime": "2018-12-09T06:39:04.683Z",
  "response": {

  },
  "errors": [
    {
      "errorCode": "XXX-XXX-002",
      "errorMessage": "OTP Authentication Failed"
    }
  ]
}

Status Code : 200 (OK)

Failure details

Error Code
Error Message
Error Description

RES-SER-002

One or more input parameter is invalid or does not exist

RES-SER-003

Token generation failed

RES-SER-004

OTP validation failed

RES-SER-005

API resource is not available

RES-SER-006

Unable to access API resource

RES-SER-009

Invalid Input Parameter

RES-SER-014

Your request is not successful, please try again later.

RES-SER-015

Template exception

RES-SER-016

Template subject exception

RES-SER-017

Sending notification(Email and SMS) to resident failed.

RES-SER-020

Bad Request

RES-SER-021

Invalid APi response

RES-SER-SYS-001

System exception occured

RES-SER-SYS-002

IO Exception occured

RES-SER-SYS-003

JSON Processing Exception occured

POST /resident/v1/req/rid

This request will authenticate an Individual based on provided OTP and respond with RID. Notification will be sent to phone/email.

This API is yet to be developed.

Resource URL

https://mosip.io/resident/v1/req/rid

Resource details

Resource Details
Description

Response format

JSON

Requires Authentication

Yes

Request Body Parameters

Name
Required
Description
Default Value
Example

id

Y

API Id

mosip.resident.lostrid

version

Y

API version

v1

requestTime

Y

Time when Request was captured

2018-12-09T06:39:04.683Z

request: transactionID

Y

Transaction ID of request

dabed834-974f-11e9-bc42-526af7764f64

request: individualIdType

Y

Allowed Type of Individual ID - demo

demo

request: otp

Y

OTP

request: demographics

N

Demographic data of an Individual

Request Body

{
  "id": "mosip.resident.lostrid",
  "version": "v1",
  "requestTime": "2018-12-09T06:39:04.683Z",
  "request": {
  "transactionID": "dabed834-974f-11e9-bc42-526af7764f64",
  "individualIdType": "demo",
  "otp": "123456",
  "demographics": {
      "name": [
        {
          "language": "ara",
          "value": "ابراهيم بن علي"
        },
        {
          "language": "fra",
          "value": "Ibrahim Ibn Ali"
        }
      ],
      "gender": [
        {
          "language": "ara",
          "value": "الذكر"
        },
        {
          "language": "fra",
          "value": "mâle"
        }
      ],
      "postalCode": {
          "type": "10004"
        },
      "phone": {
          "type": "998989989809"
        },
      "email": {
          "type": "abcdefgh@xyz.com"
        }
    }
  }
}

Responses

Success Response

{
  "id": "mosip.resident.lostrid",
  "version": "v1",
  "responseTime": "2018-12-09T06:39:04.683Z",
  "response": {
    "rid": "989768897876565",
    "message": "Notification has been sent to the provided contact detail(s)"
  },
  "errors": null
}

Status Code : 200 (OK)

Failed Response:

{
  "id": "mosip.resident.lostrid",
  "version": "v1",
  "responseTime": "2018-12-09T06:39:04.683Z",
  "response": {

  },
  "errors": [
    {
      "errorCode": "XXX-XXX-002",
      "errorMessage": "OTP Authentication Failed"
    }
  ]
}

Status Code : 200 (OK)

Failure details

Error Code
Error Message
Error Description

RES-SER-001

RID not found

RES-SER-002

One or more input parameter is invalid or does not exist

RES-SER-003

Token generation failed

RES-SER-004

OTP validation failed

RES-SER-005

API resource is not available

RES-SER-006

Unable to access API resource

RES-SER-009

Invalid Input Parameter

RES-SER-014

Your request is not successful, please try again later.

RES-SER-015

Template exception

RES-SER-016

Template subject exception

RES-SER-017

Sending notification(Email and SMS) to resident failed.

RES-SER-020

Bad Request

RES-SER-021

Invalid APi response

RES-SER-SYS-001

System exception occured

RES-SER-SYS-002

IO Exception occured

RES-SER-SYS-003

JSON Processing Exception occured

POST /resident/v1/req/update-uin

This request will authenticate an Individual based on provided OTP and respond with RID after successfully placing update request to Registration Processor. Notification will be sent to phone/email.

Resource URL

https://mosip.io/resident/v1/req/update-uin

Resource details

Resource Details
Description

Response format

JSON

Requires Authentication

Yes

Request Body Parameters

Name
Required
Description
Default Value
Example

id

Y

API Id

mosip.resident.uin

version

Y

API version

v1

requestTime

Y

Time when Request was captured

2018-12-09T06:39:04.683Z

request: transactionID

Y

Transaction ID of request

dabed834-974f-11e9-bc42-526af7764f64

request: individualId

Y

UIN

9830872690593682

request: individualIdType

Y

Allowed Type of Individual ID - VID, UIN

UIN

request: otp

Y

OTP

request: demographics

Y

Demographic data of an Individual

Request Body

{ 
   "id":"mosip.resident.updateuin",
   "version":"v1",
   "requestTime":"2018-12-09T06:39:04.683Z",
   "request":{ 
      "transactionID":"dabed834-974f-11e9-bc42-526af7764f64",
      "individualId":"9830872690593682",
      "individualIdType":"UIN",
      "otp":"123456",
      "identityJson":"<base64 encoded identity json byte array>",
      "documents":[ 
         { 
            "name":"<document name same as present inside id json>",
            "value":"<base64 encoded document byte array>"
         },
         { 
            "name":"<document name same as present inside id json>",
            "value":"<base64 encoded document byte array>"
         }
      ]
   }
}

Responses

Success Response

{
  "id": "mosip.resident.updateuin",
  "version": "v1",
  "responseTime": "2018-12-09T06:39:04.683Z",
  "response": {
    "rid": "989768897876565",
    "message": "Notification has been sent to the provided contact detail(s)"
  },
  "errors": null
}

Status Code : 200 (OK)

Failed Response

{
  "id": "mosip.resident.uin",
  "version": "v1",
  "responseTime": "2018-12-09T06:39:04.683Z",
  "response": {

  },
  "errors": [
    {
      "errorCode": "XXX-XXX-002",
      "errorMessage": "OTP Authentication Failed"
    }
  ]
}

Status Code : 200 (OK)

Failure details

Error Code
Error Message
Error Description

RES-SER-002

One or more input parameter is invalid or does not exist

RES-SER-003

Token generation failed

RES-SER-004

OTP validation failed

RES-SER-005

API resource is not available

RES-SER-006

Unable to access API resource

RES-SER-009

Invalid Input Parameter

RES-SER-010

Invalid VID

RES-SER-011

Invalid UIN

RES-SER-013

Invalid UIN for given VID

RES-SER-014

Your request is not successful, please try again later.

RES-SER-015

Template exception

RES-SER-016

Template subject exception

RES-SER-017

Sending notification(Email and SMS) to resident failed.

RES-SER-018

Invalid individualId

RES-SER-020

Bad Request

RES-SER-021

Invalid APi response

RES-SER-022

Resident UIN update failed

RES-SER-023

Could not find the submitted document

RES-SER-SYS-001

System exception occured

RES-SER-SYS-002

IO Exception occured

RES-SER-SYS-003

JSON Processing Exception occured

POST /resident/v1/vid

This request will authenticate an Individual based on provided OTP and will generate VID for the respective UIN.

Resource URL

https://mosip.io/resident/v1/vid

Resource details

Resource Details
Description

Response format

JSON

Requires Authentication

Yes

Request Body Parameters

Name
Required
Description
Default Value
Example

id

Y

API Id

mosip.resident.vid

version

Y

API version

v1

requestTime

Y

Time when Request was captured

2018-12-09T06:39:04.683Z

request: transactionID

Y

Transaction ID of request

dabed834-974f-11e9-bc42-526af7764f64

request: vidType

Y

VID Type - PERPETUAL or TEMPORARY

request: individualId

Y

UIN

9830872690593682

request: individualIdType

Y

Allowed Type of Individual ID - UIN

UIN

request: otp

Y

OTP

Request Body

{
  "id": "mosip.resident.vid",
  "version": "v1",
  "requestTime": "2018-12-09T06:39:04.683Z",
  "request": {
  "transactionID": "dabed834-974f-11e9-bc42-526af7764f64",
  "individualId": "9830872690593682",
  "individualIdType": "UIN",
  "otp": "123456",
  "vidType": "PERPETUAL" 
  }
}

Status Code : 200 (OK)

Responses

Success Response

{
  "id": "mosip.resident.vid",
  "version": "v1",
  "responseTime": "2018-12-09T06:39:04.683Z",
   "response": {
    "vid": "989768897876565",
    "message": "Notification has been sent to the provided contact detail(s)"
  },
  "errors": null
}

Status Code : 200 (OK)

Failed Response

{
  "id": "mosip.resident.vid",
  "version": "v1",
  "responseTime": "2018-12-09T06:39:04.683Z",
  "response": {

  },
  "errors": [
    {
      "errorCode": "XXX-XXX-002",
      "errorMessage": "OTP Authentication Failed"
    }
  ]
}

Status Code : 200 (OK)

Failure details

Error Code
Error Message
Error Description

RES-SER-002

One or more input parameter is invalid or does not exist

RES-SER-003

Token generation failed

RES-SER-004

OTP validation failed

RES-SER-005

API resource is not available

RES-SER-006

Unable to access API resource

RES-SER-007

Exception while creating VID

RES-SER-009

Invalid Input Parameter

RES-SER-011

Invalid UIN

RES-SER-014

Your request is not successful, please try again later.

RES-SER-015

Template exception

RES-SER-016

Template subject exception

RES-SER-017

Sending notification(Email and SMS) to resident failed.

RES-SER-018

Invalid individualId

RES-SER-020

Bad Request

RES-SER-021

Invalid APi response

RES-SER-022

Resident UIN update failed

RES-SER-SYS-001

System exception occured

RES-SER-SYS-002

IO Exception occured

RES-SER-SYS-003

JSON Processing Exception occured

PATCH /resident/v1/vid/{vid}

This request will authenticate an Individual based on provided OTP and will revoke respective VID.

Resource URL

https://mosip.io/resident/v1/vid/9830872690593682

Resource details

Resource Details
Description

Response format

JSON

Requires Authentication

Yes

Request Body Parameters

Name
Required
Description
Default Value
Example

id

Y

API Id

mosip.resident.vidstatus

version

Y

API version

v1

requestTime

Y

Time when Request was captured

2018-12-09T06:39:04.683Z

request: transactionID

Y

Transaction ID of request

dabed834-974f-11e9-bc42-526af7764f64

request: vidStatus

Y

Status of VID - REVOKED

request: individualId

Y

VID

9830872690593682

request: individualIdType

Y

Allowed Type of Individual ID - VID

VID

request: otp

Y

OTP

Request Body

{
  "id": "mosip.resident.vidstatus",
  "version": "v1",
  "requestTime": "2018-12-09T06:39:04.683Z",
  "request": {
  "transactionID": "dabed834-974f-11e9-bc42-526af7764f64",
  "individualId": "9830872690593682",
  "individualIdType": "VID",
  "otp": "123456",
  "vidStatus": "REVOKED"
  }
}

Responses

Success Response

{
  "id": "mosip.resident.vidstatus",
  "version": "v1",
  "responseTime": "2018-12-09T06:39:04.683Z",
   "response": {
    "message": "Notification has been sent to the provided contact detail(s)"
  },
  "errors": null
}

Failed Response

{
  "id": "mosip.resident.vidstatus",
  "version": "v1",
  "responseTime": "2018-12-09T06:39:04.683Z",
  "response": {

  },
  "errors": [
    {
      "errorCode": "XXX-XXX-002",
      "errorMessage": "OTP Authentication Failed"
    }
  ]
}

Status Code : 200 (OK)

Failure details

Error Code
Error Message
Error Description

RES-SER-002

One or more input parameter is invalid or does not exist

RES-SER-003

Token generation failed

RES-SER-004

OTP validation failed

RES-SER-005

API resource is not available

RES-SER-006

Unable to access API resource

RES-SER-009

Invalid Input Parameter

RES-SER-010

Invalid VID

RES-SER-013

Invalid UIN for given VID

RES-SER-014

Your request is not successful, please try again later.

RES-SER-015

Template exception

RES-SER-016

Template subject exception

RES-SER-017

Sending notification(Email and SMS) to resident failed.

RES-SER-018

Invalid individualId

RES-SER-020

Bad Request

RES-SER-021

Invalid APi response

RES-SER-SYS-001

System exception occured

RES-SER-SYS-002

IO Exception occured

RES-SER-SYS-003

JSON Processing Exception occured

POST /resident/v1/req/auth-lock

This request will authenticate an Individual based on provided OTP and will lock provided authentication types.

Resource URL

https://mosip.io/resident/v1/req/auth-lock

Resource details

Resource Details
Description

Response format

JSON

Requires Authentication

Yes

Request Body Parameters

Name
Required
Description
Default Value
Example

id

Y

API Id

mosip.resident.authlock

version

Y

API version

v1

requestTime

Y

Time when Request was captured

2018-12-09T06:39:04.683Z

request: transactionID

Y

Transaction ID of request

dabed834-974f-11e9-bc42-526af7764f64

request: authType

Y

Allowed Type - demo,bio,bio-FMR,bio-IIR,bio-FID

request: individualId

Y

UIN

9830872690593682

request: individualIdType

Y

Allowed Type of Individual ID - UIN,VID

UIN

request: otp

Y

OTP

Request Body

{
  "id": "mosip.resident.authlock",
  "version": "v1",
  "requestTime": "2018-12-09T06:39:04.683Z",
  "request": {
  "transactionID": "dabed834-974f-11e9-bc42-526af7764f64",
  "individualId": "9830872690593682",
  "individualIdType": "UIN",
  "otp": "123456",
  "authType": ["bio-FMR","bio-FACE"]
  }
}

Responses

Success Response

{
  "id": "mosip.resident.authlock",
  "version": "v1",
  "responseTime": "2018-12-09T06:39:04.683Z",
   "response": {
    "status": "success",
    "message": "Notification has been sent to the provided contact detail(s)"
  },
  "errors": null
}

Status Code : 200 (OK)

Failed Response

{
  "id": "mosip.resident.authlock",
  "version": "v1",
  "responseTime": "2018-12-09T06:39:04.683Z",
  "response": {

  },
  "errors": [
    {
      "errorCode": "XXX-XXX-002",
      "errorMessage": "OTP Authentication Failed"
    }
  ]
}

Status Code : 200 (OK)

Failure details

Error Code
Error Message
Error Description

RES-SER-002

One or more input parameter is invalid or does not exist

RES-SER-003

Token generation failed

RES-SER-004

OTP validation failed

RES-SER-005

API resource is not available

RES-SER-006

Unable to access API resource

RES-SER-009

Invalid Input Parameter

RES-SER-010

Invalid VID

RES-SER-011

Invalid UIN

RES-SER-013

Invalid UIN for given VID

RES-SER-014

Your request is not successful, please try again later.

RES-SER-015

Template exception

RES-SER-016

Template subject exception

RES-SER-017

Sending notification(Email and SMS) to resident failed.

RES-SER-018

Invalid individualId

RES-SER-020

Bad Request

RES-SER-021

Invalid APi response

RES-SER-SYS-001

System exception occured

RES-SER-SYS-002

IO Exception occured

RES-SER-SYS-003

JSON Processing Exception occured

POST /resident/v1/req/auth-unlock

This request will authenticate an Individual based on provided OTP and will unlock provided locked authentication types.

Resource URL

https://mosip.io/resident/v1/req/auth-unlock

Resource details

Resource Details
Description

Response format

JSON

Requires Authentication

Yes

Request Body Parameters

Name
Required
Description
Default Value
Example

id

Y

API Id

mosip.resident.authunlock

version

Y

API version

v1

requestTime

Y

Time when Request was captured

2018-12-09T06:39:04.683Z

request: transactionID

Y

Transaction ID of request

dabed834-974f-11e9-bc42-526af7764f64

request: authType

Y

Allowed Type -demo,bio,bio-FMR,bio-IIR,bio-FID

request: individualId

Y

UIN

9830872690593682

request: individualIdType

Y

Allowed Type of Individual ID - UIN,VID

UIN

request: otp

Y

OTP

Request Body

{
  "id": "mosip.resident.authunlock",
  "version": "v1",
  "requestTime": "2018-12-09T06:39:04.683Z",
  "request": {
  "transactionID": "dabed834-974f-11e9-bc42-526af7764f64",
  "individualId": "9830872690593682",
  "individualIdType": "UIN",
  "otp": "123456",
  "authType": ["bio-FIR"]
  }
}

Responses

Success Response

{
  "id": "mosip.resident.authunlock",
  "version": "v1",
  "responseTime": "2018-12-09T06:39:04.683Z",
   "response": {
    "status": "success",
   "message": "Notification has been sent to the provided contact detail(s)"
  },
  "errors": null
}

Status Code : 200 (OK)

Failed Response

{
  "id": "mosip.resident.authunlock",
  "version": "v1",
  "responseTime": "2018-12-09T06:39:04.683Z",
  "response": {

  },
  "errors": [
    {
      "errorCode": "XXX-XXX-002",
      "errorMessage": "OTP Authentication Failed"
    }
  ]
}

Status Code : 200 (OK)

Failure details

Error Code
Error Message
Error Description

RES-SER-002

One or more input parameter is invalid or does not exist

RES-SER-003

Token generation failed

RES-SER-004

OTP validation failed

RES-SER-005

API resource is not available

RES-SER-006

Unable to access API resource

RES-SER-009

Invalid Input Parameter

RES-SER-010

Invalid VID

RES-SER-011

Invalid UIN

RES-SER-013

Invalid UIN for given VID

RES-SER-014

Your request is not successful, please try again later.

RES-SER-015

Template exception

RES-SER-016

Template subject exception

RES-SER-017

Sending notification(Email and SMS) to resident failed.

RES-SER-018

Invalid individualId

RES-SER-020

Bad Request

RES-SER-021

Invalid APi response

RES-SER-SYS-001

System exception occured

RES-SER-SYS-002

IO Exception occured

RES-SER-SYS-003

JSON Processing Exception occured

POST /resident/v1/req/auth-history

This request will authenticate an Individual based on provided OTP and respond with auth history. Notification will be sent to phone/email.

Resource URL

https://mosip.io/resident/v1/req/auth-history

Resource details

Resource Details
Description

Response format

JSON

Requires Authentication

Yes

Request Body Parameters

Name
Required
Description
Default Value
Example

id

Y

API Id

mosip.resident.authhistory

version

Y

API version

v1

requestTime

Y

Time when Request was captured

2018-12-09T06:39:04.683Z

request: transactionID

Y

Transaction ID of request

dabed834-974f-11e9-bc42-526af7764f64

request: individualId

Y

UIN

9830872690593682

request: individualIdType

Y

Allowed Type of Individual ID - UIN,VID

UIN

request: otp

Y

OTP

pageStart

N

Optional query param for paging

1

pageFetch

N

Optional query param for paging

1

Request Body

{
  "id": "mosip.resident.authhistory",
  "version": "v1",
  "requestTime": "2018-12-09T06:39:04.683Z",
  "request": {
  "transactionID": "dabed834-974f-11e9-bc42-526af7764f64",
  "individualId": "9830872690593682",
  "individualIdType": "UIN",
  "otp": "123456",
  "pageStart": "1",
   "pageFetch": "1"
  }
}

Responses

Success Response

{
  "id": "mosip.resident.authhistory",
  "version": "v1",
  "responseTime": "2018-12-09T06:39:04.683Z",
   "response": {
	"authHistory": [{authDetails1},{authDetails2}],   
    "message": "Notification has been sent to the provided contact detail(s)"
  },
  "errors": null
}

Status Code : 200 (OK)

Failed Response

{
  "id": "mosip.resident.authhistory",
  "version": "v1",
  "responseTime": "2018-12-09T06:39:04.683Z",
  "response": {

  },
  "errors": [
    {
      "errorCode": "XXX-XXX-002",
      "errorMessage": "OTP Authentication Failed"
    }
  ]
}

Status Code : 200 (OK)

Failure details

Error Code
Error Message
Error Description

RES-SER-002

One or more input parameter is invalid or does not exist

RES-SER-003

Token generation failed

RES-SER-004

OTP validation failed

RES-SER-005

API resource is not available

RES-SER-006

Unable to access API resource

RES-SER-009

Invalid Input Parameter

RES-SER-010

Invalid VID

RES-SER-011

Invalid UIN

RES-SER-013

Invalid UIN for given VID

RES-SER-014

Your request is not successful, please try again later.

RES-SER-015

Template exception

RES-SER-016

Template subject exception

RES-SER-017

Sending notification(Email and SMS) to resident failed.

RES-SER-018

Invalid individualId

RES-SER-020

Bad Request

RES-SER-021

Invalid APi response

RES-SER-SYS-001

System exception occured

RES-SER-SYS-002

IO Exception occured

RES-SER-SYS-003

JSON Processing Exception occured

Service Request Status Check API
e-UIN API
Re-print UIN API
Retrieve Lost UIN API - yet to be developed
Retrieve Lost RID API - yet to be developed
UIN Update API
VID Generate API
VID Revoke API
Lock Authentication Type API
Unlock Authentication Type API
Authentication History API