List All Prices

GET

/v1/prices

Retrieves a paginated list of prices.


Filter parameters

variant_id

Return only prices associated with the variant with this ID.


curl "https://api.lemonsqueezy.com/v1/prices" \
  -H 'Accept: application/vnd.api+json' \
  -H 'Content-Type: application/vnd.api+json' \
  -H 'Authorization: Bearer {api_key}'
curl "https://api.lemonsqueezy.com/v1/prices?filter[variant_id]=11" \
  -H 'Accept: application/vnd.api+json'  \
  -H 'Content-Type: application/vnd.api+json' \
  -H 'Authorization: Bearer {api_key}'

Returns

Returns a paginated list of Price objects ordered by created_at in descending order.

{
  "meta": {
    "page": {
      "currentPage": 1,
      "from": 1,
      "lastPage": 1,
      "perPage": 10,
      "to": 10,
      "total": 10
    }
  },
  "jsonapi": {
    "version": "1.0"
  },
  "links": {
    "first": "https://api.lemonsqueezy.com/v1/prices?page%5Bnumber%5D=1&page%5Bsize%5D=10&sort=-created_at",
    "last": "https://api.lemonsqueezy.com/v1/prices?page%5Bnumber%5D=1&page%5Bsize%5D=10&sort=-created_at"
  },
  "data": [
    {
      "type": "prices",
      "id": "1",
      "attributes": {
        "variant_id": 1,
        "category": "subscription",
        "scheme": "graduated",
        "usage_aggregation": null,
        "unit_price": 999,
        "unit_price_decimal": null,
        "setup_fee_enabled": false,
        "setup_fee": null,
        "package_size": 1,
        "tiers": [
          {
            "last_unit": 2,
            "unit_price": 10000,
            "unit_price_decimal": null,
            "fixed_fee": 1000
          },
          {
            "last_unit": "inf",
            "unit_price": 1000,
            "unit_price_decimal": null,
            "fixed_fee": 1000
          }
        ],
        "renewal_interval_unit": "year",
        "renewal_interval_quantity": 1,
        "trial_interval_unit": "day",
        "trial_interval_quantity": 30,
        "min_price": null,
        "suggested_price": null,
        "tax_code": "eservice",
        "created_at": "2023-05-24T14:15:06.000000Z",
        "updated_at": "2023-06-24T14:44:38.000000Z"
      },
      "relationships": {
        "variant": {
          "links": {
            "related": "https://api.lemonsqueezy.com/v1/prices/1/variant",
            "self": "https://api.lemonsqueezy.com/v1/prices/1/relationships/variant"
          }
        }
      },
      "links": {
        "self": "https://api.lemonsqueezy.com/v1/prices/1"
      }
    },
    {...},
    {...},
  ]
}

Was this page helpful?