Pre Registration APIs
This section details about the service API in the Pre-Registration modules.
id, version and requesttime in request and responsetime in response bodies are optional fields and not consumed by pre-registration application unless defined. Though we need to pass these as part of the request, it should not be tested. Few of the error messages are intended for API consumer, who are mostly SI and developers. User friendly messages need to be mapped in the UI reference implementation.
API testing Prerequisites
Generate a Authorization Token by using following Kernel AuthManager APIs
To send an OTP /authmanager/sendOTPUsingPOST
To validate the OTP /authmanager/userIdOTPUsingPOST Once OTP get validate successfully you will get the Authorization token.
Use this Authorization token in the every request header of all pre-registration APIs.
Login Service (Public)
This service details used by Pre-Registration portal to authenticate user by sending OTP to the user, validating with userid and OTP.
POST /login/sendOtp
This request will send the OTP to the requested user in the preferred channel(sms/email)
Resource URL
https://{base_url}/preregistration/v1/login/sendOtp
Resource details
Resource Details | Description |
---|---|
Response format | JSON |
Requires Authentication | No |
Request Part Parameters
Name | Required | Description | Comment |
---|---|---|---|
id | Yes | id | mosip.pre-registration.login.sendotp |
version | Yes | version of the application | 1.0 |
requesttime | Yes | Time of the request | 2019-01-16T05:23:08.019Z |
request | Yes | Request for the application | |
request.userid | Yes | user id of the applicant(mobile number/email address) | 8907654778 |
For SMS
Request for SMS
Responses for SMS
Success Response
Status code: 200
Description: OTP sent successfully to specified channel
For Email
Request for Email
Responses for Email
Success Response
Status code: 200
Description: OTP sent successfully to specified channel
Failure Response
Status code: 200
Description: Invalid parameters
Other Failure details
Error Code | Error Message | Error Description |
---|---|---|
PRG_PAM_LGN_008 | Invalid Request userId received | if requested userId is empty or invalid |
PRG_PAM_CORE_001 | Request id is invalid | Invalid or empty Request Id |
PRG_PAM_CORE_002 | Request version is invalid | Invalid or empty Request version |
PRG_PAM_CORE_003 | Invalid request time | Empty Request time |
PRG_CORE_REQ_013 | Request date should be current date | If request date is not current date |
POST /login/validateOtp
This request will validate the OTP with respect to userid and provide the authorize token in the browser cookies.
Resource URL
https://{base_url}/preregistration/v1/login/validateOtp
Resource details
Resource Details | Description |
---|---|
Response format | JSON |
Requires Authentication | No |
Request Part Parameters
Name | Required | Description | Comment |
---|---|---|---|
id | Yes | id | mosip.pre-registration.login.useridotp |
version | Yes | version of the application | 1.0 |
requesttime | Yes | Time of the request | 2019-01-16T05:23:08.019Z |
request | Yes | Request for the application | |
request.userid | Yes | user id of the applicant (mobile number/email address) | 8907654778 |
request.OTP | Yes | received OTP | 345674 |
Request
Responses
Success Response
Status code: 200
Description: sms sent successfully
Failure Response
Status code: 200
Description: Invalid parameters
Other Failure details
Error Code | Error Message | Error Description |
---|---|---|
KER-ATH-003 | User Detail doesn't exist. | If userId is empty or invalid |
KER-OTV-003 | OTP can't be empty or null. | If otp field is empty or null |
KER-OTV-004 | OTP consists of only numeric characters. No other characters is allowed | If otp contains character other than numeric |
PRG_PAM_CORE_001 | Request id is invalid | Invalid or empty Request Id |
PRG_PAM_CORE_002 | Request version is invalid | Invalid or empty Request version |
PRG_PAM_CORE_003 | Invalid request time | Empty Request time |
PRG_CORE_REQ_013 | Request date should be current date | If request date is not current date |
PRG_PAM_LGN_013 | VALIDATION_UNSUCCESSFUL | If incorrect otp is entered |
PRG_PAM_LGN_014 | Token is not present in the header | When token does not come from kernel service in the header |
POST /login/invalidateToken
This request will invalidate the authorization token when force logout is done.
Resource URL
https://{base_url}/preregistration/v1/login/invalidateToken
Resource details
Resource Details | Description |
---|---|
Response format | JSON |
Requires Authentication | Yes |
Responses
Success Response
Status code: 200
Description: Token invalidated successfully
Failure Response
Status code: 200
Description: Token is not present in cookies
Other Failure details
Error Code | Error Message | Error Description |
---|---|---|
KER-ATH-008 | Token is not present in datastore, Please try with new token | If token is not present in datastore |
KER-ATH-006 | Cookies are empty | When no Cookie is passed in the header |
GET /login/config
This request will load the configuration parameters while loading the pre-registration portal page.
All the values are retrieving from the pre-registration config properties file. If any value get changed in the config properties file it will get reflected in the response of this API. Following mentioned response is the sample of that.
Resource URL
https://{base_url}/preregistration/v1/login/config
Resource details
Resource Details | Description |
---|---|
Response format | JSON |
Requires Authentication | No |
Responses
Success Response
Status code: 200
Description: Config parameter retrieved sucessfully
Other Failure details
Error Code | Error Message | Error Description |
---|---|---|
PRG_AUTH_012 | Config file not found in the config server | If config file is missing in the config server |
GET /login/refreshconfig
This request will reload the configuration parameters.
When ever there is change in the property file, then this rest end point should be called manually,so that the property get reflected.
Resource URL
https://{base_url}/preregistration/v1/login/refreshconfig
Resource details
Resource Details | Description |
---|---|
Response format | JSON |
Requires Authentication | No |
Responses
Success Response
Status code: 200
Description: Config parameter retrieved sucessfully
Other Failure details
Error Code | Error Message | Error Description |
---|---|---|
PRG_AUTH_012 | Config file not found in the config server | If config file is missing in the config server |
Demographic Service (public)
This service details used by Pre-Registration portal to maintain the demographic data by providing his/her basic details.
POST /applications
This request is used to create new pre-registration with demographic details, which generates pre-registration id and associates it with demographic details.
Resource URL
https://{base_url}/preregistration/v1/applications
Resource details
Resource Details | Description |
---|---|
Response format | JSON |
Requires Authentication | Yes |
Request Body Parameters
Name | Required | Description | Comment |
---|---|---|---|
id | Yes | Id of the application | mosip.pre-registration.demographic.create |
version | Yes | version of the application | 1.0 |
requesttime | Yes | Request time of the application | 2019-01-16T05:23:08.019Z |
request | Yes | Request for the application | |
request.langCode | Yes | primary language code | value will be derived from UI |
request.demographicDetails | Yes | demographicDetails of the applicant | |
request.demographicDetails.identity | Yes | identity of the applicant | |
request.demographicDetails.identity.gender | Yes | gender of the applicant | value will be derived from the domain metadata |
request.demographicDetails.identity.city | Yes | city of the applicant | value will be derived from the domain metadata |
request.demographicDetails.identity.phone | Optional | mobile number of the applicant | |
request.demographicDetails.identity.IDSchemaVersion | Optional | id schema version | 1 |
request.demographicDetails.identity.fullName | Yes | full name of the applicant | |
request.demographicDetails.identity.dateOfBirth | Yes | date of birth of the applicant | |
request.demographicDetails.identity.email | Optional | email Id of the applicant | |
request.demographicDetails.identity.province | Yes | province of the applicant | value will be derived from the domain metadata |
request.demographicDetails.identity.postalCode | Yes | postal code of the applicant | |
request.demographicDetails.identity.addressLine1 | Yes | address Line 1 of the applicant | |
request.demographicDetails.identity.addressLine2 | Optional | address Line 2 of the applicant | |
request.demographicDetails.identity.addressLine3 | Optional | address Line 3 of the applicant | |
request.demographicDetails.identity.region | Yes | region of the applicant | value will be derived from the domain metadata |
request.demographicDetails.identity.residenceStatus | Yes | residence status of the applicant | value will be derived from the domain metadata |
request.demographicDetails.identity.zone | Yes | zone of the applicant | value will be derived from the domain metadata |
request.demographicDetails.identity.referenceIdentityNumber | Yes | referenceIdentityNumber Number of the applicant |
Request
Responses
Success Response
Status code: 200
Description: Pre-Registration successfully Created
Failure Response
Status code: 200
Description: invalid or empty request id
Other Failure details
Error Code | Error Message | Error Description |
---|---|---|
PRG_PAM_CORE_002 | Request version is invalid | Invalid or empty Request version |
PRG_PAM_CORE_003 | Invalid request time | Empty Request time |
PRG_CORE_REQ_013 | Request date should be current date | If request date is not current date |
PRG_CORE_REQ_014 | Lang code is invalid | when language code is invalid or empty |
PRG_PAM_CORE_011 | encryption failed | encryption of demographic data failed |
PRG_PAM_APP_007 | json parsing is failed | demographic json parsing failed |
PRG_PAM_CORE_010 | hashing failed | demographic data hashing failed |
PRG_PAM_CORE_012 | decryption failes | decryption of demographic data failed |
PRG_PAM_APP_020 | Rest call to get prid failed | Service call to get Prid failed |
PRG_PAM_APP_021 | Duplicate key for prid | Failure of unique key constrains |
KER-IOV-005 | Missing input parameter - identity/fullName | If fullName attribute is not found in the identity request |
KER-IOV-005 | Missing input parameter - identity/dateOfBirth|identity/age | If dateOfBirth attribute is not found in the identity request |
KER-IOV-005 | Missing input parameter - identity/gender | If gender attribute is not found in the identity request |
KER-IOV-005 | Missing input parameter - identity/residenceStatus | If residenceStatus attribute is not found in the identity request |
KER-IOV-005 | Missing input parameter - identity/addressLine1 | If addressLine1 attribute is not found in the identity request |
KER-IOV-005 | Missing input parameter - identity/region | If region attribute is not found in the identity request |
KER-IOV-005 | Missing input parameter - identity/zone | If zone attribute is not found in the identity request |
KER-IOV-005 | Missing input parameter - identity/province | If province attribute is not found in the identity request |
KER-IOV-005 | Missing input parameter - identity/city | If city attribute is not found in the identity request |
KER-IOV-005 | Missing input parameter - identity/postalCode | If postalCode attribute is not found in the identity request |
KER-IOV-005 | Missing input parameter - identity/referenceIdentityNumber | If referenceIdentityNumber attribute is not found in the identity request |
KER-IOV-004 | Invalid input parameter - identity/phone | If phone attribute is found but it's value is empty or invalid |
KER-IOV-004 | Invalid input parameter - identity/email | If email attribute is found but it's value is empty or invalid |
KER-IOV-004 | Invalid input parameter - identity/fullName/{*}/language | If language code is empty or invalid in the specified position(*) inside fullName attribute |
KER-IOV-004 | Invalid input parameter - identity/dateOfBirth | If dateOfBirth value is empty or invalid |
KER-IOV-004 | Invalid input parameter - identity/gender/{*}/language | If language code is empty or invalid in the specified position(*) inside gender attribute |
KER-IOV-004 | Invalid input parameter - identity/gender/{*}/value | If value is empty or invalid in the specified position(*) inside gender attribute |
KER-IOV-004 | Invalid input parameter - identity/addressLine1/{*}/language | If language code is empty or invalid in the specified position(*) inside addressLine1 attribute |
KER-IOV-004 | Invalid input parameter - identity/addressLine2/{*}/language | If language code is empty or invalid in the specified position(*) inside addressLine2 attribute |
KER-IOV-004 | Invalid input parameter - identity/addressLine3/{*}/language | If language code is empty or invalid in the specified position(*) inside addressLine3 attribute |
KER-IOV-004 | Invalid input parameter - identity/residenceStatus/{*}/language | If language code is empty or invalid in the specified position(*) inside residenceStatus attribute |
KER-IOV-004 | Invalid input parameter - identity/region/{*}/language | If language code is empty or invalid in the specified position(*) inside region attribute |
KER-IOV-004 | Invalid input parameter - identity/region/{*}/value | If value is empty or invalid in the specified position(*) inside region attribute |
KER-IOV-004 | Invalid input parameter - identity/province/{*}/language | If language code is empty or invalid in the specified position(*) inside province attribute |
KER-IOV-004 | Invalid input parameter - identity/province/{*}/value | If value is empty or invalid in the specified position(*) inside province attribute |
KER-IOV-004 | Invalid input parameter - identity/city/{*}/language | If language code is empty or invalid in the specified position(*) inside city attribute |
KER-IOV-004 | Invalid input parameter - identity/city/{*}/value | If value is empty or invalid in the specified position(*) inside city attribute |
KER-IOV-004 | Invalid input parameter - identity/zone/{*}/language | If language code is empty or invalid in the specified position(*) inside zone attribute |
KER-IOV-004 | Invalid input parameter - identity/zone/{*}/value | If value is empty or invalid in the specified position(*) inside zone attribute |
KER-IOV-004 | Invalid input parameter - identity/postalCode | If postalCode is empty or invalid |
KER-IOV-004 | Invalid input parameter - identity/referenceIdentityNumber | If referenceIdentityNumber is empty or invalid |
PUT /applications/{preRegistrationId}
This request is used to update pre-registration's demographic details by providing pre-registration id in the path parameter and updated demographic details in request body.
Resource URL
https://{base_url}/preregistration/v1/applications/{preRegistrationId}
Resource details
Resource Details | Description |
---|---|
Response format | JSON |
Requires Authentication | Yes |
Request Path Parameters
Name | Required | Description | Comment |
---|---|---|---|
preRegistrationId | Yes | pre-registration id of the application | 64269837502851 |
Request Body Parameters
Name | Required | Description | Comment |
---|---|---|---|
id | Yes | Id of the application | mosip.pre-registration.demographic.create |
version | Yes | version of the application | 1.0 |
requesttime | Yes | Request time of the application | 2019-01-16T05:23:08.019Z |
request | Yes | Request for the application | |
request.langCode | Yes | primary language code | value will be derived from UI |
request.demographicDetails | Yes | demographicDetails of the applicant | |
request.demographicDetails.identity | Yes | identity of the applicant | |
request.demographicDetails.identity.gender | Yes | gender of the applicant | value will be derived from the domain metadata |
request.demographicDetails.identity.city | Yes | city of the applicant | value will be derived from the domain metadata |
request.demographicDetails.identity.phone | Optional | mobile number of the applicant | |
request.demographicDetails.identity.IDSchemaVersion | Optional | id schema version | 1 |
request.demographicDetails.identity.fullName | Yes | full name of the applicant | |
request.demographicDetails.identity.dateOfBirth | Yes | date of birth of the applicant | |
request.demographicDetails.identity.email | Optional | email Id of the applicant | |
request.demographicDetails.identity.province | Yes | province of the applicant | value will be derived from the domain metadata |
request.demographicDetails.identity.postalCode | Yes | postal code of the applicant | |
request.demographicDetails.identity.addressLine1 | Yes | address Line 1 of the applicant | |
request.demographicDetails.identity.addressLine2 | Optional | address Line 2 of the applicant | |
request.demographicDetails.identity.addressLine3 | Optional | address Line 3 of the applicant | |
request.demographicDetails.identity.region | Yes | region of the applicant | value will be derived from the domain metadata |
request.demographicDetails.identity.residenceStatus | Yes | residence status of the applicant | value will be derived from the domain metadata |
request.demographicDetails.identity.zone | Yes | zone of the applicant | value will be derived from the domain metadata |
request.demographicDetails.identity.referenceIdentityNumber | Yes | referenceIdentityNumber Number of the applicant |
Request
Responses
Success Response
Status code: 200
Description: Pre-Registration demographic details successfully updated
Failure Response
Status code: 200
Description: Invalid preregistration id(non-empty) or data is not found for that preregistration id.
Other Failure details
Error Code | Error Message | Error Description |
---|---|---|
PRG_PAM_CORE_001 | Request id is invalid | Invalid or empty Request Id |
PRG_PAM_CORE_002 | Request version is invalid | Invalid or empty Request version |
PRG_PAM_CORE_003 | Invalid request time | Empty Request time |
PRG_CORE_REQ_013 | Request date should be current date | If request date is not current date |
PRG_PAM_CORE_011 | encryption failed | encryption of demographic data failed |
PRG_PAM_APP_007 | json parsing is failed | demographic json parsing failed |
PRG_PAM_CORE_010 | hashing failed | demographic data hashing failed |
PRG_PAM_CORE_012 | decryption failes | decryption of demographic data failed |
PRG_PAM_APP_017 | Requested preregistration id does not belong to the user | when the user tries to access another user's demographic data |
KER-IOV-005 | Missing input parameter - identity/fullName | If fullName attribute is not found in the identity request |
KER-IOV-005 | Missing input parameter - identity/dateOfBirth|identity/age | If dateOfBirth attribute is not found in the identity request |
KER-IOV-005 | Missing input parameter - identity/gender | If gender attribute is not found in the identity request |
KER-IOV-005 | Missing input parameter - identity/residenceStatus | If residenceStatus attribute is not found in the identity request |
KER-IOV-005 | Missing input parameter - identity/addressLine1 | If addressLine1 attribute is not found in the identity request |
KER-IOV-005 | Missing input parameter - identity/region | If region attribute is not found in the identity request |
KER-IOV-005 | Missing input parameter - identity/zone | If zone attribute is not found in the identity request |
KER-IOV-005 | Missing input parameter - identity/province | If province attribute is not found in the identity request |
KER-IOV-005 | Missing input parameter - identity/city | If city attribute is not found in the identity request |
KER-IOV-005 | Missing input parameter - identity/postalCode | If postalCode attribute is not found in the identity request |
KER-IOV-005 | Missing input parameter - identity/referenceIdentityNumber | If referenceIdentityNumber attribute is not found in the identity request |
KER-IOV-004 | Invalid input parameter - identity/phone | If phone attribute is found but it's value is empty or invalid |
KER-IOV-004 | Invalid input parameter - identity/email | If email attribute is found but it's value is empty or invalid |
KER-IOV-004 | Invalid input parameter - identity/fullName/{*}/language | If language code is empty or invalid in the specified position(*) inside fullName attribute |
KER-IOV-004 | Invalid input parameter - identity/dateOfBirth | If dateOfBirth value is empty or invalid |
KER-IOV-004 | Invalid input parameter - identity/gender/{*}/language | If language code is empty or invalid in the specified position(*) inside gender attribute |
KER-IOV-004 | Invalid input parameter - identity/gender/{*}/value | If value is empty or invalid in the specified position(*) inside gender attribute |
KER-IOV-004 | Invalid input parameter - identity/addressLine1/{*}/language | If language code is empty or invalid in the specified position(*) inside addressLine1 attribute |
KER-IOV-004 | Invalid input parameter - identity/addressLine2/{*}/language | If language code is empty or invalid in the specified position(*) inside addressLine2 attribute |
KER-IOV-004 | Invalid input parameter - identity/addressLine3/{*}/language | If language code is empty or invalid in the specified position(*) inside addressLine3 attribute |
KER-IOV-004 | Invalid input parameter - identity/residenceStatus/{*}/language | If language code is empty or invalid in the specified position(*) inside residenceStatus attribute |
KER-IOV-004 | Invalid input parameter - identity/region/{*}/language | If language code is empty or invalid in the specified position(*) inside region attribute |
KER-IOV-004 | Invalid input parameter - identity/region/{*}/value | If value is empty or invalid in the specified position(*) inside region attribute |
KER-IOV-004 | Invalid input parameter - identity/province/{*}/language | If language code is empty or invalid in the specified position(*) inside province attribute |
KER-IOV-004 | Invalid input parameter - identity/province/{*}/value | If value is empty or invalid in the specified position(*) inside province attribute |
KER-IOV-004 | Invalid input parameter - identity/city/{*}/language | If language code is empty or invalid in the specified position(*) inside city attribute |
KER-IOV-004 | Invalid input parameter - identity/city/{*}/value | If value is empty or invalid in the specified position(*) inside city attribute |
KER-IOV-004 | Invalid input parameter - identity/zone/{*}/language | If language code is empty or invalid in the specified position(*) inside zone attribute |
KER-IOV-004 | Invalid input parameter - identity/zone/{*}/value | If value is empty or invalid in the specified position(*) inside zone attribute |
KER-IOV-004 | Invalid input parameter - identity/postalCode | If postalCode is empty or invalid |
KER-IOV-004 | Invalid input parameter - identity/referenceIdentityNumber | If referenceIdentityNumber is empty or invalid |
GET /applications/{preRegistrationId}
This request is used to retrieve Pre-Registration demographic data by pre-Registration id provided in request path parameter.
Resource URL
https://{base_url}/preregistration/v1/applications/{preRegistrationId}
Resource details
Resource Details | Description |
---|---|
Response format | JSON |
Requires Authentication | Yes |
Request Path Parameters
Name | Required | Description | Comment |
---|---|---|---|
preRegistrationId | Yes | Id of the application | 32042841521591 |
Responses
Success Response:
Status code: 200
Description: Demographic data successfully retrieved
Failure Response
Status code: '200'
Description: No data found for the requested pre-registration id(non-empty).
Other Failure details
Error Code | Error Message | Error Description |
---|---|---|
PRG_PAM_CORE_010 | hashing failed | demographic data hashing failed |
PRG_PAM_CORE_012 | decryption failes | decryption of demographic data failed |
PRG_PAM_APP_007 | json parsing is failed | demographic json parsing failed |
PRG_PAM_APP_017 | Requested preregistration id does not belong to the user | when the user tries to access another user's demographic data |
GET /applications/status/{preRegistrationId}
This request is used to retrieve pre-registration application status by providing the pre-registration id in request path parameter.
Resource URL
https://{base_url}/preregistration/v1/applications/status/{preRegistrationId}
Resource details
Resource Details | Description |
---|---|
Response format | JSON |
Requires Authentication | Yes |
Request Path Parameter
Name | Required | Description | Comment |
---|---|---|---|
preRegistrationId | Yes | Id of the application | 62076019780925 |
Responses
Success Response
Status code: 200
Description: All applications status fetched successfully
Failure Response
Status code: 200
Description: No data found for the requested pre-registration id(non-empty).
Other Failure details
Error Code | Error Message | Error Description |
---|---|---|
PRG_PAM_CORE_010 | hashing failed | demographic data hashing failed |
PRG_PAM_APP_017 | Requested preregistration id does not belong to the user | when the user tries to access another user's demographic data |
GET /applications
This request is used to retrieve all Pre-Registration id, Full name in both language, Status Code, Document details(Only for Proof Of Address), Appointment details and Postal Code by user id from authorization token.
Without pagination
if pageIndex parameter is not passed as query param, then all the demographic data for the user will be retrieved without applying pagination mechanism.
Resource URL
https://{base_url}/preregistration/v1/applications
Resource details
Resource Details | Description |
---|---|
Response format | JSON |
Requires Authentication | Yes |
Responses
Success Response
Status code: 200
Description: All applications fetched successfully
Failure Response
Status code: 200
Description: No record found for the requested user id.
Other Failure details
Error Code | Error Message | Error Description |
---|---|---|
PRG_PAM_CORE_010 | hashing failed | demographic data hashing failed |
PRG_PAM_CORE_012 | decryption failed | decryption of demographic data failed |
PRG_PAM_APP_007 | json parsing is failed | demographic json parsing failed |
PRG_PAM_APP_018 | Failed to read the identity json from the server | If the configured identity json file is unreachable |
With pagination
If pageIndex parameter is passed as query param, then all the demographic data for the user will be retrieved in terms of pages.
PageSize parameter is configurable.
PageIndex is by default 0 if no value is passed for query param.
Resource URL
https://{base_url}/preregistration/v1/applications?pageIndex=0
Resource details
Resource Details | Description |
---|---|
Response format | JSON |
Requires Authentication | Yes |
Request Query Parameter
Name | Required | Description | Comment |
---|---|---|---|
pageIndex | Yes | page index of the application | 0(By default) |
Responses
Success Response
Status code: 200
Description: All applications fetched successfully
Failure Response
Status code: 200
Description: No record found for the requested user id.
Other Failure details
Error Code | Error Message | Error Description |
---|---|---|
PRG_PAM_APP_016 | no record found for the requested page index | if there is no more demographic data found for the requested page index |
PRG_PAM_APP_019 | Invalid page index value | If page index value is invalid |
PRG_PAM_APP_015 | Page size must be greater than zero | if page size is invalid or if it is defined 0 or less than 0 in config |
PRG_PAM_CORE_010 | hashing failed | demographic data hashing failed |
PRG_PAM_CORE_012 | decryption failed | decryption of demographic data failed |
PRG_PAM_APP_007 | json parsing is failed | demographic json parsing failed |
PRG_PAM_APP_018 | Failed to read the identity json from the server | If the configured identity json file is unreachable |
DELETE /applications/{preRegistrationId}
This request is used to discard the entire pre-registration details based pre-registration id provided in request path parameter.
Resource URL
https://{base_url}/preregistration/v1/applications/{preRegistrationId}
Resource details
Resource Details | Description |
---|---|
Response format | JSON |
Requires Authentication | Yes |
Request Path Parameters
Name | Required | Description | Comment |
---|---|---|---|
preRegistrationId | Yes | pre-registration id of the application | 29605371807216 |
Responses
Success Response
Status code: 200
Description: Deletion of individual is successfully
Failure Response
Status code: 200
Description: No data found for the requested pre-registration id(non-empty)
Other Failure details
Error Code | Error Message | Error Description |
---|---|---|
PRG_PAM_APP_003 | delete operation is not allowed | Deletion of Preregistration fails if its status is neither pending appointment nor booked |
PRG_PAM_DOC_016 | failed to delete the booking | If Booking data is failed to delete |
PRG_PAM_APP_004 | failed to delete the pre-registration data | If Preregistration data is failed to delete |
PRG_PAM_APP_017 | Requested preregistration id does not belong to the user | when the user tries to access another user's demographic data |
Document Service (public)
This service enables Pre-Registration portal to request for uploading the document for a particular pre-registration. If any one upload file greater than specified size which is allowed by ngnix config; it will give 413 Request Entity Too Large error.
POST /documents/{preRegistrationId}
This request is used to upload document with the metadata which include document category code, document type code and document format for a pre-registration Id.
Document category code, document type code and language code are derived from kernel master data. Specification for the same can be found in Document APIs.
URL:
For valid Document category code refer below GET method for respective language code : /documentcategories/{langcode}
For valid Document type code refer below GET method for respective language and document category code: /documenttypes/{documentcategorycode}/{langcode}
Resource URL
https://{base_url}/preregistration/v1/documents/{preRegistrationId}
Resource details
Resource Details | Description |
---|---|
Response format | JSON |
Requires Authentication | Yes |
Request Path Parameters
Name | Required | Description | Comment |
---|---|---|---|
preRegistrationId | Yes | Pre-registration id of the application | 32042841521591 |
Request Part Parameters
Name | Required | Description | Comment |
---|---|---|---|
file | Yes | Document which we need to upload |
Request Part (Document request) Parameters
Name | Required | Description | Comment |
---|---|---|---|
id | Yes | Id of the application | mosip.pre-registration.document.upload |
version | Yes | version of the application | 1.0 |
requesttime | Yes | Request tme of the application | 2019-01-16T05:23:08.019Z |
request | Yes | Request for the application | |
request.docCatCode | Yes | Document category code | POA |
request.docTypCode | Yes | Document type code | RNC |
request.langCode | Yes | Language code of the application | fra |
Request
Responses
Success Response
Status code: 200
Description: Document uploaded successfully
Failure Response
Status code: 200
Description: Invalid document format supported
Other Failure details
Error Code | Error Message | Error Description |
---|---|---|
PRG_PAM_CORE_001 | Request id is invalid | Invalid or empty Request Id |
PRG_PAM_CORE_002 | Request version is invalid | Invalid or empty Request version |
PRG_PAM_CORE_003 | Invalid request time | Empty Request time |
PRG_CORE_REQ_013 | Request date should be current date | If request date is not current date |
PRG_PAM_DOC_007 | Document exceeding permitted size | when uploaded document size is exceeding the configured size |
PRG_CORE_REQ_018 | Document Catagory code is invalid | empty or invalid document category code |
PRG_CORE_REQ_017 | Document type code is invalid | empty or invalid document type code |
PRG_CORE_REQ_014 | Language code is invalid | If language code is empty or invalid |
PRG_PAM_CORE_011 | encryption failed | encryption of document data failed |
PRG_PAM_DOC_015 | Json exception | document request json parsing failed |
PRG_PAM_CORE_010 | hashing failed | document data hashing failed |
PRG_PAM_DOC_010 | Document virus scan failed | virus scan of uploaded document is failed |
PRG_PAM_APP_005 | No data found for the requested pre-registration id | invalid preregistration id or data is not found for that preregistration id |
PRG_PAM_DOC_012 | Document table not accessible | access to document table fails |
PRG_PAM_DOC_009 | Document upload failed | if the document & document details are failed to store |
PRG_PAM_APP_017 | Requested preregistration id does not belong to the user | when the user tries to access another user's demographic data |
PUT /documents/{preRegistrationId}
This request is used to copy the document from source pre-registration id to destination pre-registration id with the specified document category code.
Resource URL
https://{base_url}/preregistration/v1/documents/{preRegistrationId}?catCode={doc_cat_code}&sourcePreId={preRegistrationId}
Resource details
Resource Details | Description |
---|---|
Response format | JSON |
Requires Authentication | Yes |
Request Path Parameters
Name | Required | Description | Comment |
---|---|---|---|
preRegistrationId | Yes | Destination Pre-registration id of the application | 67531403498547 |
Request Query Parameters
Name | Required | Description | Comment |
---|---|---|---|
catCode | Yes | Document category code | POA |
sourcePreId | Yes | Source Pre-registration id of the application | 97285429827016 |
Responses
Success Response
Status code: 200
Description: Document successfully copied
Failure Response
Status code: 200
Description: If Document has not been uploaded for the source pre-registration Id(non-empty)
Other Failure details
Error Code | Error Message | Error Description |
---|---|---|
PRG_CORE_REQ_001 | request parameter is missing | If source or destination preregistration id is empty |
PRG_CORE_REQ_017 | Catagory code is invalid | if document category code is not POA |
PRG_PAM_APP_005 | No data found for the requested pre-registration id | If source preregistration id or destination preregistration id is invalid(non-empty) or no preregistration data found for any of the preregistration id |
PRG_PAM_DOC_012 | Document table not accessible | access to document table fails |
PRG_PAM_DOC_009 | Document upload failed | if the document & document details are failed to store |
PRG_PAM_DOC_011 | Document copy failed from source to destination | when document is not copied from source to destination preregistration id |
PRG_CORE_REQ_010 | hashing failed | document data hashing failed |
PRG_PAM_APP_017 | Requested preregistration id does not belong to the user | when the user tries to access another user's demographic data |
GET /documents/preregistration/{preRegistrationId}
This request used to retrieve all documents metadata associated with particular pre-registration.
Resource URL
https://{base_url}/preregistration/v1/documents/preregistration/{preRegistrationId}
Resource details
Resource Details | Description |
---|---|
Response format | JSON |
Requires Authentication | Yes |
Request Path Parameters
Name | Required | Description | Comment |
---|---|---|---|
preRegistrationId | Yes | Pre-registration id of the application | 97285429827016 |
Responses
Success Response
Status code: 200
Description: Documents retrieved successfully
Failure Response
Status code: 200
Description: if pre-registration id is invalid(non-empty)
Other Failure details
Error Code | Error Message | Error Description |
---|---|---|
PRG_PAM_DOC_012 | Document table not accessible | access to document table fails |
PRG_PAM_DOC_005 | Failed to fetch from File System server | if the document is failed to be fetched from file system |
PRG_PAM_CORE_012 | decryption failes | decryption of document data failed |
PRG_PAM_CORE_010 | hashing failed | document data hashing failed |
PRG_PAM_APP_017 | Requested preregistration id does not belong to the user | when the user tries to access another user's demographic data |
PRG_PAM_DOC_005 | Documents is not found for the requested pre-registration id | when the document is not uploaded for the preregistration id |
PRG_PAM_APP_005 | No data found for the requested pre-registration id | When the application is deleted and trying to fetch the document of that pre-registration-id |
GET /documents/{documentId}?preRegistrationId={preRegistrationId}
This request used to retrieve the document for a particular document id from the File System server.
Resource URL
https://{base_url}/preregistration/v1/documents/{documentId}?preRegistrationId={preRegistrationId}
Resource details
Resource Details | Description |
---|---|
Response format | JSON |
Requires Authentication | Yes |
Request Path Parameters
Name | Required | Description | Comment |
---|---|---|---|
documentId | Yes | document id of the application | 0748c439-4f83-11e9-ae3b-7b0aa1318f48 |
Request Query Parameters
Name | Required | Description | Comment |
---|---|---|---|
preRegistrationId | Yes | pre-registration id of the application | 74843948119371 |
Responses
Success Response
Status code: 200
Description: Document successfully retrieved
Failure Response
Status code: 200
Description: if pre-registration id is invalid(non-empty)
Other Failure details
Error Code | Error Message | Error Description |
---|---|---|
PRG_PAM_DOC_012 | Document table not accessible | access to document table fails |
PRG_PAM_DOC_005 | Failed to fetch from File System server | if the document is failed to be fetched from file system |
PRG_CORE_REQ_012 | decryption failed | decryption of document data failed |
PRG_CORE_REQ_010 | hashing failed | document data hashing failed |
PRG_PAM_APP_017 | Requested preregistration id does not belong to the user | when the user tries to access another user's demographic data |
PRG_PAM_DOC_022 | DocumentId is not belongs to the pre-registration Id | If document id is not related to the pre-registration id or if document is not found for the pre-registration id |
DELETE /documents/preregistration/{preRegsitrationId}
This request used to delete all the documents which are associated with requested pre-registration id.
Resource URL
https://{base_url}/preregistration/v1/documents/preregistration/{preRegistrationId}
Resource details
Resource Details | Description |
---|---|
Response format | JSON |
Requires Authentication | Yes |
Request Path Parameters
Name | Required | Description | Comment |
---|---|---|---|
preRegsitrationId | Yes | pre-registration id of the application | 37802950913289 |
Responses
Success Response
Status code: 200
Description: Documents successfully deleted
Failure Response
Status code: 200
Description: if the pre-registration id is invalid(non-empty)
Other Failure details
Error Code | Error Message | Error Description |
---|---|---|
PRG_PAM_DOC_006 | Documents failed to delete | if the document & document details are failed to delete |
PRG_PAM_DOC_012 | Document table not accessible | access to document table fails |
PRG_PAM_APP_017 | Requested preregistration id does not belong to the user | when the user tries to access another user's demographic data |
PRG_PAM_DOC_005 | Documents is not found for the requested pre-registration id | If document is not uploaded for the pre-registration id |
PRG_PAM_APP_005 | No data found for the requested pre-registration id | When the application is deleted and trying to fetch the document of that pre-registration-id |
DELETE /documents/{documentId}?preRegistrationId={preRegistrationId}
This request used to delete the document for a particular document id from database and File System server.
Resource URL
https://{base_url}/preregistration/v1/documents/{documentId}?preRegistrationId={preRegistrationId}
Resource details
Resource Details | Description |
---|---|
Response format | JSON |
Requires Authentication | Yes |
Request Path Parameters
Name | Required | Description | Comment |
---|---|---|---|
documentId | Yes | document id of the application | 0748c439-4f83-11e9-ae3b-7b0aa1318f48 |
Request Query Parameters
Name | Required | Description | Comment |
---|---|---|---|
preRegistrationId | Yes | pre-registration id of the application | 74843948119371 |
Responses
Success Response
Status code: 200
Description: Document successfully deleted
Failure Response
Status code: 200
Description: if the pre-registration id is invalid(non-empty)
Other Failure details
Error Code | Error Message | Error Description |
---|---|---|
PRG_PAM_DOC_006 | Documents failed to delete | if the document & document details are failed to delete |
PRG_PAM_DOC_012 | Document table not accessible | access to document table fails |
PRG_PAM_APP_017 | Requested preregistration id does not belong to the user | when the user tries to access another user's demographic data |
PRG_PAM_DOC_022 | DocumentId is not belongs to the pre-registration Id | If document id is not related to the pre-registration id or if document is not found for the pre-registration id |
DataSync Service (External)
This service enables Pre-Registration to a registration client, request to retrieve all pre-registration ids based on registration client id, appointment date and an user type.
POST /sync
This request is used by registration client to retrieve all the pre-registration Ids by the date range of appointment done.
Resource URL
https://{base_url}/preregistration/v1/sync
Resource details
Resource Details | Description |
---|---|
Response format | JSON |
Requires Authentication | Yes |
Request Body Parameters
Name | Required | Description | Comment |
---|---|---|---|
id | Yes | Id of the application | mosip.pre-registration.datasync |
version | Yes | version of the application | 1.0 |
requesttime | Yes | Request time of the application | 2019-01-16T05:23:08.019Z |
request | Yes | Request for the application | |
request.registrationCenterId | Yes | Registration Center Id for which the data is required | 10001 |
request.fromDate | Yes | From date of the appointment | 2019-02-09 |
request.toDate | Yes | To date of the appointment | 2019-02-12 |
Request
Responses
Success Response
Status code: 200
Description: All Pre-Registration Ids fetched successfully
Failure Response
Status code: 200
Description: If appointment is not booked under the registration center and requested date range.
Other Failure details
Error Code | Error Message | Error Description |
---|---|---|
PRG_PAM_CORE_001 | Request id is invalid | Invalid or empty Request Id |
PRG_PAM_CORE_002 | Request version is invalid | Invalid or empty Request version |
PRG_PAM_CORE_003 | Invalid request time | Empty Request time |
PRG_CORE_REQ_013 | Request date should be current date | If request date is not current date |
PRG_DATA_SYNC_009 | registration center id is invalid | Empty registration center Id |
PRG_CORE_REQ_013 | Request date should be current date | when the date is not current date |
PRG_DATA_SYNC_007 | Demographic record failed to fetch | when rest service to demographic service fails |
PRG_DATA_SYNC_016 | booking data not found | when rest service to booking service fails |
PRG_CORE_REQ_019 | Invalid date time format | If from date or to date is invalid |
PRG_CORE_REQ_020 | From date is greater than To date | If from date is greater than to date |
POST /sync/consumedPreRegIds
This request is used by registration processor, to retrieve all processed pre-registration ids and store in pre-registration database so that after batch jon run , job will delete records from main table and move to history table(consumed).
Resource URL
https://{base_url}/preregistration/v1/sync/consumedPreRegIds
Resource details
Resource Details | Description |
---|---|
Response format | JSON |
Requires Authentication | Yes |
Request Body Parameters
Name | Required | Description | Comment |
---|---|---|---|
id | Yes | Id of the application | mosip.pre-registration.datasync.store |
version | Yes | version of the application | 1.0 |
requesttime | Yes | Request time of the application | 2019-01-16T05:23:08.019Z |
request | Yes | Request for the application | |
request.preRegistrationIds | Yes | List of Preregistration Ids | 42973267563920 |
Request
Responses
Success Response
Status code: 200
Description: Consumed Pre-Registrations saved
Failure Response
Status code: 200
Description: No pre-registration ids passed in request body or all the preregistration ids are invalid
Other Failure details
Error Code | Error Message | Error Description |
---|---|---|
PRG_PAM_CORE_001 | Request id is invalid | Invalid or empty Request Id |
PRG_PAM_CORE_002 | Request version is invalid | Invalid or empty Request version |
PRG_PAM_CORE_003 | Invalid request time | Empty Request time |
PRG_CORE_REQ_013 | Request date should be current date | If request date is not current date |
PRG_DATA_SYNC_007 | Demographic record failed to fetch | when rest service to demographic service fails |
GET /sync/{preRegistrationId}
This request is used by registration client to retrieve particular pre-registration data based on a pre-registration id.
ID.json will include both demographic and uploaded document metadata content.
Resource URL
https://{base_url}/preregistration/v1/sync/{preRegistrationId}
Resource details
Resource Details | Description |
---|---|
Response format | JSON |
Requires Authentication | Yes |
Request Path Parameters
Name | Required | Description | Comment |
---|---|---|---|
preRegistrationId | Yes | Pre Registration id | 41342175487213 |
Responses
Success Response
Status code: 200
Description: Data Sync records fetched
Failure Response
Status code: 200
Description: No demographic data exists for the requested pre-registration id or if the pre-registration id is invalid(non-empty)
Other Failure details
Error Code | Error Message | Error Description |
---|---|---|
PRG_BOOK_RCI_013 | booking data not found | If appointment is not booked against the preregistration id |
PRG_DATA_SYNC_007 | Demographic record failed to fetch | when rest service to demographic service fails |
PRG_DATA_SYNC_016 | booking data not found | when rest service to booking service fails |
PRG_DATA_SYNC_005 | Unable to create zip file | If any error occurs while creating the zip file bytes |
PRG_DATA_SYNC_014 | file IO exception | File system exception |
PRG_DATA_SYNC_006 | unable to fetch the document | when rest service to document service fails |
Booking Service (Public)
This service details used by Pre-Registration portal to book an appointment by providing his/her basic appointment details.
GET /appointment/availability/sync
This request is used to synchronize booking slots availability table with master data.
Resource URL
https://{base_url}/preregistration/v1/appointment/availability/sync
Resource details
Resource Details | Description |
---|---|
Response format | JSON |
Requires Authentication | Yes |
Responses
Success Response
Status code: 200
Description: Master Data Sync is successful
Other Failure details
Error Code | Error Message | Error Description |
---|---|---|
PRG_BOOK_RCI_015 | No available slots found for specified registration center | If no slots are available in the specified registration center |
PRG_BOOK_RCI_016 | Availablity table not accessible | access to availability table fails |
PRG_BOOK_RCI_034 | Json processing exception | Json parse exception while sending notification |
PRG_BOOK_RCI_033 | Notification service call failed | Notification service call fail |
PRG_BOOK_RCI_020 | Master data not found | Master date service call fail |
POST /appointment/{preRegistrationId}
This request is used to book an registration center. If the appointment data exists for the requested pre-registration id, it will cancel it and update the new appointment data. If no appointment data then it will book an appointment for specified registration center and time slot.
Resource URL
https://{base_url}/preregistration/v1/appointment/{preRegistrationId}
Resource details
Resource Details | Description |
---|---|
Response format | JSON |
Requires Authentication | Yes |
Request Path Parameters
Name | Required | Description | Comment |
---|---|---|---|
preRegsitrationId | Yes | pre-registration id of the application | 37802950913289 |
Request Body Parameters
Name | Required | Description | Comment |
---|---|---|---|
id | Yes | Id of the application | mosip.pre-registration.booking.book |
version | Yes | version of the application | 1.0 |
requesttime | Yes | Request time of the application | 2019-01-16T05:23:08.019Z |
request | Yes | Request for the application | |
request.registration_center_id | Yes | Registration center Id | 10005 |
request.appointment_date | Yes | Date of the appointment | 2019-01-19 |
request.time_slot_from | Yes | Time Slot From | 12:15:00 |
request.time_slot_to | Yes | Time Slot To | 12:28:00 |
Request
Responses
Success Response
Status code: 200
Description: Appointment booked successfully
Failure Response
Status code: 200
Description: If demographic data not found for the preregistration id or if Pre Registration Id is invalid(non-empty).
Failure Response
Status code: 200
Description: Slot availability not found for selected time.
Other Failure details
Error Code | Error Message | Error Description |
---|---|---|
PRG_PAM_CORE_001 | Request id is invalid | Invalid or empty Request Id |
PRG_PAM_CORE_002 | Request version is invalid | Invalid or empty Request version |
PRG_PAM_CORE_003 | Invalid request time | Empty Request time |
PRG_CORE_REQ_013 | Request date should be current date | If request date is not current date |
PRG_BOOK_RCI_002 | Availability not found for the selected time | When availability not found for the requested registration center id or appointment date or time slot |
PRG_BOOK_RCI_003 | User has not selected time slot | If from time slot or to time slot is empty |
PRG_BOOK_RCI_005 | Booking table not found | access to appointment table fails |
PRG_BOOK_RCI_007 | Registration center id not entered | If registration center id is empty |
PRG_BOOK_RCI_008 | Booking date time not selected | If appointment date is empty |
PRG_BOOK_RCI_013 | Booking data not found | while rebooking, when the preregistration status is booked but appointment data not found in the database |
PRG_BOOK_RCI_015 | No available slots found for specified registration center | If no slots are available in the specified registration center |
PRG_BOOK_RCI_016 | Availablity table not accessible | access to availability table fails |
PRG_BOOK_RCI_024 | Availablity update failed | when appointment availability is failed to update |
PRG_BOOK_RCI_026 | Booking status cannot be altered | when we tend to modify the appointment details after the configured time span for rebook |
PRG_BOOK_RCI_028 | Failed to delete the pre-registration record | while rebooking, failed to delete old appointment details |
PRG_BOOK_RCI_031 | Invalid Booking Date Time found for preregistration id - 37513708391357 | If appointment date is past date and also when appointment date is present date but the appointment time is past. If the date format is other than YYYY-MM-DD. |
PRG_PAM_APP_017 | Requested preregistration id does not belong to the user | when the user tries to access another user's demographic data |
POST /appointment
This request is used to book mulitple registration centers. If the appointment data exists for the requested pre-registration ids, it will cancel it and update the new appointment data. If no appointment data then it will book an appointment for specified registration center and time slot.
Resource URL
https://{base_url}/preregistration/v1/appointment
Resource details
Resource Details | Description |
---|---|
Response format | JSON |
Requires Authentication | Yes |
Request Body Parameters
Name | Required | Description | Comment |
---|---|---|---|
id | Yes | Id of the application | mosip.pre-registration.booking.book |
version | Yes | version of the application | 1.0 |
requesttime | Yes | Request time of the application | 2019-01-16T05:23:08.019Z |
request | Yes | Request for the application | |
request.preRegistrationid | Yes | Preregistration Id | 51489749326453 |
request.registration_center_id | Yes | Registration center Id | 10001 |
request.appointment_date | Yes | Date of the appointment | 2019-04-22 |
request.time_slot_from | Yes | Time Slot From | 15:30:00 |
request.time_slot_to | Yes | Time Slot To | 15:45:00 |
Request
Responses
Success Response
Status code: 200
Description: Appointment booked successfully
Failure Response
Status code: 200
Description: If demographic data is not found for any of the preregistration id or if Pre Registration Id is invalid(non-empty).
Failure Response
Status code: 200
Description: Slot availability not found for selected time.
Other Failure details
Error Code | Error Message | Error Description |
---|---|---|
PRG_PAM_CORE_001 | Request id is invalid | Invalid or empty Request Id |
PRG_PAM_CORE_002 | Request version is invalid | Invalid or empty Request version |
PRG_PAM_CORE_003 | Invalid request time | Empty Request time |
PRG_CORE_REQ_013 | Request date should be current date | If request date is not current date |
PRG_BOOK_RCI_007 | Registration center id not entered | If registration center id is empty |
PRG_BOOK_RCI_008 | Booking date time not selected | If appointment date is empty |
PRG_BOOK_RCI_002 | Availability not found for the selected time | When availability not found for the requested registration center id or appointment date or time slot |
PRG_BOOK_RCI_016 | Availability table not accessible | access to availability table fails |
PRG_BOOK_RCI_005 | Booking table not found | access to appointment table fails |
PRG_BOOK_RCI_024 | Availability update failed | when appointment availability is failed to update |
PRG_BOOK_RCI_013 | Booking data not found | while rebooking, when the preregistration status is booked but appointment data not found in the database |
PRG_BOOK_RCI_026 | Booking status cannot be altered | when we tend to modify the appointment details after the configured time span for rebook |
PRG_BOOK_RCI_028 | Failed to delete the pre-registration record | while rebooking, failed to delete old appointment details |
PRG_BOOK_RCI_031 | Invalid Booking Date Time found for preregistration id - 37513708391357 | If appointment date is past date and also when appointment date is present date but the appointment time is past.If the date format is other than YYYY-MM-DD. |
PRG_PAM_APP_017 | Requested preregistration id does not belong to the user | when the user tries to access another user's demographic data |
PUT /appointment/{preRegistrationId}
This request used to cancel the appointment. Which will retrieve the appointment details for the specified pre-registration id,if appointment data exists update the availability for the slot by increasing the value and delete the record from the table and update the demographic record status "Pending_Appointment".
Resource URL
https://{base_url}/preregistration/v1/appointment/{preRegistrationId}
Resource details
Resource Details | Description |
---|---|
Response format | JSON |
Requires Authentication | Yes |
Responses
Success Response
Status code: 200
Description: Appointment cancelled successfully
Failure Response
Status code: 200
Description: Appointment cancellation failed.
Other Failure details
Error Code | Error Message | Error Description |
---|---|---|
PRG_BOOK_RCI_013 | Booking data not found | if appointment is not booked against the requested preregistration id |
PRG_BOOK_RCI_016 | Availability table not accessible | access to availability table fails |
PRG_BOOK_RCI_005 | Booking table not found | access to appointment table fails |
PRG_BOOK_RCI_024 | Availability update failed | when appointment availability is failed to update |
PRG_BOOK_RCI_026 | Booking status cannot be altered | when we tend to cancel the appointment details after the configured time span for cancel |
PRG_BOOK_RCI_018 | Appointment cannot be canceled | If status is other than booked |
PRG_PAM_APP_005 | No data found for the requested pre-registration id | If no demographic data found for the requested preregistration id or if the preregistration id is invalid(non-empty) |
PRG_PAM_APP_017 | Requested preregistration id does not belong to the user | when the user tries to access another user's demographic data |
GET /appointment/{preRegistrationId}
This request is to retrieve Pre-Registration appointment details by pre-Registration id.
Resource URL
https://{base_url}/preregistration/v1/appointment/{preRegistrationId}
Resource details
Resource Details | Description |
---|---|
Response format | JSON |
Requires Authentication | Yes |
Request Path Parameters
Name | Required | Description | Comment |
---|---|---|---|
preRegistrationId | Yes | Id of the application | 37802950913289 |
Responses
Success Response
Status code: 200
Description: Appointment details successfully retrieved
Failure Response
Status code: 200
Description: No Appointment record found for the specified pre-registration id
Other Failure details
Error Code | Error Message | Error Description |
---|---|---|
PRG_BOOK_RCI_013 | Booking data not found | if appointment is not booked against the requested preregistration id |
PRG_PAM_APP_017 | Requested preregistration id does not belong to the user | when the user tries to access another user's demographic data |
GET /appointment/availability/{registrationCenterId}
This request is used to retrieve all appointment slots available for booking based on the specified registration center id.
Resource URL
https://{base_url}/preregistration/v1/appointment/availability/{registrationCenterId}
Resource details
Resource Details | Description |
---|---|
Response format | JSON |
Requires Authentication | Yes |
Request Path Parameters
Name | Required | Description | Comment |
---|---|---|---|
registrationCenterId | Yes | Registration Center Id | 10004 |
Responses
Success Response
Status code: 200
Description: Availability details fetched successfully
Failure Response
Status code: 200
Description: No available slots found for specified registration center.
Other Failure details
Error Code | Error Message | Error Description |
---|---|---|
PRG_BOOK_RCI_016 | Availability table not accessible | access to availability table fails |
GET /appointment/preRegistrationId/{registrationCenterId}?from_date=:Date&to_date=:Date
This request is used to retrieve all pre-registration ids available for specified registration center and date range.
If toDate parameter value is not passed in the request, fromDate will be considered as toDate.
Resource URL
https://{base_url}/preregistration/v1/appointment/preRegistrationId/{registrationCenterId}?from_date=:Date&to_date=:Date
Resource details
Resource Details | Description |
---|---|
Response format | JSON |
Requires Authentication | Yes |
Request Path Parameters
Name | Required | Description | Comment |
---|---|---|---|
registrationCenterId | Yes | Registration Center Id | 10002 |
Request Query Parameters
Name | Required | Description | Comment |
---|---|---|---|
fromDate | Yes | From Date | 2019-02-12 |
toDate | Yes | To Date | 2019-06-15 |
Responses
Success Response
Status code: 200
Description: Availability details fetched successfully
Failure Response
Status code: 200
Description: No available slots found for specified registration center with date range.
Other Failure details
Error Code | Error Message | Error Description |
---|---|---|
PRG_BOOK_RCI_005 | Booking table not found | access to appointment table fails |
PRG_CORE_REQ_019 | Invalid date time format | If from date or to date is invalid |
PRG_CORE_REQ_020 | From date is greater than To date | If from date is greater than to date |
BatchJob Service (Private)
This service is used by Pre-Registration portal to update an expired pre-registration id and consumed pre-registration id.
Below are privileged APIs cannot be operate with individuals credentials.
PUT /expiredStatus
This request is used to update status of pre-registration ids appointment to expired status in database. Batch service will expire all the appointments from date before exceution date till the last execution date of batch job.
Resource URL
https://{base_url}/preregistration/v1/batch/expiredStatus
Resource details
Resource Details | Description |
---|---|
Response format | JSON |
Requires Authentication | Yes |
Responses
Success Response
Status code: 200
Description: Expired status updated successfully
Failure Response
Status code: 200
Description: No pre-registration record found to update expired status
Other Failure details
Error Code | Error Message | Error Description |
---|---|---|
PRG_PAM_BAT_004 | Demographic table not accessible | If data is not found for preRegistrationId |
PRG_PAM_BAT_005 | Reg appointment table not accessible | If Reg appointment table not accessible |
PUT /consumedStatus
This request is used to update the consumed status for all pre-Registration ids given by registration processor.
Resource URL
https://{base_url}/preregistration/v1/batch/consumedStatus
Resource details
Resource Details | Description |
---|---|
Response format | JSON |
Requires Authentication | Yes |
Responses
Success Response
Status code: 200
Description: Consumed status updated successfully
Failure Response
Status code: 200
Description: No pre-registration record found to update consumed status
Other Failure details
Error Code | Error Message | Error Description |
---|---|---|
PRG_PAM_BAT_004 | Demographic table not accessible | If data is not found for preRegistrationId |
PRG_PAM_BAT_005 | Reg appointment table not accessible | If Reg appointment table not accessible |
PRG_PAM_BAT_006 | Processed prereg list table not accessible | If Processed prereg list table not accessible |
PRG_PAM_BAT_007 | Document table not accessible | If document table not accessible |
PRG_PAM_BAT_008 | Reg appointment consumed table not accessible | If Reg appointment consumed table not accessible |
PRG_PAM_BAT_009 | Demographic consumed table not accessible | If Demographic consumed table not accessible |
PRG_PAM_BAT_010 | Document consumed table not accessible | If document consumed table not accessible |
Generate QR code service (public)
This service details used by Pre-Registration portal to generate QR Code.
POST qrCode/generate
This request is used to generate QR Code for the pre-registration acknowledgement.
Resource URL
https://{base_url}/preregistration/v1/qrCode/generate
Resource details
Resource Details | Description |
---|---|
Response format | JSON |
Requires Authentication | Yes |
Request Part Parameters
Name | Required | Description | Comment |
---|---|---|---|
id | Yes | Id of the application | mosip.pre-registration.qrcode.generate |
version | Yes | version of the application | 1.0 |
requesttime | Yes | Request time of the application | 2019-01-16T05:23:08.019Z |
request | Yes | Request for the application | |
request.value | Yes | Any string that you want to generate QR code |
Request
Below is the sample request with no validation for request value
Responses
Success Response
Status code: 200
Description: QR Code generated successfully
Failure Response
Status code: 200
Description: Failed to generate QR code
Other Failure details
Error Code | Error Message | Error Description |
---|---|---|
PRG_PAM_CORE_001 | Request id is invalid | Invalid or empty Request Id |
PRG_PAM_CORE_002 | Request version is invalid | Invalid or empty Request version |
PRG_PAM_CORE_003 | Invalid request time | Empty Request time |
PRG_CORE_REQ_013 | Request date should be current date | If request date is not current date |
PRG_PAM_CORE_004 | Request body is invalid | Invalid or empty Request body |
PRG_QRC_001 | File input output exception | when there is any input / output file operation issues |
PRG_CORE_REQ_013 | Request date should be current date | If request date is other than current date |
Notification Service (public)
This service details used by Pre-Registration portal to trigger notification via SMS or email.
POST notification/notify
This request is used to notify the pre-registration acknowledgement via Email and SMS.
Resource URL
https://{base_url}/preregistration/v1/notification/notify
Resource details
Resource Details | Description |
---|---|
Request format | multipart/form-data |
Response format | JSON |
Requires Authentication | Yes |
Request Part (NotificationRequestDTO) Parameters
Name | Required | Description | Comment |
---|---|---|---|
id | Yes | Id of the application | mosip.pre-registration.notification.notify |
version | Yes | version of the application | 1.0 |
requesttime | Yes | Request time of the application | 2019-01-16T05:23:08.019Z |
request | Yes | Request for the application | |
request.name | Yes | user name of the application | Sanober Noor |
request.preRegistrationId | Yes | Pre Registration of the application | 37802950913289 |
request.appointmentDate | Yes | Booking appointment date | 2019-01-18 |
request.appointmentTime | Yes | Booking appointment time | 12:02 |
request.mobNum | Optional(If emailID is non empty) | applicant mobile number | 9480456789 |
request.emailID | Optional(If mobNum is non empty) | applicant email Id |
|
request.additionalRecipient | Yes | additional recipient | It is a Boolean value(true/false). If it is true then request.mobNum and request.emailId get validated otherwise even though value is present for those values validation will not happen and it will get the mobile number/email address from the identity json from the database. |
request.isBatch | Yes | Required for batch job | It is a Boolean value(true/false). If it is true then it consider this call as a cancel appointment only otherwise it will considered as a normal notification call and validate appointment details. |
Request Part Parameters
Name | Required | Description | Comment |
---|---|---|---|
attachment | Yes | pdf file of acknowledgment page | 37802950913289.pdf |
langCode | Yes | language code whatever user choose while login | eng |
Request
Responses
Success Response
Status code: 200
Description: Email and sms request successfully submitted
Failure Response
Status code: 200
Description: Mobile number or Email Id is missing
Other Failure details
Error Code | Error Message | Error Description |
---|---|---|
PRG_PAM_CORE_001 | Request id is invalid | Invalid or empty Request Id |
PRG_PAM_CORE_002 | Request version is invalid | Invalid or empty Request version |
PRG_PAM_CORE_003 | Invalid request time | Empty Request time |
PRG_CORE_REQ_013 | Request date should be current date | If request date is not current date |
PRG_PAM_ACK_002 | Mandatory fields are missing | If isBatch field is null |
PRG_PAM_ACK_008 | Full name is not valid | If name field is invalid or empty |
PRG_PAM_ACK_009 | Appointment date is not valid | If appointmentDate field is invalid or empty |
PRG_PAM_ACK_010 | Appointment time is not valid | If appointmentTime field is invalid or empty |
PRG_PAM_APP_005 | No data found for the requested pre-registration id | If additionalRecipient is false and there will be no demographic data for requested pre-registration id |
PRG_CORE_REQ_013 | Request date should be current date | If request date is other than current date |
PRG_PAM_ACK_006 | Email is not valid | If additionalRecipient is true and email id pattern is invalid |
PRG_PAM_ACK_007 | Phone number is not valid | If additionalRecipient is true and phone number is invalid |
Transliteration Service (Public)
This service is used by Pre-Registration portal to transliterate given value from one language to another language. In this API transliteration is using IDB ICU4J library , so accuracy will be less.
POST /transliteration/transliterate
This request is used to transliterate from_Field_value to to_field_value based on given valid from_lang_code to to_lang_code.
Resource URL
https://{base_url}/preregistration/v1/transliteration/transliterate
Resource details
Resource Details | Description |
---|---|
Response format | JSON |
Requires Authentication | Yes |
Parameters
Name | Required | Description | Example |
---|---|---|---|
id | Yes | Id of the application | mosip.pre-registration.transliteration.transliterate |
version | Yes | version of the application | 1.0 |
requesttime | Yes | Request time of the application | 2019-01-16T05:23:08.019Z |
request | Yes | Request for the application | |
request.from_field_lang | Yes | From language code | eng |
request.from_field_value | Yes | From field value | Kishan |
request.to_field_lang | Yes | To language code | ara |
Request
Responses
Success Response
Status code: 200
Description: Given key is transliterated successfully
Failure Response
Status code: 200
Description: Failed to transliterate
Other Failure details
Error Code | Error Message | Error Description |
---|---|---|
PRG_PAM_CORE_001 | Request id is invalid | Invalid or empty Request Id |
PRG_PAM_CORE_002 | Request version is invalid | Invalid or empty Request version |
PRG_PAM_CORE_003 | Invalid request time | Empty Request time |
PRG_CORE_REQ_013 | Request date should be current date | If request date is not current date |
PRG_TRL_APP_008 | Unsupported language | If langCode is other than ara,eng and fra |
PRG_TRL_APP_002 | Incorrect mandatory Fields | If any of the request is null |
Captcha Service (Public)
This service is used in Pre-Registration portal to protects the website from spam and abuse. In this API we are google recaptcha V2 to authenticate.
POST /captcha/validatecaptcha
This request is used to validate the response from the google recaptcha v2 API used in the front end application.
Resource URL
https://{base_url}/preregistration/v1/captcha/validatecaptcha
Resource details
Resource Details | Description |
---|---|
Response format | JSON |
Requires Authentication | NO |
Parameters
Name | Required | Description | Example |
---|---|---|---|
id | Yes | Id of the application | mosip.pre-registration.captcha.id.validate |
version | Yes | version of the application | 1.0 |
requesttime | Yes | Request time of the application | 2019-01-16T05:23:08.019Z |
request | Yes | Request for the application | |
request.captcha_token | Yes | token |
Request
Responses
Success Response
Status code: 200
Description: Captcha successfully verified
Failure Response
Status code: 200
Description: Invalid Captcha
Other Failure details
Error Code | Error Message | Error Description |
---|---|---|
PRG_PAM_CORE_001 | Request id is invalid | Invalid or empty Request Id |
PRG_PAM_CORE_002 | Request version is invalid | Invalid or empty Request version |
PRG_PAM_CORE_003 | Invalid request time | Empty Request time |
PRG_CORE_REQ_013 | Request date should be current date | If request date is not current date |
PRG-PAM-006 | Invalid request , Request can't be null or empty |
Common Exception Details for all Preregistration API
Error Code | Error Message | Error Description |
---|---|---|
PRG_CORE_REQ_015 | Error message will come accordingly to the exception occurred | This error code will occur for MethodArgumentNotValidException,HttpMessageNotReadableException |
PRG_CORE_REQ_016 | Error message will come accordingly to the exception occurred | This error code will occur for Exception,RuntimeException |
KER-ATH-402 | Token expired | If the auth token got expired |
KER-ATH-401 | Invalid Token | If the auth token is invalid |
Last updated