Prices

A price is how much you charge for a product and at what cadence. A product can have many prices (monthly, yearly, tiered test/live equivalents).

POST/v1/prices

Create a price attached to a product. Use type "one_time" for checkout of a single purchase or "recurring" for subscription plans.

Body Parameters

Name	Type		Description
`product`	string	required	The product id this price belongs to.
`unit_amount`	number	required	Amount in the smallest currency unit. Must be a positive integer.
`type`	string	required	Either "recurring" or "one_time".
`currency`	string		ISO 4217 currency code. Defaults to "ils".
`tax_mode`	string		"inclusive" (default) means unit_amount already includes VAT. "exclusive" means VAT is added on top at charge time.
`recurring`	object		Required when type is "recurring". Describes the billing cadence.
`interval`	string		Either "month" or "year".
`interval_count`	number		Number of intervals between renewals. Defaults to 1.
`trial_period_days`	number		Free-trial length in days. When set, the first charge is deferred.
`metadata`	object		Set of key-value pairs you can attach to the object for your own use. Returned as-is on retrieval.

Request

curl -X POST "https://api.ching.co.il/v1/prices" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "product": "example_product",
  "unit_amount": 0,
  "type": "example_type",
  "currency": "example_currency",
  "tax_mode": "example_tax_mode",
  "recurring": {},
  "metadata": {}
}'

Response

{
  "success": true,
  "data": {
    "id": "price_QA8qF3B3VIqE",
    "object": "price",
    "product": "prod_Lkt0TxOhGNMY",
    "currency": "ils",
    "unit_amount": 9900,
    "tax_mode": "inclusive",
    "type": "recurring",
    "recurring": {
      "interval": "month",
      "interval_count": 1,
      "trial_period_days": null
    },
    "metadata": {},
    "livemode": false,
    "created": "2026-04-10T08:01:00.000Z"
  }
}

GET/v1/prices

List the 100 most recent prices, newest first. Optionally filter by product.

Query Parameters

Name	Type		Description
`product`	string		Restrict to prices belonging to this product.

Request

curl -X GET "https://api.ching.co.il/v1/prices" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response

{
  "success": true,
  "data": [
    {
      "id": "price_QA8qF3B3VIqE",
      "object": "price",
      "product": "prod_Lkt0TxOhGNMY",
      "currency": "ils",
      "unit_amount": 9900,
      "tax_mode": "inclusive",
      "type": "recurring",
      "recurring": {
        "interval": "month",
        "interval_count": 1,
        "trial_period_days": null
      },
      "metadata": {},
      "livemode": false,
      "created": "2026-04-10T08:01:00.000Z"
    }
  ]
}

GET/v1/prices/:id

Retrieve a price by its id.

Path Parameters

Name	Type		Description
`id`	string	required	The price id.

Request

curl -X GET "https://api.ching.co.il/v1/prices/:id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response

{
  "success": true,
  "data": {
    "id": "price_QA8qF3B3VIqE",
    "object": "price",
    "product": "prod_Lkt0TxOhGNMY",
    "currency": "ils",
    "unit_amount": 9900,
    "tax_mode": "inclusive",
    "type": "recurring",
    "recurring": {
      "interval": "month",
      "interval_count": 1,
      "trial_period_days": null
    },
    "metadata": {},
    "livemode": false,
    "created": "2026-04-10T08:01:00.000Z"
  }
}