List all Proof of address check-ins.
GET/api/checkins/proof-of-address
Retrieve the list of proof of address check-ins of all users owned by a partner.
Request
Query Parameters
Default value: 0
Page number
Default value: 10
Number of items per page
Possible values: [dateCheckedIn, dateUpdated]
Default value: dateCheckedIn
Sort by field
Possible values: [asc, desc]
Default value: desc
Sort by order
Possible values: [id, city, state, userFirstName, userLastName, userEmail, userPhone]
Search by field
Search by value
Possible values: [Pending, Confirmed, Declined, OnHold, Archived, All]
Filter proof of address check-ins by status
Filter proof of address check-ins marked as fraud.
Filter proof of address check-ins whose check-in date is greater or than equal to the date passed in. (The date should be in the ISO8601 UTC format YYY-MM-DDThh:mm:ss.SSSZ)
Filter proof of address check-ins whose check-in date is less or than equal to the date passed in. (The date should be in the ISO8601 UTC format YYY-MM-DDThh:mm:ss.SSSZ)
Filter proof of address check-ins whose update date is greater or than equal to the date passed in. (The date should be in the ISO8601 UTC format YYY-MM-DDThh:mm:ss.SSSZ)
Filter proof of address check-ins whose update date is less or than equal to the date passed in. (The date should be in the ISO8601 UTC format YYY-MM-DDThh:mm:ss.SSSZ)
Responses
- 200
- 401
- 500
List of Proof of address checkin objects matching given query.
- application/json
- Schema
- Example (from schema)
Schema
Array [
Array [
]
Array [
]
]
Total number of proof of address check-ins
Current page number
Current page size
Number of proof of address check-ins on current page
checkins
object[]
List of proof of address check-ins
Id of the checkin
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
address
object
Address
Street Address Line 1
City
2 Letter State Code
2 Letter Country Code
Zip
Latitude at which photo was taken
Longitude at which photo was taken
Possible values: [UtilityBill, Paycheck, FinancialStatement, SaleDeed, LeaseAgreement, PhoneBill, Invalid]
Document Type
insights
object
Insights gathered from the uploaded document(s)
First name on document(s)
Last name on document(s)
address
object
Address
Street Address Line 1
Street Address Line 2
City
2 Letter State Code
2 Letter Country Code
Zip
documents
object[]
The document(s)
URL of the document
Possible values: [DOCUMENT, GALLERY, CAMERA, INVALID, CAMERA, DOCUMENT, GALLERY]
Type of the document.
Latitude at which photo was taken
Longitude at which photo was taken
Indicates that the document has been marked invalid on review.
photos
object[]
The photos of the vehicle taken from different angles
URL of the photo
Possible values: [FrontView, AlternateView]
Type of the photo. A value from one of the proof of address 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.
Latitude at which check-in was done
Longitude at which check-in was done
owner
object
Check-in owner
Id of the user
User's first name
User's last name
{
"totalItems": 0,
"currentPage": 0,
"totalPages": 0,
"itemsOnPage": 0,
"checkins": [
{
"id": "string",
"userNote": "string",
"adminNote": "string",
"checkedInAt": "string",
"checkInStatus": "Confirmed",
"updated": "string",
"address": {
"addressLine1": "string",
"city": "string",
"state": "string",
"country": "string",
"zip": "string",
"latitude": 0,
"longitude": 0
},
"documentType": "UtilityBill",
"insights": {
"firstName": "string",
"lastName": "string",
"address": {
"addressLine1": "string",
"addressLine2": "string",
"city": "string",
"state": "string",
"country": "string",
"zip": "string"
}
},
"documents": [
{
"url": "string",
"type": "DOCUMENT",
"latitude": 0,
"longitude": 0,
"markedInvalidByReview": true
}
],
"photos": [
{
"photoUrl": "string",
"type": "FrontView",
"latitude": 0,
"longitude": 0,
"markedInvalidByReview": true
}
],
"latitude": 0,
"longitude": 0,
"owner": {
"id": "string",
"firstName": "string",
"lastName": "string"
},
"fraud": true
}
]
}
Authorization error e.g. due to an invalid or missing API keys.
Internal error. Possible error codes
-
INTERNAL_SERVER_ERROR
- application/json
- Schema
- Example (from schema)
Schema
Error code
A verbose error message
{
"error_code": "string",
"error_message": "string"
}