EliteCircle API & Postman Collection

Overview

The EliteCircle API provides programmatic access to core platform resources including member management, subscription billing, course content delivery, and usage analytics. All requests require a valid API key or OAuth 2.0 bearer token.

Base Configuration

BASE_URL = https://api.elitecircle.com/v1
AUTH_HEADER = Authorization: Bearer <api_key>
CONTENT_TYPE = application/json

Authentication

Access to the API is secured via Bearer Token authentication. You can generate API keys from your EliteCircle Developer Dashboard under Settings → API Keys.

cURL Example

curl -X GET https://api.elitecircle.com/v1/members \
  -H "Authorization: Bearer ek_live_7x9a2b4c6d8e0f1g2h3j" \
  -H "Content-Type: application/json"

Important: Never expose secret keys in client-side code. Use ek_test_ keys for development and ek_live_ for production.

Members

GET /members

List all members ▼

Retrieve a paginated list of members. Supports filtering by subscription status and join date.

Parameter	Type	Description
limit	integer	Results per page (default: 20, max: 100)
status	string	Filter by: `active`, `trial`, `canceled`
sort	string	Sort by: `created_at`, `name`, `spend_total`

Response (200 OK)

{
  "data": [
    {
      "id": "mem_9a8b7c6d5e4f",
      "email": "sarah.chen@example.com",
      "name": "Sarah Chen",
      "status": "active",
      "subscription_tier": "pro",
      "created_at": "2024-11-15T08:30:00Z"
    }
  ],
  "meta": { "total": 12450, "page": 1, "limit": 20 }
}

POST /members

Create new member ▼

Provision a new member account. Triggers welcome email and initial onboarding flow.

Request Body

{
  "email": "dev@example.com",
  "name": "Developer User",
  "tier": "starter",
  "trial_days": 14,
  "metadata": { "source": "api", "referral": "campus_tech" }
}

Subscriptions

POST /subscriptions

Upgrade / Change plan ▼

Change a member's subscription tier. Handles proration automatically via Stripe integration.

Request Body

{
  "member_id": "mem_9a8b7c6d5e4f",
  "tier": "professional",
  "billing_cycle": "monthly",
  "prorate": true
}

Postman Collection

Import the official EliteCircle Postman collection to quickly test endpoints, automate workflows, and generate SDKs.

P

EliteCircle API v1 Collection

34 Requests · 8 Environments · Last Updated: Oct 2025

JSON Collection (v2.1.0)

{
  "info": {
    "name": "EliteCircle API v1",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "description": "Official API collection for EliteCircle membership and subscription platform."
  },
  "auth": {
    "type": "bearer",
    "bearer": [{ "key": "token", "value": "{{elite_api_key}}", "type": "string" }]
  },
  "variable": [
    { "key": "base_url", "value": "https://api.elitecircle.com/v1", "type": "string" }
  ],
  "item": [
    {
      "name": "Members",
      "item": [
        {
          "name": "List Members",
          "request": {
            "method": "GET",
            "header": [],
            "url": { "raw": "{{base_url}}/members?limit=20&status=active", "host": ["{{base_url}}"], "path": ["members"], "query": [{ "key": "limit", "value": "20" }, { "key": "status", "value": "active" }] }
          }
        },
        {
          "name": "Create Member",
          "request": {
            "method": "POST",
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "body": { "mode": "raw", "raw": "{\n  \"email\": \"new.user@company.io\",\n  \"name\": \"Test User\",\n  \"tier\": \"starter\",\n  \"trial_days\": 14\n}" },
            "url": { "raw": "{{base_url}}/members", "host": ["{{base_url}}"], "path": ["members"] }
          }
        }
      ]
    },
    {
      "name": "Subscriptions",
      "item": [
        {
          "name": "Upgrade Plan",
          "request": {
            "method": "POST",
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "body": { "mode": "raw", "raw": "{\n  \"member_id\": \"mem_9a8b7c6d5e4f\",\n  \"tier\": \"professional\",\n  \"billing_cycle\": \"monthly\"\n}" },
            "url": { "raw": "{{base_url}}/subscriptions", "host": ["{{base_url}}"], "path": ["subscriptions"] }
          }
        }
      ]
    }
  ]
}

Rate Limits & Errors

API requests are limited to 1,000 requests per minute per API key. Exceeding this returns 429 Too Many Requests. Always check the X-RateLimit-Remaining header.

Status	Code	Description
200	OK	Request successful
400	Bad Request	Invalid parameters or malformed JSON
401	Unauthorized	Missing or invalid API key
404	Not Found	Resource does not exist
429	Rate Limited	Too many requests, retry after `Retry-After` header
500	Server Error	Internal platform error, contact support