Singapore Family Pass

Singapore Family Pass is a relocation visa issued to selected family members of Employment Pass, S Pass holders, EntrePass holders or Personalised Employment Pass (PEP) holders.

Before using the Singapore Family Pass OCR service, please review the OCR limitations that may affect text recognition accuracy.

Singapore Family Pass Object

Name
status
Type
string
Description
Enum code indicating the status of the reading result.
1. SUCCESS
2. NO_FILE
3. FILE_INVALID_FORMAT
4. FAILED
Name
reason
Type
string
Description
A human-readable message providing more details about the reading result.
Name
images
Type
object
Description
Contains the cropped image (in base64 format) of face in document.
- Name
  photo
  Type
  string
  Description
  Face in base64 format.
- Name
  sign
  Type
  string
  Description
  Signature in base64 format.
Name
read
Type
object
Description
Contains the reading for each Singapore Family Pass fields. Each fields has confidence (in percentage) and value (the reading).
- Name
  address
  Type
  object
  Description
  Address.
- Name
  card_number
  Type
  object
  Description
  Card Number.
- Name
  card_type
  Type
  object
  Description
  Card type.
- Name
  date_of_birth
  Type
  object
  Description
  Date of birth.
- Name
  expiry_date
  Type
  object
  Description
  Expiry date.
- Name
  fin
  Type
  object
  Description
  Foreign identification number.
- Name
  issue_date
  Type
  object
  Description
  Issue date.
- Name
  name
  Type
  object
  Description
  Name.
- Name
  nationality
  Type
  object
  Description
  Nationality.
- Name
  pass_status
  Type
  object
  Description
  Pass status.
- Name
  sex
  Type
  object
  Description
  Sex.

POST/ocr/v1/singapore-family-pass

Read Singapore Family Pass

Detects a valid Singapore Family Pass image and returns the information as text.

Required parameter

Name
image
Type
file (.png, .jpg, .jpeg)
Description
The image file for the Singapore Family Pass.

Sample Request

POST

/ocr/v1/singapore-family-pass


    1
2
3
4
5

    import ApiClient from '@glair/vision';

const vision = new Vision({ apiKey: 'api-key', username: 'username', password: 'password' });

await vision.ocr.singaporeFamilyPass({ image: '/path/to/image/FamilyPass.jpg' });

Sample Response


    1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53

    {
  "images": {
    "photo": "/9j/4A..."
  },
  "read": {
    "address": {
      "confidence": 0,
      "value": ""
    },
    "card_number": {
      "confidence": 0,
      "value": ""
    },
    "card_type": {
      "confidence": 0,
      "value": ""
    },
    "date_of_birth": {
      "confidence": 96,
      "value": "17-12-2004"
    },
    "expiry_date": {
      "confidence": 96,
      "value": "02-02-2028"
    },
    "fin": {
      "confidence": 99,
      "value": "M0425258J"
    },
    "issue_date": {
      "confidence": 98,
      "value": "07-07-2016"
    },
    "name": {
      "confidence": 99,
      "value": "JAY NOLEN (JAMES MCCLUNG)"
    },
    "nationality": {
      "confidence": 99,
      "value": "PORTUGAL"
    },
    "pass_status": {
      "confidence": 95,
      "value": "EXPIRED"
    },
    "sex": {
      "confidence": 99,
      "value": "MALE"
    }
  },
  "reason": "File successfully read.",
  "status": "SUCCESS"
}

Request ID

An associated request identifier is generated for every request made to this endpoint. This value can be found in the response headers under Request-Id

Responses

Various responses for this endpoint, in addition to general responses specified in Errors.

`200 - OK`

Request with readable Singapore Family Pass image

Response


    1
2
3
4
5

    {
  "status": "SUCCESS",
  "reason": "File successfully read.",
  //...,
}

`400 - Bad Request`

Request without form-data image

Response


    1
2
3
4
5

    {
  "status": "NO_FILE",
  "reason": "No file in request body. Some fields are invalid.",
  //...,
}

`415 - Unsupported Media Type`

Request with non-image file format

Response


    1
2
3
4
5

    {
  "status": "FILE_INVALID_FORMAT",
  "reason": "Failed to process invalid file format. Please upload the correct file format. Some fields are invalid.",
  //...,
}