> For the complete documentation index, see [llms.txt](https://developer.firmhouse.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.firmhouse.com/graphql-api/api-reference/queries/subscriptions.md).

# subscriptions

### Arguments

| Argument                                                                                           | Description                                                                                             |
| -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
| signupCompletedSince ([ISO8601DateTime](/graphql-api/api-reference/objects/iso-8601-date-time.md)) | Filter subscriptions to those who completed their signup since a certain time.                          |
| signupCompletedUntil ([ISO8601DateTime](/graphql-api/api-reference/objects/iso-8601-date-time.md)) | Filter subscriptions to those who completed their signup until a certain time.                          |
| updatedSince ([ISO8601DateTime](/graphql-api/api-reference/objects/iso-8601-date-time.md))         | Filter subscriptions to those who were updated since the given datetime.                                |
| updatedUntil ([ISO8601DateTime](/graphql-api/api-reference/objects/iso-8601-date-time.md))         | Filter subscriptions to those that where updated until the given datetime.                              |
| ids (\[[ID](/graphql-api/api-reference/objects/id.md)!])                                           | Filter subscriptions to those of specific IDs.                                                          |
| customerReferences (\[[String](/graphql-api/api-reference/objects/string.md)!])                    | Filter subscriptions to those of specific customer references.                                          |
| planIds (\[[ID](/graphql-api/api-reference/objects/id.md)!])                                       | Filter subscriptions to those subscribed to specific plan IDs.                                          |
| nextBillingDate ([ISO8601Date](/graphql-api/api-reference/objects/iso-8601-date.md))               | Filter subscriptions to those with a specific next billing date.                                        |
| statuses (\[[SubscriptionStatus](/graphql-api/api-reference/objects/subscription-status.md)!])     | Filter subscriptions to those of specific statuses. Lists all subscriptions except DRAFT if none given. |
| email ([String](/graphql-api/api-reference/objects/string.md))                                     | Filter subscriptions to those with a specific email address (case-insensitive).                         |
| query ([String](/graphql-api/api-reference/objects/string.md))                                     | Search subscriptions by customer name, email, token, ID, customer reference, or company name.           |
| after ([String](/graphql-api/api-reference/objects/string.md))                                     | Returns the elements in the list that come after the specified cursor.                                  |
| before ([String](/graphql-api/api-reference/objects/string.md))                                    | Returns the elements in the list that come before the specified cursor.                                 |
| first ([Int](/graphql-api/api-reference/objects/int.md))                                           | Returns the first *n* elements from the list.                                                           |
| last ([Int](/graphql-api/api-reference/objects/int.md))                                            | Returns the last *n* elements from the list.                                                            |

### Return fields

#### edges (\[[SubscriptionEdge](/graphql-api/api-reference/objects/subscription-edge.md)])

A list of edges.

#### nodes (\[[Subscription](/graphql-api/api-reference/objects/subscription.md)])

A list of nodes.

#### pageInfo ([PageInfo](/graphql-api/api-reference/objects/page-info.md)!)

Information to aid in pagination.

#### totalCount ([Int](/graphql-api/api-reference/objects/int.md))

The total number of items available.