---
title: "Get contracts"
method: GET
path: "/v1/api/chain/{chain}/contracts"
tags: ["contracts"]
---

# Get contracts

`GET /v1/api/chain/{chain}/contracts`

## Query parameters

- `address` string
- `role` 'sender' | 'recipient'
- `includeSettings` boolean

## Response `200`

OK

- ContractsOut
  - `data` Contract[], required
    - `address` string
    - `chain` integer
    - `recipient` string
    - `sender` string
    - `token` string
    - `closed` boolean
    - `feesCollected` boolean, nullable
    - `nextWithdraw` integer, nullable
    - `created` integer
    - `settings` ContractSettings
      - `contractAddress` string, required
      - `notificationEmail` string
      - `withdrawalNotificationsEnabled` boolean

## Other responses

- `422` — Unprocessable Entity
- `default` — Default error response

---

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