Skip to content
Strent Docs

List active subscription items

POST
/v1/active_items/list
 
curl --request POST \
  --url https://api.strent.dev/v1/active_items/list \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "stripe_customer_id": "cus_123" }'

Returns Stripe-like active subscription items: the items of subscriptions Stripe reports as active, trialing, or past_due. A non-empty list means the customer has an active subscription. Derive product-specific and price-specific plan facts from the returned product and price IDs; resolve several checks from one list instead of one request per check.

This read-only POST operation is side-effect-free and semantically safe to retry, but clients should not retry automatically by default.

Authorizations

Section titled “ Authorizations ”

Request Bodyrequired

Section titled “ Request Bodyrequired ”
Media type application/json
object
stripe_customer_id
required
string
<= 255 characters /^cus_[^\s]+$/

Example 

{
  "stripe_customer_id": "cus_123"
}

Responses

Section titled “ Responses ”

200

Section titled “ 200 ”

The customer projection is ready.

Media type application/json
object
data
required
Array<object>
object
subscription
required
string
>= 1 characters
id
required
string
>= 1 characters
price
required
object
id
required
string
>= 1 characters
lookup_key
string | null
product
required
object
id
required
string
>= 1 characters
quantity
required
integer | null

Example 

{
  "data": [
    {
      "subscription": "sub_123",
      "id": "si_123",
      "price": {
        "id": "price_pro_monthly",
        "lookup_key": "pro_monthly",
        "product": {
          "id": "prod_pro"
        }
      },
      "quantity": 1
    }
  ]
}

400

Section titled “ 400 ”

The request body is invalid.

Media type application/json
object
error
required
object
code
required
string
Allowed values: VALIDATION_FAILED
message
required
string
requestId
required
string
details
object
key
additional properties
any

Example 

{
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "The request body is invalid.",
    "requestId": "req_123"
  }
}

401

Section titled “ 401 ”

The Authorization header or project API key is invalid.

Media type application/json
object
error
required
object
code
required
string
Allowed values: INVALID_AUTH_HEADER API_KEY_INVALID
message
required
string
requestId
required
string
details
object
key
additional properties
any

Example 

{
  "error": {
    "code": "INVALID_AUTH_HEADER",
    "message": "The Authorization header or project API key is invalid.",
    "requestId": "req_123"
  }
}

403

Section titled “ 403 ”

The project API key has been revoked.

Media type application/json
object
error
required
object
code
required
string
Allowed values: API_KEY_REVOKED
message
required
string
requestId
required
string
details
object
key
additional properties
any

Example 

{
  "error": {
    "code": "API_KEY_REVOKED",
    "message": "The project API key has been revoked.",
    "requestId": "req_123"
  }
}

409

Section titled “ 409 ”

The requested projection is not ready.

Media type application/json
object
error
required
object
code
required
string
Allowed values: CUSTOMER_STATE_NOT_READY
message
required
string
requestId
required
string
details
object
key
additional properties
any

Example 

{
  "error": {
    "code": "CUSTOMER_STATE_NOT_READY",
    "message": "The requested projection is not ready.",
    "requestId": "req_123"
  }
}

413

Section titled “ 413 ”

The request body is too large.

Media type application/json
object
error
required
object
code
required
string
Allowed values: VALIDATION_FAILED
message
required
string
requestId
required
string
details
object
key
additional properties
any

Example 

{
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "The request body is too large.",
    "requestId": "req_123"
  }
}

415

Section titled “ 415 ”

The request failed.

Media type application/json
object
error
required
object
code
required
string
Allowed values: VALIDATION_FAILED
message
required
string
requestId
required
string
details
object
key
additional properties
any

Example 

{
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "The request failed.",
    "requestId": "req_123"
  }
}

429

Section titled “ 429 ”

The project or pre-authentication rate limit was exceeded.

Media type application/json
object
error
required
object
code
required
string
Allowed values: RATE_LIMIT_EXCEEDED
message
required
string
requestId
required
string
details
object
key
additional properties
any

Example 

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "The project or pre-authentication rate limit was exceeded.",
    "requestId": "req_123"
  }
}

Headers

Section titled “ Headers ”
Retry-After
number

Seconds before another request is advised.

500

Section titled “ 500 ”

Strent could not complete the request.

Media type application/json
object
error
required
object
code
required
string
Allowed values: INTERNAL_ERROR
message
required
string
requestId
required
string
details
object
key
additional properties
any

Example 

{
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "Strent could not complete the request.",
    "requestId": "req_123"
  }
}