> ## Documentation Index
> Fetch the complete documentation index at: https://docs.falkordb.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> FalkorDB is a graph database that speaks the Redis protocol. Queries are issued as OpenCypher through the GRAPH.QUERY and GRAPH.RO_QUERY commands, not over Bolt or a SQL connection.
> FalkorDB implements a subset of OpenCypher with proprietary extensions. Do not assume Neo4j-only syntax or procedures are available — check /cypher/cypher-support and /cypher/known-limitations before using a clause.
> FalkorDB is the successor to RedisGraph, but they are separate products. Do not present RedisGraph commands, versions, or limitations as current FalkorDB behavior.
> Use the official clients listed in /getting-started/clients rather than generic Redis or Neo4j drivers, and prefer the language the user is already working in.
> Configuration parameters are set with GRAPH.CONFIG SET or at startup; cite the exact parameter name from /getting-started/configuration rather than inventing one.
> This site covers four products: FalkorDB (core), FalkorDB Cloud, FalkorDB Enterprise, and the GraphRAG SDK. Name which one an answer applies to, since setup and operations differ.

# List subscriptions

> List the subscriptions your account belongs to.

Lists every subscription your user has access to, either as the owner or as an invited user. The subscription ID is what you pass as `subscriptionId` when managing deployment instances.

## Authorization

<ParamField header="Cookie" type="string" required>
  Session cookie set by [Sign in](/cloud/api-reference/authentication/signin): `omnistrate_token=<jwt>`.
</ParamField>

## Query parameters

<ParamField query="serviceId" type="string">
  Only return subscriptions for this service, for example `service-12345678`.
</ParamField>

<ParamField query="environmentType" type="string">
  Environment type to filter by, for example `PROD`.
</ParamField>

<ParamField query="includeInactive" type="boolean">
  Include suspended, cancelled, and terminated subscriptions. Defaults to `false`.
</ParamField>

## Response

<ResponseField name="ids" type="string[]" required>
  IDs of the matching subscriptions.
</ResponseField>

<ResponseField name="subscriptions" type="object[]">
  The subscriptions. See [Describe subscription](/cloud/api-reference/account/subscriptions/describe) for the full field list.
</ResponseField>

<ResponseField name="nextPageToken" type="string">
  Token to use to fetch the next page of results.
</ResponseField>

```json 200 OK theme={null}
{
  "ids": ["sub-abc123"],
  "subscriptions": [
    {
      "id": "sub-abc123",
      "serviceId": "s-123456",
      "serviceName": "FalkorDB",
      "productTierId": "pt-123456",
      "productTierName": "Pro",
      "roleType": "root",
      "status": "ACTIVE",
      "defaultSubscription": true,
      "cloudProviderNames": ["aws", "gcp"],
      "createdAt": "2025-01-15T10:04:22Z"
    }
  ]
}
```

## Errors

See [Error](/cloud/api-reference/schemas#error) for the error response shape.