🟢GET

Search subscription contracts

Searches for subscription contracts with various filters, sorting, and pagination.

post

/subscription-contracts/search

Query parameters

pageinteger · default: 1

limitinteger · default: 600

Body

searchOrderobject

filtersobject

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'http://localhost:3002/subscription-contracts/search' \
  --header 'Content-Type: application/json' \
  --data '{"searchOrder":{},"filters":{"sort":{}}}'

200

400

200

{
  "totalCount": 1,
  "pageCount": 1,
  "data": [
    {
      "id": "text",
      "failedBillingCount": 1,
      "subscriptionTotal": 1,
      "draft": true,
      "createdAt": "text",
      "notification_at": "2025-02-20T19:09:36.541Z",
      "notified": true,
      "billingInterval": "text",
      "billingIntervalCount": 1,
      "maxCycles": 1,
      "isPrepaid": true,
      "minCycles": 1,
      "billingAnchorType": "text",
      "billingAnchorDay": 1,
      "billingAnchorMonth": 1,
      "currencyCode": "text",
      "customer": {
        "id": "text",
        "firstName": "text",
        "lastName": "text",
        "email": "text",
        "phone": "text",
        "state": "text",
        "createdAt": "text",
        "imageUrl": "text",
        "addresses": [
          {
            "id": "text",
            "address1": "text",
            "address2": "text",
            "city": "text",
            "company": "text",
            "country": "text",
            "countryCodeV2": "text",
            "firstName": "text",
            "lastName": "text",
            "phone": "text",
            "province": "text",
            "provinceCode": "text",
            "zip": "text"
          }
        ],
        "tags": [
          "text"
        ]
      },
      "deliveryPrice": 1,
      "status": "text",
      "shop": "text",
      "originOrder": {
        "id": "text",
        "legacyResourceId": "text",
        "name": "text",
        "createdAt": "text",
        "amount": "text"
      },
      "orderIds": [
        "text"
      ],
      "lines": [
        {
          "id": "text",
          "sku": "text",
          "title": "text",
          "productId": "text",
          "variantId": "text",
          "variantTitle": "text",
          "sellingPlanName": "text",
          "displayName": "text",
          "sellingPlanId": "text",
          "quantity": 1,
          "taxable": true,
          "handle": "text",
          "requiresShipping": true,
          "variantImage": {
            "url": "text"
          },
          "currentPrice": {
            "amount": "text",
            "currencyCode": "text"
          },
          "lineDiscountedPrice": {
            "amount": "text",
            "currencyCode": "text"
          },
          "customAttributes": [
            {
              "key": "text",
              "value": "text"
            }
          ],
          "discountAllocations": [
            {
              "discount": "text",
              "amount": {
                "amount": "text",
                "currencyCode": "text"
              }
            }
          ],
          "pricingPolicy": {
            "basePrice": {
              "amount": "text",
              "currencyCode": "text"
            },
            "cycleDiscounts": [
              {
                "adjustmentType": "text",
                "afterCycle": 1,
                "computedPrice": {
                  "amount": "text",
                  "currencyCode": "text"
                },
                "adjustmentValue": {
                  "SellingPlanPricingPolicyPercentageValue": {
                    "percentage": "text"
                  }
                }
              }
            ]
          }
        }
      ],
      "addons": [
        {
          "id": "text",
          "sku": "text",
          "title": "text",
          "productId": "text",
          "variantId": "text",
          "variantTitle": "text",
          "sellingPlanName": "text",
          "displayName": "text",
          "sellingPlanId": "text",
          "quantity": 1,
          "taxable": true,
          "handle": "text",
          "requiresShipping": true,
          "variantImage": {
            "url": "text"
          },
          "currentPrice": {
            "amount": "text",
            "currencyCode": "text"
          },
          "lineDiscountedPrice": {
            "amount": "text",
            "currencyCode": "text"
          },
          "customAttributes": [
            {
              "key": "text",
              "value": "text"
            }
          ],
          "discountAllocations": [
            {
              "discount": "text",
              "amount": {
                "amount": "text",
                "currencyCode": "text"
              }
            }
          ],
          "pricingPolicy": {
            "basePrice": {
              "amount": "text",
              "currencyCode": "text"
            },
            "cycleDiscounts": [
              {
                "adjustmentType": "text",
                "afterCycle": 1,
                "computedPrice": {
                  "amount": "text",
                  "currencyCode": "text"
                },
                "adjustmentValue": {
                  "SellingPlanPricingPolicyPercentageValue": {
                    "percentage": "text"
                  }
                }
              }
            ]
          }
        }
      ],
      "customAttributes": [
        {
          "key": "text",
          "value": "text"
        }
      ],
      "deliveryMethod": {
        "shippingOption": {
          "code": "text",
          "description": "text"
        }
      }
    }
  ]
}

