Administration

Negotiated pricing

Tiered postpaid agreements with clients. Superusers only.

apihttps://api.ideardev.com/api/v1

List of agreements.

api.ideardev.com

curl "https://api.ideardev.com/api/v1/pricing_agreements" \
  -H "Authorization: Bearer $IDEARDEV_TOKEN"

GET/pricing_agreements/{id}

Agreement details.

api.ideardev.com

idpath

curl "https://api.ideardev.com/api/v1/pricing_agreements/44" \
  -H "Authorization: Bearer $IDEARDEV_TOKEN"

POST/pricing_agreements

Creates an agreement.

api.ideardev.com

namebody

base_fee_usdbody

included_creditsbody

billing_daybody

tiersbody

curl -X POST "https://api.ideardev.com/api/v1/pricing_agreements" \
  -H "Authorization: Bearer $IDEARDEV_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Client A",
  "base_fee_usd": 200,
  "included_credits": 5000,
  "billing_day": 1,
  "tiers": [
    {
      "from_units": 0,
      "to_units": 10000,
      "unit_price_usd": 0.02
    },
    {
      "from_units": 10000,
      "to_units": null,
      "unit_price_usd": 0.015
    }
  ]
}'

PATCH/pricing_agreements/{id}

Edits the agreement.

api.ideardev.com

idpath

curl -X PATCH "https://api.ideardev.com/api/v1/pricing_agreements/44" \
  -H "Authorization: Bearer $IDEARDEV_TOKEN"

DELETE/pricing_agreements/{id}

Deletes the agreement.

api.ideardev.com

idpath

curl -X DELETE "https://api.ideardev.com/api/v1/pricing_agreements/44" \
  -H "Authorization: Bearer $IDEARDEV_TOKEN"

GET/pricing_agreements/{id}/periods

Billed periods.

api.ideardev.com

idpath

curl "https://api.ideardev.com/api/v1/pricing_agreements/44/periods" \
  -H "Authorization: Bearer $IDEARDEV_TOKEN"

POST/pricing_agreements/simulate

Calculates the charge for a volume without saving anything.

api.ideardev.com

unitsbody

curl -X POST "https://api.ideardev.com/api/v1/pricing_agreements/simulate" \
  -H "Authorization: Bearer $IDEARDEV_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "units": 25000
}'

GET/pricing_agreements/clients

Users that can be linked to an agreement.

api.ideardev.com

curl "https://api.ideardev.com/api/v1/pricing_agreements/clients" \
  -H "Authorization: Bearer $IDEARDEV_TOKEN"

curl -X POST "https://api.ideardev.com/api/v1/pricing_agreements" \ -H "Authorization: Bearer $IDEARDEV_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "name": "Client A", "base_fee_usd": 200, "included_credits": 5000, "billing_day": 1, "tiers": [ { "from_units": 0, "to_units": 10000, "unit_price_usd": 0.02 }, { "from_units": 10000, "to_units": null, "unit_price_usd": 0.015 } ] }'