List all App Registrations

GET https://api.verifik.co/v2/app-registrations

This endpoint allows you to retrieve a list of all App Registrations within the Verifik API. You can use this to get a detailed overview of multiple app registrations, including their status, associated project, validation statuses, and more.

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Query Parameters

Parameter	Type	Description
page	number	Specifies the page number for pagination, starting from 1.
perPage	number	Defines the number of items per page for pagination.
populates[]	string	Populates the specified field, transforming ObjectId references into full objects. Available options: emailValidation, phoneValidation, informationValidation, biometricValidation, documentValidation, documentFace, failedBiometricValidations, project, projectFlow
where_status	string	Where condition to filter by status. Options: STARTED, ONGOING, COMPLETED_WITHOUT_KYC, COMPLETED, FAILED, NEEDS_MANUAL_VERIFICATION, EXPIRED

Request

Python

import http.client

payload = ""
headers = {
  "Authorization": "Bearer YOUR_ACCESS_TOKEN"
}

conn = http.client.HTTPSConnection("api.verifik.co")
conn.request("GET", "/v2/app-registrations", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

Node.js

const axios = require("axios");

const config = {
  method: "get",
  url: "https://api.verifik.co/v2/app-registrations",
  maxBodyLength: Infinity,
  headers: {
    Authorization: "Bearer YOUR_ACCESS_TOKEN",
  },
};

axios
  .request(config)
  .then((response) => console.log(response.data))
  .catch((error) => console.error(error));

cURL

curl -X GET "https://api.verifik.co/v2/app-registrations" \
 -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
 -H "Content-Type: application/json"

Swift

import Foundation

let url = URL(string: "https://api.verifik.co/v2/app-registrations")!
var request = URLRequest(url: url)
request.httpMethod = "GET"
request.setValue("Bearer YOUR_ACCESS_TOKEN", forHTTPHeaderField: "Authorization")

let task = URLSession.shared.dataTask(with: request) { data, response, error in
  guard let data = data, error == nil else {
    print("Error:", error ?? "Unknown error")
    return
  }
  
  if let httpResponse = response as? HTTPURLResponse, httpResponse.statusCode == 200 {
    do {
      let jsonResponse = try JSONSerialization.jsonObject(with: data, options: [])
      print("Response JSON:", jsonResponse)
    } catch {
      print("Error parsing JSON:", error)
    }
  } else {
    print("Failed to fetch App Registrations, Status Code:", (response as? HTTPURLResponse)?.statusCode ?? 0)
  }
}
task.resume()

Kotlin

import okhttp3.OkHttpClient
import okhttp3.Request

val client = OkHttpClient()

val request = Request.Builder()
  .url("https://api.verifik.co/v2/app-registrations")
  .get()
  .addHeader("Authorization", "Bearer YOUR_ACCESS_TOKEN")
  .build()

client.newCall(request).execute().use { response ->
  if (response.isSuccessful) {
    response.body?.string()?.let { println("Response JSON: $it") }
  } else {
    println("Failed to fetch App Registrations, Status Code: ${response.code}")
  }
}

Response

200

{
  "data": [
    {
      "_id": "507f1f77bcf86cd799439011",
      "client": "507f1f77bcf86cd799439012",
      "project": "507f1f77bcf86cd799439013",
      "projectFlow": "507f1f77bcf86cd799439014",
      "status": "ONGOING",
      "email": "[email protected]",
      "countryCode": "+57",
      "phone": "1234567890",
      "currentStep": "signUpForm",
      "redFlags": 0,
      "language": "en",
      "failedEmailValidations": [],
      "failedPhoneValidations": [],
      "failedBiometricValidations": [],
      "failedDocumentValidations": [],
      "informationValidation": "507f1f77bcf86cd799439015",
      "name": "John Doe",
      "accessControlLog": "507f1f77bcf86cd799439016",
      "updatedAt": "2025-01-01T00:00:00.000Z",
      "createdAt": "2025-01-01T00:00:00.000Z",
      "__v": 1,
      "documentFace": "507f1f77bcf86cd799439017",
      "documentValidation": "507f1f77bcf86cd799439018"
    }
  ]
}

200 - Paginated

{
  "total": 12,
  "limit": 20,
  "page": 1,
  "pages": 1,
  "data": [
    {
      "_id": "507f1f77bcf86cd799439011",
      "client": "507f1f77bcf86cd799439012",
      "project": "507f1f77bcf86cd799439013",
      "projectFlow": "507f1f77bcf86cd799439014",
      "status": "ONGOING",
      "email": "[email protected]",
      "countryCode": "+57",
      "phone": "1234567890",
      "currentStep": "signUpForm",
      "redFlags": 0,
      "language": "en",
      "failedEmailValidations": [],
      "failedPhoneValidations": [],
      "failedBiometricValidations": [],
      "failedDocumentValidations": [],
      "informationValidation": "507f1f77bcf86cd799439015",
      "name": "John Doe",
      "accessControlLog": "507f1f77bcf86cd799439016",
      "updatedAt": "2025-01-01T00:00:00.000Z",
      "createdAt": "2025-01-01T00:00:00.000Z",
      "__v": 0,
      "emailValidation": "507f1f77bcf86cd799439019",
      "phoneValidation": "507f1f77bcf86cd799439020",
      "documentFace": "507f1f77bcf86cd799439021",
      "documentValidation": "507f1f77bcf86cd799439022",
      "biometricValidation": null,
      "face": null,
      "person": null,
      "compareFaceVerification": null
    }
  ]
}