---
title: "GET /v1/contracts"
method: GET
path: "/v1/contracts"
---

# GET /v1/contracts

`GET /v1/contracts`

List contract projects for the organization

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

OK

- ListContractProjectsSlimSuccessResponse
  - `code` integer
  - `data` PaginatedDataSchemasContractProjectListItem
    - `hasMore` boolean
    - `items` ContractProjectListItem[]
      - `allDeployments` GithubComB3FunB3MonoServicesB3osWorkflowInternalPkgEntityDeployResult[]
        - `address` string
        - `blockNumber` integer
        - `chainId` integer
        - `deployedAt` string
        - `deploymentMode` string — standard, create2, or create3
        - `gasUsed` integer
        - `isDeterministic` boolean — Whether CREATE2/CREATE3 was used
        - `networkType` string — mainnet or testnet
        - `predictedAddress` string — Pre-computed address for deterministic deployments
        - `salt` string — CREATE2/CREATE3 salt for deterministic address
        - `txHash` string
        - `verificationStatus` 'pending' | 'verified' | 'failed' — Verification status
        - `verificationUrl` string — URL to view verified contract on block explorer
        - `verified` boolean — Whether contract source is verified on block explorer
      - `createdAt` string
      - `currentStep` integer
      - `deployments` GithubComB3FunB3MonoServicesB3osWorkflowInternalPkgEntityDeployments — Deployments is populated from the contract_deployments table, NOT from a DB column. Kept for backward-compatible JSON serialization in API responses.
      - `id` string
      - `name` string
      - `solVersion` string
      - `status` 'planned' | 'generating' | 'code_generated' | 'testing' | 'tested' | 'auditing' | 'audited' | 'deploying' | 'testnet_deployed' | 'mainnet_deployed' | 'failed'
      - `testResults` ContractTestSummary
        - `failed` integer
        - `passed` integer
        - `total` integer
      - `updatedAt` string
    - `limit` integer
    - `offset` integer
  - `message` string
  - `requestId` string

## Other responses

- `500` — Internal Server Error

---

[API](https://skmtc.net/b3-fun/apis/b3os-workflow-api.md) · [All operations](https://skmtc.net/b3-fun/apis/b3os-workflow-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/b3-fun/b3os-workflow-api/versions/5a750a5a9596/schema)