DEVELOPER API

Build on Kinship

A RESTful API designed for developers who integrate with church management. API keys with granular scopes, webhook notifications for real-time sync, and an OpenAPI spec so you can generate clients in any language.

Read the Docs Get Started Free

SEE IT IN ACTION

Clean, predictable responses

Every endpoint returns well-structured JSON with consistent error handling. Here is a real request to list your members.

Request

curl -X GET https://api.usekinship.com/v1/members \
  -H "X-API-Key: sk_live_abc123..." \
  -H "Content-Type: application/json"

Response 200 OK

{
  "data": [
    {
      "id": "mbr_7x9k2m4p",
      "firstName": "Sarah",
      "lastName": "Mitchell",
      "email": "sarah@example.com",
      "status": "active",
      "joinedAt": "2025-03-15T00:00:00Z"
    }
  ],
  "pagination": {
    "cursor": "eyJpZCI6MTB9",
    "hasMore": true
  }
}

API RESOURCES

What you can build

Full CRUD access to the data that matters. Every resource follows the same conventions — learn one, know them all.

Members

Create, read, update member records. Search, filter by status/tags.

Events

List events, read details, track attendance.

Donations

Record contributions, query giving history, filter by date/member.

Groups

List groups, manage membership rosters.

Funds

Read fund configuration and details.

Families

Query household groupings and members.

Attendance

Record and retrieve attendance data.

Campuses

List multi-campus locations.

BUILT RIGHT

An API you can rely on

We built our API the way we would want to consume one. No surprises, no undocumented behavior.

RESTful JSON

Standard REST conventions, JSON in/out. Predictable resource URLs and HTTP verbs.

API Key Auth

Scoped API keys with granular permissions. Create read-only or full-access keys.

Rate Limiting

60 requests/minute with clear X-RateLimit headers. Backoff guidance in 429 responses.

Pagination

Cursor-based pagination on all list endpoints. Stable ordering, no skipped records.

Webhooks

Real-time event notifications for data changes. HMAC-signed payloads, retry logic built in.

OpenAPI Spec

Full OpenAPI 3.0 specification. Swagger UI included at /api/docs for interactive testing.

QUICK START

Up and running in minutes

1

Create your account

Sign up free — no credit card required. Your church gets a full sandbox environment.

2

Generate an API key

Head to Settings > Developer API and create a scoped API key with the permissions you need.

3

Make your first request

Use the key in the X-API-Key header. You're live.

Your first request

curl https://api.usekinship.com/v1/members \
  -H "X-API-Key: sk_live_YOUR_KEY_HERE"
Explore the full API reference

Ready to integrate?

Start free with up to 50 active members. No credit card. No sales call. No contract.

Get Started Free Read the Docs