A list of subscription contracts with pagination details.

Retrieve a subscription contract

Fetches a single subscription contract by its ID along with its billing attempts.

get

/subscription-contracts/{contractId}

Path parameters

contractIdstringrequired

The subscription contract ID

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'http://localhost:3002/subscription-contracts/{contractId}'

200

400

200

{
  "data": {
    "id": "text",
    "failedBillingCount": 1,
    "subscriptionTotal": 1,
    "draft": true,
    "createdAt": "text",
    "notification_at": "2025-02-20T19:09:36.541Z",
    "notified": true,
    "billingInterval": "text",
    "billingIntervalCount": 1,
    "maxCycles": 1,
    "isPrepaid": true,
    "minCycles": 1,
    "billingAnchorType": "text",
    "billingAnchorDay": 1,
    "billingAnchorMonth": 1,
    "currencyCode": "text",
    "customer": {
      "id": "text",
      "firstName": "text",
      "lastName": "text",
      "email": "text",
      "phone": "text",
      "state": "text",
      "createdAt": "text",
      "imageUrl": "text",
      "addresses": [
        {
          "id": "text",
          "address1": "text",
          "address2": "text",
          "city": "text",
          "company": "text",
          "country": "text",
          "countryCodeV2": "text",
          "firstName": "text",
          "lastName": "text",
          "phone": "text",
          "province": "text",
          "provinceCode": "text",
          "zip": "text"
        }
      ],
      "tags": [
        "text"
      ]
    },
    "deliveryPrice": 1,
    "status": "text",
    "shop": "text",
    "originOrder": {
      "id": "text",
      "legacyResourceId": "text",
      "name": "text",
      "createdAt": "text",
      "amount": "text"
    },
    "orderIds": [
      "text"
    ],
    "lines": [
      {
        "id": "text",
        "sku": "text",
        "title": "text",
        "productId": "text",
        "variantId": "text",
        "variantTitle": "text",
        "sellingPlanName": "text",
        "displayName": "text",
        "sellingPlanId": "text",
        "quantity": 1,
        "taxable": true,
        "handle": "text",
        "requiresShipping": true,
        "variantImage": {
          "url": "text"
        },
        "currentPrice": {
          "amount": "text",
          "currencyCode": "text"
        },
        "lineDiscountedPrice": {
          "amount": "text",
          "currencyCode": "text"
        },
        "customAttributes": [
          {
            "key": "text",
            "value": "text"
          }
        ],
        "discountAllocations": [
          {
            "discount": "text",
            "amount": {
              "amount": "text",
              "currencyCode": "text"
            }
          }
        ],
        "pricingPolicy": {
          "basePrice": {
            "amount": "text",
            "currencyCode": "text"
          },
          "cycleDiscounts": [
            {
              "adjustmentType": "text",
              "afterCycle": 1,
              "computedPrice": {
                "amount": "text",
                "currencyCode": "text"
              },
              "adjustmentValue": {
                "SellingPlanPricingPolicyPercentageValue": {
                  "percentage": "text"
                }
              }
            }
          ]
        }
      }
    ],
    "addons": [
      {
        "id": "text",
        "sku": "text",
        "title": "text",
        "productId": "text",
        "variantId": "text",
        "variantTitle": "text",
        "sellingPlanName": "text",
        "displayName": "text",
        "sellingPlanId": "text",
        "quantity": 1,
        "taxable": true,
        "handle": "text",
        "requiresShipping": true,
        "variantImage": {
          "url": "text"
        },
        "currentPrice": {
          "amount": "text",
          "currencyCode": "text"
        },
        "lineDiscountedPrice": {
          "amount": "text",
          "currencyCode": "text"
        },
        "customAttributes": [
          {
            "key": "text",
            "value": "text"
          }
        ],
        "discountAllocations": [
          {
            "discount": "text",
            "amount": {
              "amount": "text",
              "currencyCode": "text"
            }
          }
        ],
        "pricingPolicy": {
          "basePrice": {
            "amount": "text",
            "currencyCode": "text"
          },
          "cycleDiscounts": [
            {
              "adjustmentType": "text",
              "afterCycle": 1,
              "computedPrice": {
                "amount": "text",
                "currencyCode": "text"
              },
              "adjustmentValue": {
                "SellingPlanPricingPolicyPercentageValue": {
                  "percentage": "text"
                }
              }
            }
          ]
        }
      }
    ],
    "customAttributes": [
      {
        "key": "text",
        "value": "text"
      }
    ],
    "deliveryMethod": {
      "shippingOption": {
        "code": "text",
        "description": "text"
      }
    }
  },
  "billingAttempts": [
    {
      "id": "text",
      "subscription_contract_id": "text",
      "created_at": "2025-02-20T19:09:36.541Z",
      "status": "text",
      "errorMessage": "text"
    }
  ]
}

