API Reference

All endpoints

Request an API key. The key is sent to your email — no signup required. If you already have a key, the same key is re-sent.

Request

curl -X POST https://growthservice.org/api/v1/auth/request-key \
  -H "Content-Type: application/json" \
  -d '{"email": "you@company.com"}'

Response

{
  "message": "API key sent to your email."
}

List all available services with tiers and pricing. Public endpoint — no authentication required.

Request

curl https://growthservice.org/api/v1/services

Response

{
  "services": [
    {
      "id": "sales_leads",
      "name": "Sales Leads",
      "description": "Prospects who opened your website or replied...",
      "unit": "leads",
      "tiers": [
        {
          "tier": "starter",
          "label": "Starter",
          "quantity": 5,
          "quantityLabel": "5 leads guaranteed",
          "priceCents": 4000,
          "priceLabel": "$40"
        },
        {
          "tier": "growth",
          "label": "Growth",
          "quantity": 50,
          "quantityLabel": "50 leads guaranteed",
          "priceCents": 40000,
          "priceLabel": "$400"
        },
        {
          "tier": "scale",
          "label": "Scale",
          "quantity": 500,
          "quantityLabel": "500 leads guaranteed",
          "priceCents": 400000,
          "priceLabel": "$4,000"
        }
      ]
    },
    ...
  ]
}

Create an order for a service. Returns a Stripe checkout URL. Redirect the user to pay — the order is fulfilled automatically after payment.

Request

curl -X POST https://growthservice.org/api/v1/orders \
  -H "Authorization: Bearer gsk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "service": "sales_leads",
    "tier": "growth",
    "brand_url": "https://yourbrand.com",
    "description": "B2B SaaS targeting CTOs at mid-market companies"
  }'

Response

{
  "order_id": "ord_a1b2c3d4e5",
  "checkout_url": "https://checkout.stripe.com/c/pay/cs_live_..."
}

Get details and status for a specific order.

Request

curl https://growthservice.org/api/v1/orders/ord_a1b2c3d4e5 \
  -H "Authorization: Bearer gsk_YOUR_KEY"

Response

{
  "id": "ord_a1b2c3d4e5",
  "service": "sales_leads",
  "tier": "growth",
  "status": "paid",
  "amount_cents": 40000,
  "brand_url": "https://yourbrand.com",
  "description": "B2B SaaS targeting CTOs",
  "created_at": "2026-02-09T12:00:00.000Z",
  "paid_at": "2026-02-09T12:05:00.000Z"
}

Order statuses

List all orders associated with your API key.

Request

curl https://growthservice.org/api/v1/orders \
  -H "Authorization: Bearer gsk_YOUR_KEY"

Response

{
  "orders": [
    {
      "id": "ord_a1b2c3d4e5",
      "service": "sales_leads",
      "tier": "growth",
      "status": "paid",
      "amount_cents": 40000,
      "created_at": "2026-02-09T12:00:00.000Z"
    }
  ]
}

Error responses

All errors return a JSON object with an error field:

{
  "error": "Missing required field: service"
}