# Stacks api API

**Canonical:** https://apis.io/apis/blockstack-org/api-api/  
**Provider:** Stacks — https://apis.io/providers/blockstack-org/  
**Base URL:** https://api.hiro.so  
**Documentation:** https://docs.stacks.co/reference/api

Stacks api API is one of 3 APIs that [Stacks](https://apis.io/providers/blockstack-org/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Stacks api API as documented publicly: 28 operations. Contract generated from the documentation by API Evangelist (2026-10-24); not the provider's own document.

## Operations (28)

| Method | Path | Summary |
|---|---|---|
| POST | `/call` | POST /call |
| GET | `/chainstate` | Get chain tip handler. |
| GET | `/chainstate/{height}` | Get chainstate handler. |
| POST | `/construction/combine` | POST /construction/combine |
| POST | `/construction/metadata` | POST /construction/metadata |
| POST | `/construction/payloads` | POST /construction/payloads |
| POST | `/construction/preprocess` | POST /construction/preprocess |
| POST | `/construction/submit` | POST /construction/submit |
| GET | `/deposit` | Get deposits handler. |
| POST | `/deposit` | Create deposit handler. |
| PUT | `/deposit` | Update deposits handler. |
| GET | `/deposit/{txid}` | Get deposits for transaction handler. |
| GET | `/deposit/{txid}/{index}` | Get deposit handler. |
| GET | `/extended` | GET /extended |
| GET | `/health` | Get health handler. |
| GET | `/limits` | Get the global limits. |
| GET | `/limits/{account}` | Get limits for account handler. |
| POST | `/network/list` | Network endpoints |
| POST | `/network/options` | Network endpoints |
| GET | `/reference/api/stacks-mesh-api/models.md` | Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters |
| GET | `/v2/accounts/{principal}` | Get account info |
| GET | `/v2/microblocks/{microblockId}` | Get a stream of microblocks beginning with the given microblock (Epoch 2.x). |
| GET | `/withdrawal` | Get withdrawals handler. |
| PUT | `/withdrawal` | Update withdrawals handler. |
| GET | `/withdrawal/recipient/{recipient}` | Get withdrawals by recipient handler. |
| GET | `/withdrawal/sender/{sender}` | Get withdrawals by sender handler. |
| GET | `/withdrawal/{id}` | Get withdrawal handler. |
| GET | `/{networkstr}/deposits` | Get all deposits |

## Machine-readable artifacts (8)

- **OpenAPI** — https://artifacts.apis.io/blockstack-org/openapi/_ae-authored/blockstack-org-api-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/blockstack-org/json-schema/blockstack-org-post-deposit-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/blockstack-org/json-schema/blockstack-org-post-construction-preprocess-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/blockstack-org/json-schema/blockstack-org-get-v2-accounts-principal-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/blockstack-org/json-schema/blockstack-org-post-construction-metadata-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/blockstack-org/json-schema/blockstack-org-post-construction-payloads-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/blockstack-org/json-schema/blockstack-org-post-construction-preprocess-response-schema.json
- **APIsJSON** — https://artifacts.apis.io/blockstack-org/apis.yml

## Other Stacks APIs (2)

- [Stacks core API](https://apis.io/apis/blockstack-org/core-api/)
- [Stacks stacks.js API](https://apis.io/apis/blockstack-org/stacks.js-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/blockstack-org/api-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/blockstack-org/.