A single subscription contract with billing attempts

Retrieve billing attempts

Fetches billing attempts, optionally filtered by shop and customer ID, with support for pagination.

get

/subscriptions/attempts

Query parameters

shopstringrequired

The shop domain associated with the billing attempts.

customerIdstring

The customer ID to filter billing attempts by.

pageinteger · default: 1

The page number for pagination.

limitinteger · default: 10

The number of items per page for pagination.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'http://localhost:3002/subscriptions/attempts?shop=text'

200

500

200

{
  "total": 1,
  "page": 1,
  "limit": 1,
  "pageCount": 1,
  "data": [
    {
      "id": "text",
      "shop": "text",
      "completed_at": "2025-02-20T19:09:36.541Z",
      "created_at": "2025-02-20T19:09:36.541Z",
      "subscription_contract_id": "text",
      "customer_id": "text",
      "email": "text",
      "customer_name": "text",
      "customer_legacy_id": "text",
      "error_code": "text",
      "error_message": "text",
      "origin_time": "2025-02-20T19:09:36.541Z",
      "order_id": "text",
      "order_name": "text",
      "order_total": "text",
      "ready": true,
      "fulfillment_orders": [
        {
          "id": "text",
          "createdAt": "2025-02-20T19:09:36.541Z",
          "fulfillAt": "2025-02-20T19:09:36.541Z",
          "fulfillBy": "text",
          "status": "text",
          "updatedAt": "2025-02-20T19:09:36.541Z",
          "destination_city": "text",
          "destination_zip": "text"
        }
      ],
      "line_items": [
        {
          "discountedUnitPriceSet": "text",
          "discountedTotalSet": "text",
          "id": "text",
          "imageUrl": "text",
          "productId": "text",
          "productTitle": "text",
          "productVariantId": "text",
          "productVariantTitle": "text",
          "sellingPlanId": "text",
          "quantity": 1,
          "sku": "text"
        }
      ]
    }
  ]
}

A list of billing attempts.