curl -sS -X GET 'https://apipub.firstbasehq.com/api/v1/new-joiners?page=1&size=25&sortBy=startDate&sortDirection=ASC' \
-H 'Authorization: ApiKey YOUR_API_KEY' \
-H 'Accept: application/json'import requests
url = "https://apipub.firstbasehq.com/api/v1/new-joiners"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://apipub.firstbasehq.com/api/v1/new-joiners', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));[
{
"person": {
"id": "aa000001-0000-0000-0000-000000000001",
"firstName": "Jane",
"lastName": "Doe",
"email": "jane.doe@example.com",
"startDate": "2026-09-01",
"countryCode": "US",
"status": "INVITED"
},
"equipmentReadiness": "NOT_STARTED",
"orderRef": null,
"urgency": "ON_TRACK",
"provisioningOutcome": null,
"provisioningOutcomeDate": null,
"provisioningOutcomeSource": null,
"estimatedDeliveryDate": null,
"lastReminder": null,
"reminderCount": 0,
"procurementMethod": null
},
{
"person": {
"id": "aa000002-0000-0000-0000-000000000002",
"firstName": "John",
"lastName": "Smith",
"email": "john.smith@example.com",
"startDate": "2026-08-15",
"countryCode": "US",
"status": "ACTIVE"
},
"equipmentReadiness": "ORDER_PLACED",
"orderRef": {
"id": "b0000001-0000-0000-0000-000000000001",
"status": "APPROVED",
"createdAt": "2026-08-01"
},
"urgency": "AT_RISK",
"provisioningOutcome": null,
"provisioningOutcomeDate": null,
"provisioningOutcomeSource": null,
"estimatedDeliveryDate": "2026-08-20",
"lastReminder": null,
"reminderCount": 1,
"procurementMethod": "DROPSHIP"
}
]{
"errors": [
{
"detail": "Invalid request",
"source": "request"
}
]
}{
"errors": [
{
"detail": "Invalid request",
"source": "request"
}
]
}{
"errors": [
{
"detail": "Invalid request",
"source": "request"
}
]
}List new joiners
Paginated, filterable, sortable list of new joiner rows for the organization. When startDateFrom is omitted, the domain applies a default 60-day lookback floor — supply it explicitly to widen the window beyond 60 days.
curl -sS -X GET 'https://apipub.firstbasehq.com/api/v1/new-joiners?page=1&size=25&sortBy=startDate&sortDirection=ASC' \
-H 'Authorization: ApiKey YOUR_API_KEY' \
-H 'Accept: application/json'import requests
url = "https://apipub.firstbasehq.com/api/v1/new-joiners"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://apipub.firstbasehq.com/api/v1/new-joiners', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));[
{
"person": {
"id": "aa000001-0000-0000-0000-000000000001",
"firstName": "Jane",
"lastName": "Doe",
"email": "jane.doe@example.com",
"startDate": "2026-09-01",
"countryCode": "US",
"status": "INVITED"
},
"equipmentReadiness": "NOT_STARTED",
"orderRef": null,
"urgency": "ON_TRACK",
"provisioningOutcome": null,
"provisioningOutcomeDate": null,
"provisioningOutcomeSource": null,
"estimatedDeliveryDate": null,
"lastReminder": null,
"reminderCount": 0,
"procurementMethod": null
},
{
"person": {
"id": "aa000002-0000-0000-0000-000000000002",
"firstName": "John",
"lastName": "Smith",
"email": "john.smith@example.com",
"startDate": "2026-08-15",
"countryCode": "US",
"status": "ACTIVE"
},
"equipmentReadiness": "ORDER_PLACED",
"orderRef": {
"id": "b0000001-0000-0000-0000-000000000001",
"status": "APPROVED",
"createdAt": "2026-08-01"
},
"urgency": "AT_RISK",
"provisioningOutcome": null,
"provisioningOutcomeDate": null,
"provisioningOutcomeSource": null,
"estimatedDeliveryDate": "2026-08-20",
"lastReminder": null,
"reminderCount": 1,
"procurementMethod": "DROPSHIP"
}
]{
"errors": [
{
"detail": "Invalid request",
"source": "request"
}
]
}{
"errors": [
{
"detail": "Invalid request",
"source": "request"
}
]
}{
"errors": [
{
"detail": "Invalid request",
"source": "request"
}
]
}Authorizations
Query Parameters
Response
New joiners retrieved successfully
Identifies which data source produced provisioningOutcomeDate. ORDER_DELIVERY: date comes from the latest deliveryDate on a computer order line. INVENTORY_ASSIGNMENT: date comes from the audit-derived deployedAt for deployed computer inventory. Null when provisioningOutcomeDate is null.
ORDER_DELIVERY, INVENTORY_ASSIGNMENT How this new joiner's equipment is fulfilled. WAREHOUSE when all computer lines are sourced from inventory, DROPSHIP when all are shipped directly from a vendor, MIXED when both methods are used. Null when no computer lines have a fulfilment record yet.
WAREHOUSE, DROPSHIP, MIXED