List customer enrollments
curl --request GET \
--url https://api.finosu.com/customers/{customer_id}/enrollments \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.finosu.com/customers/{customer_id}/enrollments"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.finosu.com/customers/{customer_id}/enrollments', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.finosu.com/customers/{customer_id}/enrollments",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.finosu.com/customers/{customer_id}/enrollments"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.finosu.com/customers/{customer_id}/enrollments")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.finosu.com/customers/{customer_id}/enrollments")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"items": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"type": "application",
"reference": "<string>",
"taskType": "<string>",
"status": "<string>",
"enrollmentStatus": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"closedAt": "2023-11-07T05:31:56Z",
"closeReason": "<string>"
}
],
"nextCursor": "<string>"
}Origination
List Customer Enrollments
GET
/
customers
/
{customer_id}
/
enrollments
List customer enrollments
curl --request GET \
--url https://api.finosu.com/customers/{customer_id}/enrollments \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.finosu.com/customers/{customer_id}/enrollments"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.finosu.com/customers/{customer_id}/enrollments', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.finosu.com/customers/{customer_id}/enrollments",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.finosu.com/customers/{customer_id}/enrollments"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.finosu.com/customers/{customer_id}/enrollments")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.finosu.com/customers/{customer_id}/enrollments")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"items": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"type": "application",
"reference": "<string>",
"taskType": "<string>",
"status": "<string>",
"enrollmentStatus": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"closedAt": "2023-11-07T05:31:56Z",
"closeReason": "<string>"
}
],
"nextCursor": "<string>"
}Use the customer’s external reference as
customer_id and the company’s
X-API-Key. This returns application and reactivation enrollment history without
creating, reopening, or scheduling anything. Deleted applications are excluded;
closed cycles remain visible.
limit defaults to 50 (maximum 100). Continue using nextCursor as cursor,
with the same customer and API-key company. Ordering is newest creation first,
with stable type and ID tie-breakers. The final page has nextCursor: null.
Each item includes id, type (application or reactivation), external
reference, taskType, status, enrollmentStatus (latest captured cadence’s
status, or null), createdAt, closedAt, and closeReason. Application status
and task type may be unknown; they are not inferred from another account.
For applications, closeReason contains the terminal application status when
closed; for reactivations, it contains the recorded cycle close reason.
An unknown customer returns 404. Ambiguous customer references return 409.
Malformed cursors or cursors from another customer/company return 400.
Cursors longer than 2048 characters fail request validation with 422.