Skip to main content
The Account Security section gives you access to identity document management and PIN reset. A progress bar on the Profile screen reflects your overall verification status. Navigate here from Profile → Account Security (DOCUMENTS route).

​
Identity documents

Route: DOCUMENTS DOSS requires identity documents to verify your account. You can upload a front and back image for each of the three supported document types.

ID proof

Government-issued identity card.
POST /v2/id_proof

Passport

Passport biographical data page.
POST /v2/passport_image

Driving licence

Front and back of your driving licence.
POST /v2/driving_license_image

​
Uploading a document

1

Select document type

Tap one of the three document cards — Upload ID proof, Passport, or Driving Licence. The selected card is highlighted.
2

Choose the front image

Tap the Front tile. A modal appears with three options:
  • Photo Library — pick an image from your device gallery.
  • Files — browse and select a file from device storage.
  • Camera — capture a photo using your camera.
The selected image appears as a thumbnail.
3

Choose the back image

Tap the Back tile and repeat the same process.
4

Upload

Tap Upload. The front and back images are sent together as multipart/form-data to the endpoint for the selected document type.
Request body (multipart/form-data)
{
  "front_image": "<file>",
  "back_image": "<file>"
}
A success toast confirms the upload. The document view refreshes automatically.
You must select a document type and provide both the front and back images before tapping Upload. Submitting with any field missing shows an error and no upload is attempted.

​
Viewing existing documents

When you tap a document type, the screen fetches your existing images from: 
GET /v2/profile
If both front and back images are already on file, the upload controls are hidden and the existing images are shown as read-only thumbnails.

​
Removing a staged image

Before uploading, tap a thumbnail to open a deletion confirmation dialog. Confirm to remove the staged image so you can replace it.
Deletion only removes the locally staged image. It does not delete a document that has already been submitted to the server.

​
Verification status on the profile screen

The profile screen shows a progress bar under the Account Security row:
Documents with both images uploadedStatusColour
1PoorRed
2GoodYellow
3ExcellentGreen

​
Resetting your PIN

You can reset your 4-digit PIN at any time from the Profile screen. The reset flow consists of three screens.
1

Enter new PIN

Route: RESET_PIN_INPUTEnter a new 4-digit PIN using the secure PIN input.
POST /v2/resetPin
Request body
{
  "new_pin": "5678"
}
On success, the app navigates to the confirmation screen, passing new_pin as a route parameter.
2

Confirm new PIN

Route: RESET_CONFIRM_PINRe-enter the same 4-digit PIN to confirm it.Before making an API call, the app validates:
  1. The entry is exactly 4 digits.
  2. The value matches the PIN entered in the previous step.
POST /v2/confirmPin
Request body
{
  "confirm_pin": "5678"
}
The server response must contain message: "Pin reset successful!" for the flow to proceed. Any other response triggers an error toast.
If the confirmation PIN does not match the PIN entered in the previous step, the error “Pin is not matching with new pin” is shown locally and no API call is made.
3

Reset complete

Route: RESET_PIN_SUCCESSA success screen displays “Pin Set Successfully!” along with the time the reset was completed. Tap Done to return to the Profile screen.

​
Security best practices

Keep your PIN private. DOSS support staff will never ask for your PIN.
  • Choose a PIN that is not easily guessable (avoid sequences like 1234 or repeated digits).
  • Do not share your PIN with anyone, including people claiming to represent DOSS.
  • Reset your PIN immediately if you believe it has been compromised.
  • Keep your identity documents up to date to maintain full account access.

Build docs developers (and LLMs) love

Get started for freeTalk to us