Save check-ins
Creates check-in records. The API automatically deduplicates based on member, facility, and timestamp.
Parameters
-
check_ins
arrayrequiredArray of Check-In objects to save. Recommended maximum: 1000 items per request for optimal performance. The API automatically batches items for processing. Each item must include either
facility_id(required if not usinglinking_identifier) orlinking_identifier(required if not usingfacility_id).
Returns
Returns a simple message confirming the sync operation.
Request
curl -X POST https://partner-api.performancehub.co/partner/v1/check-ins \
-u sk_live_YOUR_PARTNER_SECRET_KEY: \
-H "Content-Type: application/json" \
-d '{
"check_ins": [
{
// "check_in_id": "checkin_abc123", // Optional - auto-generated from member_id + timestamp if not provided
"member_id": "mem_12345",
"facility_id": "550e8400-e29b-41d4-a716-446655440000",
// "linking_identifier": "branch_downtown", // If using linking identifier
"check_in_type": "member",
"source": "rfid",
"timestamp": "2025-01-20T08:45:30Z"
}
]
}'
Response
Returns a success message with metadata about the sync operation.
{
"message": "Check-in sync successful.",
"metadata": {
"success": 523,
"skipped": 3,
"skipped_items": [
{
"member_id": "member_789",
"facility_id": null,
"reason": "No matching facility_id for the linking_identifier"
}
]
}
}
Metadata fields:
- success - Number of check-ins successfully processed
- skipped - Number of check-ins skipped (if any)
- skipped_items - Array of skipped check-ins with reasons (if any)
- dry-run - Boolean flag if using dryrun key type (if applicable)