API Reference

Base URL: https://growthservice.org/api/v1

All endpoints

Method	Path	Description	Auth
GET	/services	List all services with pricing	No
POST	/orders	Create an order	Email
GET	/orders/:id	Get order details	Email
GET	/orders	List all your orders	Email

GET/servicesPublic

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_engaged_leads",
      "name": "Engaged Sales Leads",
      "description": "Prospects who visited your website after receiving outreach...",
      "unit": "leads",
      "unitPriceCents": 800,
      "tiers": [
        {
          "tier": "starter",
          "quantity": 1,
          "priceCents": 800,
          "priceLabel": "$8"
        },
        ...
      ]
    },
    ...
  ]
}

POST/ordersEmail required

Create an order for a service. Specify a budget — the server computes the quantity. Returns a Stripe checkout URL.

Parameters

Name	Type	Required	Description
email	string	Required	Your email address
service	string	Required	Service ID: sales_engaged_leads, sales_warm_leads, pr_engaged_leads, or pr_hot_leads
budget_usd	number	Required	Budget in USD. Quantity = floor(budget / unit_price). Charged amount may be less than budget.
frequency	string	Optional	Billing frequency: one_off (default), weekly, monthly, or quarterly
brand_url	string	Optional	Your brand website URL
description	string	Optional	Brief description of your brand and what you want (1-2 lines)

Request

curl -X POST https://growthservice.org/api/v1/orders \
  -H "Content-Type: application/json" \
  -d '{
    "email": "you@company.com",
    "service": "sales_engaged_leads",
    "budget_usd": 80,
    "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_...",
  "quantity": 10,
  "amount_cents": 8000,
  "budget_usd": 80,
  "service": "sales_engaged_leads"
}

Open the checkout_url in a browser to complete payment via Stripe. After payment, the order status updates to paid and fulfillment starts automatically.

GET/orders/:idEmail required

Get details and status for a specific order.

Parameters

Name	Type	Required	Description
id	string	Required	Order ID (in URL path)
email	string	Required	Your email (query param)

Request

curl "https://growthservice.org/api/v1/orders/ord_a1b2c3d4e5?email=you@company.com"

Response

{
  "id": "ord_a1b2c3d4e5",
  "service": "sales_engaged_leads",
  "quantity": 10,
  "frequency": "one_off",
  "status": "paid",
  "amount_cents": 8000,
  "budget_usd": 80,
  "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

Status	Meaning
`pending_payment`	Order created, awaiting payment
`paid`	Payment received, fulfillment started
`fulfilled`	All guaranteed results delivered
`refunded`	Order refunded per guarantee terms

GET/ordersEmail required

List all orders associated with your email.

Parameters

Name	Type	Required	Description
email	string	Required	Your email (query param)

Request

curl "https://growthservice.org/api/v1/orders?email=you@company.com"

Response

{
  "orders": [
    {
      "id": "ord_a1b2c3d4e5",
      "service": "sales_engaged_leads",
      "quantity": 10,
      "frequency": "one_off",
      "status": "paid",
      "amount_cents": 8000,
      "budget_usd": 80,
      "created_at": "2026-02-09T12:00:00.000Z"
    }
  ]
}

Error responses

All errors return a JSON object with an error field:

{
  "error": "budget_usd must be a positive number"
}

Code	Meaning
400	Bad request — check params
403	Email doesn't match the order
404	Order not found
429	Rate limited — slow down
500	Server error — try again