<!-- source: https://secondlayer.tools/docs/api-reference#subgraph-object -->

## The Subgraph object

Metadata for one subgraph.

| Field | Type | Description |
| --- | --- | --- |
| `name` | string | Subgraph name. |
| `description` | string · nullable | The definition's `description`, if it has one. |
| `version` | string | Deployed version. |
| `status` | string | Indexing state: `active` (following the chain), `reindexing`, `paused`, or `error`. |
| `created_at` | string · date-time | First deploy. |
| `sources` | array of string | Contracts the definition reads from: each source's `contractId`, and the contract half of each `assetIdentifier`. |
| `start_block` | integer | Block indexing starts from. 0 means genesis. |
| `tables` | object | Each table by name. |
| `tip` | SubgraphTip |  |
| `docs` | object | Generated docs for this subgraph. |

```json
{
  "name": "sbtc-token",
  "description": null,
  "version": "1.0.0",
  "status": "active",
  "created_at": "2026-09-01T12:00:00.000Z",
  "sources": [
    "SM3VDXK3WZZSA84XXFKAFAF15NNZX32CTSG82JFQ4.sbtc-token"
  ],
  "start_block": 0,
  "tables": {
    "transfers": {
      "endpoint": "/v1/subgraphs/sbtc-token/transfers",
      "columns": [
        "sender",
        "recipient",
        "amount",
        "asset_identifier"
      ],
      "column_types": {
        "sender": "principal",
        "recipient": "principal",
        "amount": "uint",
        "asset_identifier": "text"
      }
    }
  },
  "tip": {
    "block_height": 9048931,
    "subgraph_height": 9048931,
    "blocks_behind": 0
  },
  "docs": {
    "openapi": "/v1/subgraphs/sbtc-token/openapi.json",
    "schema": "/v1/subgraphs/sbtc-token/schema.json",
    "markdown": "/v1/subgraphs/sbtc-token/docs.md"
  }
}
```