---
title: Get All Subscription Statuses
framework: appstoreserverapi
role: symbol
role_heading: Web Service Endpoint
path: appstoreserverapi/get-all-subscription-statuses
---

# Get All Subscription Statuses

Get the statuses for all of a customer’s auto-renewable subscriptions in your app.

## URL

GET https://api.storekit.apple.com/inApps/v1/subscriptions/{anyTransactionId}

## Sandbox URL

GET https://api.storekit-sandbox.apple.com/inApps/v1/subscriptions/{anyTransactionId}

## Path Parameters

anyTransactionId: Any originalTransactionId, transactionId or appTransactionId that belongs to the customer for your app.

## Query Parameters

status: An optional filter that indicates the status of subscriptions to include in the response. Your query may specify more than one status query parameter.

## Response Codes

200 OK: Request succeeded. 400 Bad Request: 401 Unauthorized: The JSON Web Token (JWT) in the authorization header is invalid. For more information, see Generating JSON Web Tokens for API requests. 404 Not Found: 429 : The request exceeded the rate limit. 500 Internal Server Error:

## Mentioned in

App Store Server API changelog Identifying rate limits

## Discussion

Discussion This API returns the status for all of the customer’s subscriptions, organized by their subscription group identifier. Specify multiple values for the status query parameter to get a response that contains subscriptions with statuses that match any of the values. For example, the following request returns subscriptions that are active (status value of 1) and subscriptions that are in the Billing Grace Period (status value of 4): GET https://api.storekit.apple.com/inApps/v1/subscriptions/{anyTransactionId}?status=1&status=4

## See Also

### Subscription status

- [StatusResponse](appstoreserverapi/statusresponse.md)