<!-- source: https://secondlayer.tools/docs/api-reference#get-deployment -->

## Get a deployed subgraph

`GET /api/subgraphs/{name}` (self-hosted instances only)

Definition, health, sync progress and per-table columns and exact row counts. While a reindex or backfill is active, `sync` carries its queue position, event progress and ETA.

### Path parameters

| Name | Type | Description |
| --- | --- | --- |
| `name` | string, required | Subgraph name, as deployed. Lowercase letters, digits and hyphens. |

### Returns

One `DeployedSubgraphDetail` object.

### Responses

- `200` The subgraph
- `401` This bind requires the instance token, and it was missing or wrong
- `404` No subgraph by this name on this instance (`SUBGRAPH_NOT_FOUND`)

### Example

```bash
curl http://127.0.0.1:3800/api/subgraphs/{name} \
  -H "Authorization: Bearer $INSTANCE_TOKEN"
```

```json
{
  "name": "sbtc-flows",
  "version": "1.0.2",
  "schemaHash": "4b9e1d27c83f0a65e2d7b14c9f06a38e5d21c7b90f4e6a83d15c2b7e09f4a6d1",
  "pin": "7f3c0d5e9b21a4c86f0e3d17b5a92c4e8d61f07a3b9c25e4d8f1a06c7b3e5a91e",
  "verification": {
    "level": "events",
    "reasons": [
      "ft_transfer source \"transfers\" needs event proofs"
    ],
    "unproven": []
  },
  "status": "active",
  "lastProcessedBlock": 9048712,
  "sources": {
    "transfers": {
      "type": "ft_transfer",
      "assetIdentifier": "SM3VDXK3WZZSA84XXFKAFAF15NNZX32CTSG82JFQ4.sbtc-token::sbtc-token"
    }
  },
  "definition": {
    "name": "sbtc-flows",
    "startBlock": 8000000,
    "sources": {
      "transfers": {
        "type": "ft_transfer",
        "assetIdentifier": "SM3VDXK3WZZSA84XXFKAFAF15NNZX32CTSG82JFQ4.sbtc-token::sbtc-token"
      }
    },
    "schema": {
      "transfers": {
        "columns": {
          "amount": {
            "type": "uint"
          },
          "sender": {
            "type": "principal"
          },
          "recipient": {
            "type": "principal"
          }
        }
      }
    }
  },
  "health": {
    "totalProcessed": 48210,
    "totalErrors": 0,
    "errorRate": 0,
    "lastError": null,
    "lastErrorAt": null,
    "emptyMapping": false,
    "violationCount": 0
  },
  "sync": {
    "status": "synced",
    "mode": "sync",
    "startBlock": 8000000,
    "lastProcessedBlock": 9048712,
    "chainTip": 9048712,
    "sourceChainTip": 9048712,
    "targetBlock": 9048712,
    "blocksRemaining": 0,
    "processedBlocks": 1048713,
    "totalBlocks": 1048713,
    "progress": 1,
    "gaps": {
      "count": 0,
      "totalMissingBlocks": 0,
      "ranges": []
    },
    "integrity": "complete"
  },
  "tables": {
    "transfers": {
      "endpoint": "/subgraphs/sbtc-flows/transfers",
      "columns": {
        "amount": {
          "type": "uint"
        },
        "sender": {
          "type": "principal"
        },
        "recipient": {
          "type": "principal"
        },
        "_id": {
          "type": "serial"
        },
        "_block_height": {
          "type": "bigint"
        },
        "_tx_id": {
          "type": "text"
        },
        "_created_at": {
          "type": "timestamp"
        }
      },
      "rowCount": 48138,
      "example": "/subgraphs/sbtc-flows/transfers?_sort=_block_height&_order=desc&_limit=10"
    }
  },
  "createdAt": "2026-09-21T09:14:52.000Z",
  "updatedAt": "2026-09-23T14:02:11.000Z"
}
```