GET
/
subscriptions
LAGO_URL="https://api.getlago.com"
API_KEY="__YOUR_API_KEY__"

curl --location --request GET "$LAGO_URL/api/v1/subscriptions?external_customer_id=123&plan_code=starter&status[]=pending" \
  --header "Authorization: Bearer $API_KEY"
{
  "subscriptions": [
    {
      "lago_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
      "external_id": "5eb02857-a71e-4ea2-bcf9-57d3a41bc6ba",
      "lago_customer_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
      "external_customer_id": "5eb02857-a71e-4ea2-bcf9-57d3a41bc6ba",
      "billing_time": "anniversary",
      "name": "Repository A",
      "plan_code": "premium",
      "status": "active",
      "created_at": "2022-08-08T00:00:00Z",
      "canceled_at": "2022-09-14T16:35:31Z",
      "started_at": "2022-08-08T00:00:00Z",
      "ending_at": "2022-10-08T00:00:00Z",
      "subscription_at": "2022-08-08T00:00:00Z",
      "terminated_at": "2022-09-14T16:35:31Z",
      "previous_plan_code": "<string>",
      "next_plan_code": "<string>",
      "downgrade_plan_date": "2022-04-30",
      "trial_ended_at": "2022-08-08T00:00:00Z"
    }
  ],
  "meta": {
    "current_page": 2,
    "next_page": 3,
    "prev_page": 1,
    "total_pages": 4,
    "total_count": 70
  }
}
LAGO_URL="https://api.getlago.com"
API_KEY="__YOUR_API_KEY__"

curl --location --request GET "$LAGO_URL/api/v1/subscriptions?external_customer_id=123&plan_code=starter&status[]=pending" \
  --header "Authorization: Bearer $API_KEY"

Authorizations

Authorization
string
headerrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

page
integer

Page number.

per_page
integer

Number of records per page.

external_customer_id
string

The customer external unique identifier (provided by your own application)

plan_code
string

The unique code representing the plan to be attached to the customer. This code must correspond to the code property of one of the active plans.

status[]
enum<string>[]

If the field is not defined, Lago will return only active subscriptions. However, if you wish to fetch subscriptions by different status you can define them in a status[] query param. Available filter values: pending, canceled, terminated, active.

Available options:
pending,
canceled,
terminated,
active

Response

200 - application/json
subscriptions
object[]
required
meta
object
required