> For the complete documentation index, see [llms.txt](https://docs.vida.id/identity-stack/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vida.id/identity-stack/verify/document-ai/ocr-and-document-verification/ocr-and-document-verification-v2/full-details-endpoint/id-verification/malaysian-cards.md).
# Malaysian Cards
Currently Supported Malaysian Cards include:
1. [MyKad](#mykad)
2. [MyTentera](#mytentera)
3. [MyKas](#mykas)
4. [MyPR](#mypr)
{% hint style="info" %}
**Note:** Backside card support can be enabled through configuration, and the KYC flow will follow the `idSubType` you provide (for example, use `idSubType = MyKad` to apply the correct setup).
{% endhint %}
## MyKad
### Request
Request for Front Side Only
```json
{
"operations": ["idVerification"],
"payload": {
"partnerTrxId": "random-uuid",
"groupId": "random-uuid",
"idType": "ID_CARD",
"country": "MYS",
"idSubtype": "MyKad",
"idFrontSideImage": "Base64 encoded image of ID front side"
},
"userConsent": {
"userIP": "0.0.0.0",
"country": "MYS",
"obtained": true,
"obtainedAt": "1680700959"
}
}
```
Request for Front Side and Back Side
```json
{
"operations": ["idVerification"],
"payload": {
"partnerTrxId": "random-uuid",
"groupId": "random-uuid",
"idType": "ID_CARD",
"country": "MYS",
"idSubtype": "MyKad",
"idFrontSideImage": "Base64 encoded image of ID front side",
"idBackSideImage": "Base64 encoded image of ID back side" //if enabled
},
"userConsent": {
"userIP": "0.0.0.0",
"country": "MYS",
"obtained": true,
"obtainedAt": "1680700959"
}
}
```
### Success Response
HTTP Status Code: `200`
Success JSON Response for Front Side Only
```json
{
"transactionId": "unique transaction id generated to identify this transaction",
"partnerTrxId": "partner transaction id submitted by customer in request",
"groupId": "partner group id submitted by customer in request",
"card": {
"country": "MALAYSIA",
"type": "MyKad",
"isoAlpha3CountryCode": "MYS",
"isoAlpha2CountryCode": "MY"
},
"imageQualityResult": {
"front": {
"glare": {
"score": 0,
"threshold": 0.95
},
"blurriness": {
"score": 0.000004,
"threshold": 0.95
},
"lowLight": {
"score": 0.138068,
"threshold": 0.95
}
}
},
"idVerificationResult": {
"front": {
"spoofingResult": {
"message": "Success",
"code": 5000,
"recapScore": {
"score": 0.186553,
"threshold": 0.95
},
"blackWhite": {
"score": 0.00359,
"threshold": 0.95
},
},
"colorPrint": {
"score": 0.477745,
"threshold": 0.95
}
},
"landmarkResult": {
"code": 5000,
"message": "Success",
"threshold": 0.95,
"containerResult": [
{
"name": "ghost",
"score": 0.9929
},
{
"name": "portrait",
"score": 0.9795
},
{
"name": "hibiscus_logo",
"score": 0.9849
},
-----[TRUNCATED]------
]
},
"forgeryResult": {
"code": 5000,
"message": "Success",
"summary": {
"score": 0.25716,
"threshold": 0.95
}
}
}
}
}
```
Success JSON Response for Front Side and Back Side
```json
{
"transactionId": "unique transaction id generated to identify this transaction",
"partnerTrxId": "partner transaction id submitted by customer in request",
"groupId": "partner group id submitted by customer in request",
"card": {
"country": "MALAYSIA",
"type": "MyKad",
"isoAlpha3CountryCode": "MYS",
"isoAlpha2CountryCode": "MY"
},
"imageQualityResult": {
"front": {
"glare": {
"score": 0,
"threshold": 0.95
},
"blurriness": {
"score": 0.0008,
"threshold": 0.95
},
"lowLight": {
"score": 0.076793,
"threshold": 0.95
}
},
"back": {
"blurriness": {
"score": 0.003535,
"threshold": 0.95
},
"lowLight": {
"score": 0,
"threshold": 0.95
}
}
},
"idVerificationResult": {
"front": {
"spoofingResult": {
"message": "Success",
"code": 5000,
"recapScore": {
"score": 0.156807,
"threshold": 0.95
},
"blackWhite": {
"score": 0.005257,
"threshold": 0.95
},
"colorPrint": {
"score": 0.477745,
"threshold": 0.95
}
},
"landmarkResult": {
"code": 5000,
"message": "Success",
"threshold": 0.95,
"containerResult": [
{
"name": "card_logo",
"score": 0.9831
},
{
"name": "chip",
"score": 0.9748
},
{
"name": "hibiscus_logo",
"score": 0.9832
},
{
"name": "malaysia_flag",
"score": 0.9882
},
-----[TRUNCATED]------
]
},
"forgeryResult": {
"code": 5000,
"message": "Success",
"summary": {
"score": 0.257167,
"threshold": 0.95
}
}
},
"back": {
"spoofingResult": {
"message": "Success",
"code": 5000,
"recapScore": {
"score": 0.270645,
"threshold": 0.95
},
"blackWhite": {
"score": 0.014498,
"threshold": 0.95
},
"colorPrint": {
"score": 0.1397,
"threshold": 0.95
}
},
"landmarkResult": {
"code": 5000,
"message": "Success",
"threshold": 0.95,
"containerResult": [
{
"name": "coat_of_arm",
"score": 0.9956
},
{
"name": "kopiah",
"score": 0.995
},
-----[TRUNCATED]------
]
}
}
}
}
```
### Forged Card Response
HTTP Status Code: `400`
Forged card JSON Response
```json
{
"transactionId": "unique transaction id generated to identify this transaction",
"partnerTrxId": "partner transaction id submitted by customer in request",
"groupId": "partner group id submitted by customer in request",
"errors": [
{
"message": "The card appears to be forged.",
"code": 5024,
"operations": [
"idVerification"
]
}
],
"imageQualityResult": {
"front": {
"glare": {
"score": 0,
"threshold": 0.95
},
"blurriness": {
"score": 0.008268,
"threshold": 0.95
},
"lowLight": {
"score": 0.029575,
"threshold": 0.95
}
}
}
}
```
### Landmark Warning Response
HTTP Status Code: `200`
Landmark Card JSON Response
```json
{
"transactionId": "unique transaction id generated to identify this transaction",
"partnerTrxId": "partner transaction id submitted by customer in request",
"groupId": "partner group id submitted by customer in request",
"warnings": [
{
"message": "Image has Occlusion, please check [msc_logo] from landmarkResult for more details",
"code": 10017,
"operations": [
"idVerification"
]
}
],
"card": {
"country": "MALAYSIA",
"type": "MyKad",
"isoAlpha3CountryCode": "MYS",
"isoAlpha2CountryCode": "MY"
},
"imageQualityResult": {
"front": {
"glare": {
"score": 0.865832,
"threshold": 0.95
},
"blurriness": {
"score": 0.005475,
"threshold": 0.95
},
"lowLight": {
"score": 0.068952,
"threshold": 0.95
}
}
},
"idVerificationResult": {
"front": {
"spoofingResult": {
"message": "Success",
"code": 5000,
"recapScore": {
"score": 0.220021,
"threshold": 0.95
},
"blackWhite": {
"score": 0.003927,
"threshold": 0.95
}
},
"landmarkResult": {
"code": 5000,
"message": "Success",
"threshold": 0.95,
"containerResult": [
{
"name": "chip",
"score": 0.9752
},
{
"name": "portrait",
"score": 0.9733
},
{
"name": "card_logo",
"score": 0.981
},
-----TRUNCATED-----
]
},
"forgeryResult": {
"code": 5000,
"message": "Success",
"summary": {
"score": 0.257168,
"threshold": 0.95
}
}
}
}
}
```
### Spoof Error Response
{% hint style="info" %}
**Note**: This happens when **1 or** **more than 1** spoof check fails.
{% endhint %}
HTTP Status Code: `400`
Spoof Card JSON Response
```json
{
"transactionId": "unique transaction id generated to identify this transaction",
"partnerTrxId": "partner transaction id submitted by customer in request",
"groupId": "partner group id submitted by customer in request",
"errors": [
{
"message": "Spoof check failed. Image submitted is Recaptured",
"code": 5601,
"operations": [
"idVerification"
]
},
{
"message": "Spoof check failed. Image submitted is either B&W or Photocopy",
"code": 5602,
"operations": [
"idVerification"
]
},
{
"message": "Spoof check failed. Image submitted is color reprint",
"code": 5603,
"operations": [
"idVerification"
]
}
],
"imageQualityResult": {
"front": {
"glare": {
"score": 0.097592,
"threshold": 0.95
},
"blurriness": {
"score": 0.004796,
"threshold": 0.95
},
"lowLight": {
"score": 0.058688,
"threshold": 0.95
}
}
}
}
```
## MyTentera
{% hint style="info" %}
**Note:**
There are **two versions of MyTentera cards**:
* An **old version** (without a ghost image)
* A **new version** (with a ghost image)
The **ghost image** is treated as an **optional landmark**:
* If detected, it will be **included** in the response.
* If not detected, it will be **silently omitted** — **no warning** will be triggered.
{% endhint %}
### Request
Request for Front Side Only
```json
{
"operations": ["idVerification"],
"payload": {
"partnerTrxId": "random-uuid",
"groupId": "random-uuid",
"idType": "ID_CARD",
"country": "MYS",
"idSubtype": "MyTentera",
"idFrontSideImage": "Base64 encoded image of ID front side"
},
"userConsent": {
"userIP": "0.0.0.0",
"country": "MYS",
"obtained": true,
"obtainedAt": "1680700959"
}
}
```
Request for Front and Back Side
```json
{
"operations": ["idVerification"],
"payload": {
"partnerTrxId": "random-uuid",
"groupId": "random-uuid",
"idType": "ID_CARD",
"country": "MYS",
"idSubtype": "MyTentera",
"idFrontSideImage": "Base64 encoded image of ID front side",
"idBackSideImage": "Base64 encoded image of ID back side" //if enabled
},
"userConsent": {
"userIP": "0.0.0.0",
"country": "MYS",
"obtained": true,
"obtainedAt": "1680700959"
}
}
```
### Success Response
HTTP Status Code: `200`
Success JSON Response for Front Side Only
```json
{
"transactionId": "unique transaction id generated to identify this transaction",
"partnerTrxId": "partner transaction id submitted by customer in request",
"groupId": "partner group id submitted by customer in request",
"card": {
"country": "MALAYSIA",
"type": "MyTentera",
"isoAlpha3CountryCode": "MYS",
"isoAlpha2CountryCode": "MY"
},
"imageQualityResult": {
"front": {
"blurriness": {
"score": 0.000613,
"threshold": 0.95
},
"lowLight": {
"score": 0.150821,
"threshold": 0.95
}
}
},
"idVerificationResult": {
"front": {
"spoofingResult": {
"message": "Success",
"code": 5000,
"recapScore": {
"score": 0.166092,
"threshold": 0.95
},
"blackWhite": {
"score": 0.012025,
"threshold": 0.95
},
"colorPrint": {
"score": 0.477745,
"threshold": 0.95
}
},
"landmarkResult": {
"code": 5000,
"message": "Success",
"threshold": 0.95,
"containerResult": [
{
"name": "chip",
"score": 0.9981
},
{
"name": "hibiscus_logo",
"score": 0.9977
},
-----[TRUNCATED]------
]
}
}
}
}
```
Success JSON Response for Front Side and Back Side
```json
{
"transactionId": "ee6a6407-c56b-45ea-9607-24c4e5960169",
"partnerTrxId": "01cfe276-e5b5-42f9-b069-9f71fbb5ce5b",
"groupId": "cf95b45b-b443-4e90-b15b-7e868641e1d3",
"card": {
"country": "MALAYSIA",
"type": "MyTentera",
"isoAlpha3CountryCode": "MYS",
"isoAlpha2CountryCode": "MY"
},
"imageQualityResult": {
"front": {
"blurriness": {
"score": 0.03898,
"threshold": 0.95
},
"lowLight": {
"score": 0.003386,
"threshold": 0.95
}
},
"back": {
"blurriness": {
"score": 0.021608,
"threshold": 0.95
},
"lowLight": {
"score": 0,
"threshold": 0.95
}
}
},
"idVerificationResult": {
"front": {
"spoofingResult": {
"message": "Success",
"code": 5000,
"recapScore": {
"score": 0.105434,
"threshold": 0.95
},
"blackWhite": {
"score": 0.005061,
"threshold": 0.95
},
"colorPrint": {
"score": 0.058626,
"threshold": 0.95
}
},
"landmarkResult": {
"code": 5000,
"message": "Success",
"threshold": 0.95,
"containerResult": [
{
"name": "chip",
"score": 0.9983
},
{
"name": "hibiscus_logo",
"score": 0.9978
},
{
"name": "portrait",
"score": 0.9976
},
{
"name": "ghost",
"score": 0.9973
},
{
"name": "name",
"score": 0.9972
},
{
"name": "card_logo",
"score": 0.9969
},
{
"name": "msc_logo",
"score": 0.9967
},
{
"name": "kad_pengenalan_header",
"score": 0.9961
},
{
"name": "malaysia_flag",
"score": 0.9949
},
{
"name": "id_number",
"score": 0.9929
}
]
}
},
"back": {
"spoofingResult": {
"message": "Success",
"code": 5000,
"recapScore": {
"score": 0.127194,
"threshold": 0.95
},
"blackWhite": {
"score": 0.091711,
"threshold": 0.95
},
"colorPrint": {
"score": 0.102728,
"threshold": 0.95
}
},
"landmarkResult": {
"code": 5000,
"message": "Success",
"threshold": 0.95,
"containerResult": [
{
"name": "kopiah",
"score": 0.9976
},
{
"name": "military_logo",
"score": 0.9952
},
{
"name": "coat_of_arm",
"score": 0.9948
},
{
"name": "state_registrar",
"score": 0.9931
},
{
"name": "twin_tower",
"score": 0.993
},
{
"name": "id_number",
"score": 0.992
}
]
}
}
},
-----[TRUNCATED]------
]
}
}
}
}
```
### Landmark Warning Response
HTTP Status Code: `200`
Landmark Card JSON Response
```json
{
"transactionId": "unique transaction id generated to identify this transaction",
"partnerTrxId": "partner transaction id submitted by customer in request",
"groupId": "partner group id submitted by customer in request",
"warnings": [
{
"message": "Image has Occlusion, please check [msc_logo] from landmarkResult for more details",
"code": 10017,
"operations": [
"idVerification"
]
}
],
"card": {
"country": "MALAYSIA",
"type": "MyTentera",
"isoAlpha3CountryCode": "MYS",
"isoAlpha2CountryCode": "MY"
},
"imageQualityResult": {
"front": {
"blurriness": {
"score": 0.000857,
"threshold": 0.95
},
"lowLight": {
"score": 0.056495,
"threshold": 0.95
}
}
},
"idVerificationResult": {
"front": {
"spoofingResult": {
"message": "Success",
"code": 5000,
"recapScore": {
"score": 0.153728,
"threshold": 0.95
},
"blackWhite": {
"score": 0.00566,
"threshold": 0.95
}
},
"landmarkResult": {
"code": 5000,
"message": "Success",
"threshold": 0.95,
"containerResult": [
{
"name": "chip",
"score": 0.9982
},
{
"name": "card_logo",
"score": 0.9975
},
{
"name": "portrait",
"score": 0.9951
},
-----[TRUNCATED]------
]
}
}
}
}
```
### Spoof Error Response
{% hint style="info" %}
Note: This happens when **1 or** **more than 1** spoof check fails.
{% endhint %}
HTTP Status Code: `400`
Spoof Card JSON Response
```json
{
"transactionId": "unique transaction id generated to identify this transaction",
"partnerTrxId": "partner transaction id submitted by customer in request",
"groupId": "partner group id submitted by customer in request",
"errors": [
{
"message": "Spoof check failed. Image submitted is Recaptured",
"code": 5601,
"operations": [
"idVerification"
]
},
{
"message": "Spoof check failed. Image submitted is either B&W or Photocopy",
"code": 5602,
"operations": [
"idVerification"
]
},
{
"message": "Spoof check failed. Image submitted is color reprint",
"code": 5603,
"operations": [
"idVerification"
]
}
],
"imageQualityResult": {
"front": {
"glare": {
"score": 0.097592,
"threshold": 0.95
},
"blurriness": {
"score": 0.004796,
"threshold": 0.95
},
"lowLight": {
"score": 0.058688,
"threshold": 0.95
}
}
}
}
```
## MyKas
Request for Front Side Only
```json
{
"operations": ["idVerification"],
"payload": {
"partnerTrxId": "random-uuid",
"groupId": "random-uuid",
"idType": "ID_CARD",
"country": "MYS",
"idSubtype": "MyKas",
"idFrontSideImage": "Base64 encoded image of ID front side"
},
"userConsent": {
"userIP": "0.0.0.0",
"country": "MYS",
"obtained": true,
"obtainedAt": "1680700959"
}
}
```
Request for Front Side and Back Side
```json
{
"operations": ["idVerification"],
"payload": {
"partnerTrxId": "random-uuid",
"groupId": "random-uuid",
"idType": "ID_CARD",
"country": "MYS",
"idSubtype": "MyKas",
"idFrontSideImage": "Base64 encoded image of ID front side",
"idBackSideImage": "Base64 encoded image of ID back side" //if enabled
},
"userConsent": {
"userIP": "0.0.0.0",
"country": "MYS",
"obtained": true,
"obtainedAt": "1680700959"
}
}
```
### Success Response
HTTP Status Code: `200`
Success JSON Response for Front Side Only
```json
{
"transactionId": "unique transaction id generated to identify this transaction",
"partnerTrxId": "partner transaction id submitted by customer in request",
"groupId": "partner group id submitted by customer in request",
"card": {
"country": "MALAYSIA",
"type": "MyKas",
"isoAlpha3CountryCode": "MYS",
"isoAlpha2CountryCode": "MY"
},
"imageQualityResult": {
"front": {
"blurriness": {
"score": 0.000112,
"threshold": 0.95
},
"lowLight": {
"score": 0.195976,
"threshold": 0.95
}
}
},
"idVerificationResult": {
"front": {
"spoofingResult": {
"message": "Success",
"code": 5000,
"recapScore": {
"score": 0.144961,
"threshold": 0.95
},
"blackWhite": {
"score": 0.004127,
"threshold": 0.95
},
"colorPrint": {
"score": 0.477745,
"threshold": 0.95
}
},
"landmarkResult": {
"code": 5000,
"message": "Success",
"threshold": 0.95,
"containerResult": [
{
"name": "chip",
"score": 0.9987
},
{
"name": "malaysia_flag",
"score": 0.998
},
{
"name": "card_logo",
"score": 0.9967
},
{
"name": "portrait",
"score": 0.9961
},
{
"name": "kad_pengenalan_header",
"score": 0.9952
},
{
"name": "name",
"score": 0.9947
},
{
"name": "id_number",
"score": 0.9939
}
]
}
}
}
}
```
Success JSON Response for Front Side and Back Side
```json
{
"transactionId": "unique transaction id generated to identify this transaction",
"partnerTrxId": "partner transaction id submitted by customer in request",
"groupId": "partner group id submitted by customer in request",
"card": {
"country": "MALAYSIA",
"type": "MyKas",
"isoAlpha3CountryCode": "MYS",
"isoAlpha2CountryCode": "MY"
},
"imageQualityResult": {
"front": {
"blurriness": {
"score": 0.000004,
"threshold": 0.95
},
"lowLight": {
"score": 0.114706,
"threshold": 0.95
}
},
"back": {
"blurriness": {
"score": 0.000009,
"threshold": 0.95
},
"lowLight": {
"score": 0,
"threshold": 0.95
}
}
},
"idVerificationResult": {
"front": {
"spoofingResult": {
"message": "Success",
"code": 5000,
"recapScore": {
"score": 0.1315,
"threshold": 0.95
},
"blackWhite": {
"score": 0.005892,
"threshold": 0.95
},
"colorPrint": {
"score": 0.063851,
"threshold": 0.95
}
},
"landmarkResult": {
"code": 5000,
"message": "Success",
"threshold": 0.95,
"containerResult": [
{
"name": "card_logo",
"score": 0.9976
},
{
"name": "chip",
"score": 0.9968
},
{
"name": "portrait",
"score": 0.9958
},
{
"name": "id_number",
"score": 0.9951
},
{
"name": "kad_pengenalan_header",
"score": 0.9951
},
{
"name": "name",
"score": 0.9949
},
{
"name": "malaysia_flag",
"score": 0.9927
}
]
}
},
"back": {
"spoofingResult": {
"message": "Success",
"code": 5000,
"recapScore": {
"score": 0.097179,
"threshold": 0.95
},
"blackWhite": {
"score": 0.040484,
"threshold": 0.95
},
"colorPrint": {
"score": 0.118763,
"threshold": 0.95
}
},
"back": {
"spoofingResult": {
"message": "Success",
"code": 5000,
"recapScore": {
"score": 0.097179,
"threshold": 0.95
},
"blackWhite": {
"score": 0.040484,
"threshold": 0.95
},
"colorPrint": {
"score": 0.118763,
"threshold": 0.95
}
},
"landmarkResult": {
"code": 5000,
"message": "Success",
"threshold": 0.95,
"containerResult": [
{
"name": "my_logo",
"score": 0.9973
},
{
"name": "id_number",
"score": 0.9963
},
{
"name": "coat_of_arm",
"score": 0.991
},
{
"name": "state_registrar",
"score": 0.9846
}
]
}
}
},
-----[TRUNCATED]------
]
}
}
}
}
```
### Landmark Warning Response
HTTP Status Code: `200`
Landmark Card JSON Response
```json
{
"transactionId": "unique transaction id generated to identify this transaction",
"partnerTrxId": "partner transaction id submitted by customer in request",
"groupId": "partner group id submitted by customer in request",
"warnings": [
{
"message": "Image has Occlusion, please check [name] from landmarkResult for more details",
"code": 10022,
"operations": [
"idVerification"
]
}
],
"card": {
"country": "MALAYSIA",
"type": "MyKas",
"isoAlpha3CountryCode": "MYS",
"isoAlpha2CountryCode": "MY"
},
"imageQualityResult": {
"front": {
"blurriness": {
"score": 0.000792,
"threshold": 0.95
},
"lowLight": {
"score": 0.327588,
"threshold": 0.95
}
}
},
"idVerificationResult": {
"front": {
"spoofingResult": {
"message": "Success",
"code": 5000,
"recapScore": {
"score": 0.181131,
"threshold": 0.95
},
"blackWhite": {
"score": 0.003997,
"threshold": 0.95
}
},
"landmarkResult": {
"code": 5000,
"message": "Success",
"threshold": 0.95,
"containerResult": [
{
"name": "card_logo",
"score": 0.9991
},
{
"name": "malaysia_flag",
"score": 0.9977
},
{
"name": "chip",
"score": 0.9956
}
-----[TRUNCATED]------
]
}
}
}
}
```
### Spoof Error Response
{% hint style="info" %}
**Note**: This happens when **1 or** **more than 1** spoof check fails.
{% endhint %}
HTTP Status Code: `400`
Spoof Card JSON Response
```json
{
"transactionId": "unique transaction id generated to identify this transaction",
"partnerTrxId": "partner transaction id submitted by customer in request",
"groupId": "partner group id submitted by customer in request",
"errors": [
{
"message": "Spoof check failed. Image submitted is Recaptured",
"code": 5601,
"operations": [
"idVerification"
]
},
{
"message": "Spoof check failed. Image submitted is either B&W or Photocopy",
"code": 5602,
"operations": [
"idVerification"
]
},
{
"message": "Spoof check failed. Image submitted is color reprint",
"code": 5603,
"operations": [
"idVerification"
]
}
],
"imageQualityResult": {
"front": {
"blurriness": {
"score": 0.000002,
"threshold": 0.95
},
"lowLight": {
"score": 0.009899,
"threshold": 0.95
}
}
}
}
```
## MyPR
Request for Front Side Only
```json
{
"operations": ["idVerification"],
"payload": {
"partnerTrxId": "random-uuid",
"groupId": "random-uuid",
"idType": "ID_CARD",
"country": "MYS",
"idSubtype": "MyPR",
"idFrontSideImage": "Base64 encoded image of ID front side"
},
"userConsent": {
"userIP": "0.0.0.0",
"country": "MYS",
"obtained": true,
"obtainedAt": "1680700959"
}
}
```
Request for Front Side and Back Side
```json
{
"operations": ["idVerification"],
"payload": {
"partnerTrxId": "random-uuid",
"groupId": "random-uuid",
"idType": "ID_CARD",
"country": "MYS",
"idSubtype": "MyPR",
"idFrontSideImage": "Base64 encoded image of ID front side",
"idBackSideImage": "Base64 encoded image of ID back side" //if enabled
},
"userConsent": {
"userIP": "0.0.0.0",
"country": "MYS",
"obtained": true,
"obtainedAt": "1680700959"
}
}
```
### Success Response
HTTP Status Code: `200`
Success JSON Response for Front Side Only
```json
{
"transactionId": "unique transaction id generated to identify this transaction",
"partnerTrxId": "partner transaction id submitted by customer in request",
"groupId": "partner group id submitted by customer in request",
"card": {
"country": "MALAYSIA",
"type": "MyPR",
"isoAlpha3CountryCode": "MYS",
"isoAlpha2CountryCode": "MY"
},
"imageQualityResult": {
"front": {
"blurriness": {
"score": 0.000057,
"threshold": 0.95
},
"lowLight": {
"score": 0.644854,
"threshold": 0.95
}
}
},
"idVerificationResult": {
"front": {
"spoofingResult": {
"message": "Success",
"code": 5000,
"recapScore": {
"score": 0.17317,
"threshold": 0.95
},
"blackWhite": {
"score": 0.003875,
"threshold": 0.95
},
"colorPrint": {
"score": 0.477745,
"threshold": 0.95
}
},
"landmarkResult": {
"code": 5000,
"message": "Success",
"threshold": 0.95,
"containerResult": [
{
"name": "chip",
"score": 0.9972
},
{
"name": "portrait",
"score": 0.9963
},
-----[TRUNCATED]------
]
}
}
}
}
```
Success JSON Response for Front Side and Back Side
```json
{
"transactionId": "4e708e41-567b-4230-988d-26bd660b2797",
"partnerTrxId": "4dfe72a5-fdb1-4127-8fe6-b778fb853a95",
"groupId": "581edbe0-887b-4533-8254-7cd6ff9c89b2",
"card": {
"country": "MALAYSIA",
"type": "MyPR",
"isoAlpha3CountryCode": "MYS",
"isoAlpha2CountryCode": "MY"
},
"imageQualityResult": {
"front": {
"blurriness": {
"score": 0.000053,
"threshold": 0.95
},
"lowLight": {
"score": 0.166888,
"threshold": 0.95
}
},
"back": {
"blurriness": {
"score": 0.000209,
"threshold": 0.95
},
"lowLight": {
"score": 0,
"threshold": 0.95
}
}
},
"idVerificationResult": {
"front": {
"spoofingResult": {
"message": "Success",
"code": 5000,
"recapScore": {
"score": 0.147336,
"threshold": 0.95
},
"blackWhite": {
"score": 0.005015,
"threshold": 0.95
},
"colorPrint": {
"score": 0.355417,
"threshold": 0.95
}
},
"landmarkResult": {
"code": 5000,
"message": "Success",
"threshold": 0.95,
"containerResult": [
{
"name": "kad_pengenalan_header",
"score": 0.9966
},
{
"name": "chip",
"score": 0.9965
},
{
"name": "portrait",
"score": 0.9962
},
{
"name": "card_logo",
"score": 0.996
},
{
"name": "malaysia_flag",
"score": 0.9947
},
{
"name": "id_number",
"score": 0.9946
},
{
"name": "name",
"score": 0.9935
}
]
}
},
"back": {
"spoofingResult": {
"message": "Success",
"code": 5000,
"recapScore": {
"score": 0.116926,
"threshold": 0.95
},
"blackWhite": {
"score": 0.011473,
"threshold": 0.95
},
"colorPrint": {
"score": 0.319818,
"threshold": 0.95
}
},
"landmarkResult": {
"code": 5000,
"message": "Success",
"threshold": 0.95,
"containerResult": [
{
"name": "coat_of_arm",
"score": 0.9972
},
{
"name": "id_number",
"score": 0.9952
},
{
"name": "my_logo",
"score": 0.9937
},
{
"name": "state_registrar",
"score": 0.9927
},
{
"name": "negara_asal",
"score": 0.9912
},
-----[TRUNCATED]------
]
}
}
}
}
```
### Landmark Warning Response
HTTP Status Code: `200`
Landmark Card JSON Response
```json
{
"transactionId": "unique transaction id generated to identify this transaction",
"partnerTrxId": "partner transaction id submitted by customer in request",
"groupId": "partner group id submitted by customer in request",
"warnings": [
{
"message": "Image has Occlusion, please check [name] from landmarkResult for more details",
"code": 10022,
"operations": [
"idVerification"
]
}
],
"card": {
"country": "MALAYSIA",
"type": "MyKas",
"isoAlpha3CountryCode": "MYS",
"isoAlpha2CountryCode": "MY"
},
"imageQualityResult": {
"front": {
"blurriness": {
"score": 0.000792,
"threshold": 0.95
},
"lowLight": {
"score": 0.327588,
"threshold": 0.95
}
}
},
"idVerificationResult": {
"front": {
"spoofingResult": {
"message": "Success",
"code": 5000,
"recapScore": {
"score": 0.181131,
"threshold": 0.95
},
"blackWhite": {
"score": 0.003997,
"threshold": 0.95
}
},
"landmarkResult": {
"code": 5000,
"message": "Success",
"threshold": 0.95,
"containerResult": [
{
"name": "card_logo",
"score": 0.9991
},
{
"name": "malaysia_flag",
"score": 0.9977
},
{
"name": "chip",
"score": 0.9956
},
{
"name": "kad_pengenalan_header",
"score": 0.9934
},
{
"name": "portrait",
"score": 0.9865
},
{
"name": "id_number",
"score": 0.9612
},
{
"name": "name",
"score": 0
}
]
}
}
}
}
```
### Spoof Error Response
{% hint style="info" %}
Note: This happens when **1 or** **more than 1** spoof check fails.
{% endhint %}
HTTP Status Code: `400`
Spoof Card JSON Response
```json
{
"transactionId": "unique transaction id generated to identify this transaction",
"partnerTrxId": "partner transaction id submitted by customer in request",
"groupId": "partner group id submitted by customer in request",
"errors": [
{
"message": "Spoof check failed. Image submitted is Recaptured",
"code": 5601,
"operations": [
"idVerification"
]
},
{
"message": "Spoof check failed. Image submitted is either B&W or Photocopy",
"code": 5602,
"operations": [
"idVerification"
]
},
{
"message": "Spoof check failed. Image submitted is color reprint",
"code": 5603,
"operations": [
"idVerification"
]
}
],
"imageQualityResult": {
"front": {
"glare": {
"score": 0,
"threshold": 0.95
},
"blurriness": {
"score": 0.008268,
"threshold": 0.95
},
"lowLight": {
"score": 0.029575,
"threshold": 0.95
}
}
}
}
```