---
title: "Find subscriptions"
method: GET
path: "/v1/tx-subscriptions/"
tags: ["subscriptions to transactions"]
---

# Find subscriptions

`GET /v1/tx-subscriptions/`

This endpoint finds subscriptions to new transactions associated with the wallets and chains. Currently response is limited to 1000 subscriptions in the response.

> NOTE: Consider all IDs as abstract strings, without making any assumptions about their format or relying on such assumptions. There is a non-zero probability that IDs may change in the future, and this should not result in any breaking changes.

## Query parameters

- `filter[chain_ids]` string[]

## Response `200`

Response for requested wallet's transactions subscription

- Response20
  - `data` Container17[], required
    - `type` string, required
    - `id` string, required — Unique ID of the transaction subscription.
    - `attributes` Attributes15, required
      - `callback_url` string, required — Callback URL where updates delivered to
      - `created_at` string, required — Timestamp string in ISO 8601 format when the subscription was created
      - `updated_at` string, required — Timestamp string in ISO 8601 format when the subscription was last renewed
    - `relationships` Relationships9, required
      - `chains` Relationship[]
        - `links` RelationshipLinks, required
          - `related` string, url, required — URL to the current chain.
        - `data` ContainerShort, required
          - `type` string, required — Chain resource type.
          - `id` string, required — Chain unique identifier.

## Other responses

- `400` — Parameters are malformed
- `401` — Unathenticated request
- `429` — Too many requests error

---

[API](https://skmtc.dev/zerion/apis/rest-api.md) · [All operations](https://skmtc.dev/zerion/apis/rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zerion/rest-api/revisions/2ef116ef914f/schema)