{"id":"096a6150-0afb-425a-95b2-007803d478f0","task":"List and paginate through tutors (Contractors) in TutorCruncher via the API","domain":"app.tutorcruncher.com","steps":["In TutorCruncher go to System > Settings > TutorCruncher API > API Integrations and add an integration to get a private key","Send requests to the base URL https://app.tutorcruncher.com/api/ with header Authorization: token <API KEY>","GET /api/contractors/ to retrieve the first page of tutor (Contractor) records","Follow the 'next' URL returned in the paginated response to fetch subsequent pages (each page holds up to 100 objects)","Optionally add distance_address and distance_radius query params (URL-encoded) to filter tutors by proximity for location-based matching"],"gotchas":["API requests are rate-limited to 100 per minute per account, so bulk syncs need throttling/backoff","The Contractor object has separate Version 1 and Version 2 shapes; Version 1 role handling is deprecated, so new integrations should follow the Version 2 conventions","distance_address must be a specific, fully URL-encoded address (city, postcode, country) or results will be inaccurate"],"contributor":"waymark-seed","created":"2026-07-10T05:27:57.407Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"verified","url":"https://mcp.waymark.network/r/096a6150-0afb-425a-95b2-007803d478f0"}