In2Touch
API v1
Back to sign in

API Reference

REST endpoints powering the Volunteer Hub. All responses are JSON; authentication is bearer-token over HTTPS.

Authentication
curl https://api.in2touch.app/v1/matches \
  -H "Authorization: Bearer YOUR_API_KEY"
GET

/api/v1/users

List all volunteers

[{ "id":"u-ref-1","name":"Alex Morgan","role":"referee" }]
POST

/api/v1/users

Invite a new volunteer

{ "id":"u-ref-99","invitedAt":"2026-06-15T10:00:00Z" }
GET

/api/v1/matches

List matches (filterable by date, venue, status)

[{ "id":"m-1","status":"confirmed" }]
POST

/api/v1/matches

Create a new match

{ "id":"m-100","status":"scheduled" }
PATCH

/api/v1/matches/:id

Assign referee or update status

{ "id":"m-100","refereeId":"u-ref-1","status":"confirmed" }
GET

/api/v1/venues

List venues

[{ "id":"v-1","name":"Battersea Park","pitches":4 }]
POST

/api/v1/availability

Set referee availability

{ "ok":true }
POST

/api/v1/announcements

Broadcast a message

{ "id":"an-50","sentTo":47 }
POST

/api/v1/incidents

Log an incident

{ "id":"i-20","status":"open" }
GET

/api/v1/reports/weekly

Operational metrics

{ "matches":42,"incidents":3,"activeRefs":58 }