Skip to main content
All profile endpoints require a valid Bearer token in the Authorization header.

​
Get profile

GET /v2/profile Returns the authenticated user’s profile. This endpoint is used on the home screen, the profile screen, and the documents screen to populate user data and identity verification status.

​
Response

​
id
integer
The user’s numeric database ID.
​
first_name
string
The user’s first name.
​
last_name
string
The user’s last name.
​
email
string
The user’s email address.
​
phone
string
The user’s phone number.
​
image
string
Absolute URL of the user’s profile photo.
​
uuid
string
The user’s unique identifier. Used to generate the identity QR code.
​
id_proof_front
string
URL of the front image of the uploaded national ID, if present.
​
id_proof_back
string
URL of the back image of the uploaded national ID, if present.
​
passport_img_front
string
URL of the front image of the uploaded passport, if present.
​
passport_img_back
string
URL of the back image of the uploaded passport, if present.
​
driving_license_front
string
URL of the front image of the uploaded driving licence, if present.
​
driving_license_back
string
URL of the back image of the uploaded driving licence, if present.
curl https://dossapp.com/api/v2/profile \
  -H "Authorization: Bearer {token}" \
  -H "Accept: application/json"

​
Update name

POST /v2/update_name Updates the authenticated user’s first and last name. Invalidates the cached profile on success.

​
Request body

​
first_name
string
required
The user’s new first name.
​
last_name
string
required
The user’s new last name.
curl -X POST https://dossapp.com/api/v2/update_name \
  -H "Authorization: Bearer {token}" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"first_name": "Jane", "last_name": "Doe"}'

​
Update email

POST /v2/update_email Updates the authenticated user’s email address. The current email must be provided for verification.

​
Request body

​
last_email
string
required
The user’s current (old) email address.
​
new_email
string
required
The new email address to set.
curl -X POST https://dossapp.com/api/v2/update_email \
  -H "Authorization: Bearer {token}" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"last_email": "old@example.com", "new_email": "new@example.com"}'

​
Update phone

POST /v2/update_phone Updates the authenticated user’s phone number. The current phone number must be provided for verification.

​
Request body

​
old_phone
string
required
The user’s current phone number, including the country dial code.
​
new_phone
string
required
The new phone number to set, including the country dial code.
curl -X POST https://dossapp.com/api/v2/update_phone \
  -H "Authorization: Bearer {token}" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"old_phone": "+18681234567", "new_phone": "+18687654321"}'

​
Update profile photo

POST /v2/update_image Uploads a new profile photo for the authenticated user. The request must be sent as multipart/form-data.
The image file is sent under the field name image. The client supports both selecting from the photo library and capturing from the camera.

​
Request body

​
image
file
required
The image file to upload. Sent as a multipart/form-data part with the fields uri, type, and name.
curl -X POST https://dossapp.com/api/v2/update_image \
  -H "Authorization: Bearer {token}" \
  -H "Accept: application/json" \
  -F "image=@/path/to/photo.jpg"

Build docs developers (and LLMs) love

Get started for freeTalk to us