Create a proof of address check-in.
POST/api/users/checkin/proof-of-address
Create a proof of address check-in. A proof of address check-in requires a document (or photos) clearly proving residence. Photos need to be uploaded to the Ownli cloud via the Photo upload api.
Request
- application/json
Body
required
Array [
]
Array [
]
Id of the user.
Possible values: [UtilityBill, Paycheck, FinancialStatement, SaleDeed, LeaseAgreement, PhoneBill, Invalid, UtilityBill, Paycheck, FinancialStatement, SaleDeed, LeaseAgreement, PhoneBill]
Document type for attached document.
Latitude of the check-in.
Longitude of the check-in.
Possible values: [StandaloneHome, Apartment, Condominium, Duplex, Other, Invalid, StandaloneHome, Apartment, Condominium, Duplex, Other]
Type of home.
address
object
Address
Street Address
City
2 Letter State Code (eg. AL, CA, CO etc.
2 Letter Country Code. Must be US.
Zipcode
Latitude of the address.
Longitude of the address.
photos
object[]
Url of the photo. The photo needs to be uploaded via the Photo Upload API.
Possible values: [FrontView, AlternateView, Invalid, FrontView, AlternateView]
Type of the photo. A value from one of the photo types.
documents
object[]
Url of the document. The document needs to be uploaded via the Photo Upload API.
Possible values: [DOCUMENT, GALLERY, CAMERA, INVALID, DOCUMENT, GALLERY, CAMERA]
File type of the document.
Ordinal
Responses
- 200
- 401
- 403
- 404
- 500
The created proof of address check-in object.
- application/json
- Schema
- Example (from schema)
Schema
Array [
]
Id of the checkin
License plate number
User generated note. For communication between the user to the admin
Admin generated note. Usually used for on-hold or declined check-ins
Check-in date
Possible values: [Confirmed, Declined, OnHold, Pending]
Status of the check-in
Last updated on
photos
object[]
The photos of the vehicle taken from different angles
URL of the photo
Possible values: [Back, Front, DriverSide, DriverSideFront, DriverSideBack, PassengerSide, PassengerSideFront, PassengerSideBack]
Type of the photo. A value from one of the condition checkin photo types.
Latitude at which photo was taken
Longitude at which photo was taken
Indicates that the photo has been marked invalid on review.
Indicates that the review has detected damage to the vehicle.
{
"id": "string",
"license": "string",
"userNote": "string",
"adminNote": "string",
"checkedInAt": "string",
"checkInStatus": "Confirmed",
"updated": "string",
"photos": [
{
"photoUrl": "string",
"type": "Back",
"latitude": 0,
"longitude": 0,
"markedInvalidByReview": true,
"damageDetected": true
}
],
"fraud": true
}
Authorization error e.g. due to an invalid or missing API keys.
The caller does not have access to the vehicle or the vehicle is in a deactivated state. Possible error codes
-
ERROR_NO_PERMISSIONS_TO_RESOURCE
-
ERROR_VEHICLE_IS_NOT_ACTIVE_ON_POLICY
- application/json
- Schema
- Example (from schema)
Schema
Error code
A verbose error message
{
"error_code": "string",
"error_message": "string"
}
User not found. Possible error codes
-
ERROR_USER_NOT_FOUND
- application/json
- Schema
- Example (from schema)
Schema
Error code
A verbose error message
{
"error_code": "string",
"error_message": "string"
}
Internal Server Error
- application/json
- Schema
- Example (from schema)
Schema
Error code
A verbose error message
{
"error_code": "string",
"error_message": "string"
}