Introduction

The Grouping API allows you to integrate group dating functionality into your applications. Create groups, manage matches, handle events, and build powerful social experiences.

Features

• Group creation and management
• Matchmaking algorithms
• Real-time chat integration
• Event planning and coordination
• User authentication and profiles

Authentication

All API requests require authentication using your API key. Include it in the Authorization header:

curl https://api.groupingokon.com/v1/groups \
  -H "Authorization: Bearer YOUR_API_KEY"

Getting Your API Key

1. Sign up for a Grouping account
2. Navigate to your dashboard
3. Go to API Settings
4. Generate a new API key

Quick Start

Get started with a simple example in your preferred language:

const response = await fetch('https://api.groupingokon.com/v1/groups', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  }
});

const data = await response.json();
console.log(data);

import requests

headers = {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
}

response = requests.get(
    'https://api.groupingokon.com/v1/groups',
    headers=headers
)

data = response.json()
print(data)

curl https://api.groupingokon.com/v1/groups \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Groups

Manage groups of users for matching and activities.

List Groups

Parameters

Example Request

curl https://api.groupingokon.com/v1/groups?limit=10&interest=hiking \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "data": [
    {
      "id": "grp_123",
      "name": "Hiking Enthusiasts",
      "members": 8,
      "interests": ["hiking", "outdoors", "adventure"],
      "created_at": "2024-01-15T10:30:00Z"
    }
  ],
  "pagination": {
    "limit": 10,
    "offset": 0,
    "total": 42
  }
}

Create Group

Request Body

{
  "name": "Coffee Lovers",
  "description": "Weekly coffee meetups",
  "interests": ["coffee", "social", "food"],
  "member_ids": ["usr_123", "usr_456"]
}

Matches

Retrieve and manage group matches.

Get Matches

curl https://api.groupingokon.com/v1/matches \
  -H "Authorization: Bearer YOUR_API_KEY"

API Playground

Test API endpoints directly in your browser.

// Click "Run" to test the endpoint

Error Codes

The API uses standard HTTP status codes and returns detailed error messages.