# 0bull API

**Canonical:** https://apis.io/apis/0bull-net/0bull-net-api/  
**Provider:** 0bull — https://apis.io/providers/0bull-net/  
**Documentation:** https://docs.0bull.net/api

0bull API is one of 2 APIs that [0bull](https://apis.io/providers/0bull-net/) 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.

0bull API as documented publicly: 60 operations. Contract generated from the documentation by API Evangelist (2026-10-31); not the provider's own document.

## Operations (60)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/user` | Get the authenticated user. |
| GET | `/api/v1/accounts` | Returns the authenticated user's own posting accounts, newest first, 50 per page. |
| POST | `/api/v1/accounts` | POST /api/v1/accounts |
| DELETE | `/api/v1/accounts/{account}` | Removes the account from 0bull. |
| GET | `/api/v1/accounts/{account}` | Works for an account on any platform: the id alone identifies it. |
| PUT | `/api/v1/accounts/{account}` | Only the supplied fields are changed. |
| GET | `/api/v1/billing` | Returns your active rentals, pending orders, pricing and renewal dates. |
| POST | `/api/v1/billing` | POST /api/v1/billing |
| POST | `/api/v1/billing/rentals` | Returns a Stripe Checkout link. |
| POST | `/api/v1/billing/requests` | Returns 202 if the change needs approval, or 201 if your standing allowance let it apply immediately. |
| GET | `/api/v1/billing/requests/{billingrequest}` | Returns one of your billing requests by id. |
| GET | `/api/v1/phone-controller` | GET /api/v1/phone-controller |
| GET | `/api/v1/phones` | GET /api/v1/phones |
| GET | `/api/v1/phones/{phoneSlot}/agent-runs` | Start an agent run on a phone. |
| POST | `/api/v1/phones/{phoneslot}/runs/{runid}` | POST /api/v1/phones/{phoneSlot}/runs/{runId} |
| POST | `/api/v1/phones/{slot}/commands` | POST /api/v1/phones/{slot}/commands |
| POST | `/api/v1/phones/{slot}/input` | POST /api/v1/phones/{slot}/input |
| POST | `/api/v1/phones/{slot}/macros` | POST /api/v1/phones/{slot}/macros |
| GET | `/api/v1/phones/{slot}/ocr` | GET /api/v1/phones/{slot}/ocr |
| GET | `/api/v1/phones/{slot}/runs` | GET /api/v1/phones/{slot}/runs |
| GET | `/api/v1/phones/{slot}/runs/{run}` | Returns one phone run by its id, including its result or failure message. |
| GET | `/api/v1/phones/{slot}/snapshot` | GET /api/v1/phones/{slot}/snapshot |
| GET | `/api/v1/submissions` | Returns the authenticated user's own submissions, newest first, 50 per page. |
| POST | `/api/v1/submissions` | POST /api/v1/submissions |
| POST | `/api/v1/submissions/batches` | POST /api/v1/submissions/batches |
| GET | `/api/v1/submissions/batches/{batch}` | Returns the drop with every submission in it. |
| POST | `/api/v1/submissions/batches/{batch}/cancel` | Stops every submission in the drop that has not finished. |
| DELETE | `/api/v1/submissions/{submission}` | Deletes the submission and its stored video file. |
| GET | `/api/v1/submissions/{submission}` | Poll this to track a submission's progress. |
| POST | `/api/v1/submissions/{submission}/cancel` | Cancels a queued or in-progress submission. |
| POST | `/api/v1/uploads` | POST /api/v1/uploads |
| POST | `/hooks/0bull` | Receive webhook notification when a submission completes with final status. |
| GET | `/user` | Get the authenticated user |
| GET | `/v1/accounts` | Returns the authenticated user's own posting accounts, newest first, 50 per page. |
| POST | `/v1/accounts` | The account must already be signed in on the phone at `slot`, or have no slot yet for a record-only entry: this endpoint links an account, it does not sign o... |
| DELETE | `/v1/accounts/{account}` | Delete an account |
| GET | `/v1/accounts/{account}` | Works for an account on any platform: the id alone identifies it. |
| PUT | `/v1/accounts/{account}` | Only the supplied fields are changed. |
| GET | `/v1/billing` | Get billing summary |
| POST | `/v1/billing/rentals` | Start a rental checkout |
| POST | `/v1/billing/requests` | Request a phone count change |
| GET | `/v1/billing/requests/{billingrequest}` | Get a billing request |
| GET | `/v1/phone-controller` | Create a phone-controller session |
| GET | `/v1/phones` | List phones |
| POST | `/v1/phones/{slot}/agent-runs` | Start a phone agent run |
| POST | `/v1/phones/{slot}/commands` | Queue a phone command |
| POST | `/v1/phones/{slot}/input` | Send phone input |
| POST | `/v1/phones/{slot}/macros` | Queue a phone macro |
| GET | `/v1/phones/{slot}/ocr` | Read phone screen text |
| GET | `/v1/phones/{slot}/runs` | List phone runs |
| GET | `/v1/phones/{slot}/runs/{run}` | Poll phone work (macros, device commands, agent runs) until status is succeeded, failed or cancelled. |
| GET | `/v1/phones/{slot}/snapshot` | Capture a phone snapshot |
| GET | `/v1/submissions` | List video submissions |
| POST | `/v1/submissions` | Submit a video to one account. |
| POST | `/v1/submissions/batches` | Submit a video to several accounts. |
| GET | `/v1/submissions/batches/{batch}` | Get a batch |
| POST | `/v1/submissions/batches/{batch}/cancel` | Cancel a batch. |
| DELETE | `/v1/submissions/{submission}` | Delete a video submission |
| POST | `/v1/submissions/{submission}/cancel` | Cancel a submission |
| POST | `/v1/uploads` | Mint a signed video upload URL. |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/0bull-net/openapi/_ae-authored/0bull-net-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/0bull-net/json-schema/0bull-net-post-api-v1-submissions-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/0bull-net/json-schema/0bull-net-post-api-v1-submissions-batches-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/0bull-net/json-schema/0bull-net-post-api-v1-accounts-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/0bull-net/json-schema/0bull-net-post-v1-submissions-batches-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/0bull-net/json-schema/0bull-net-post-v1-submissions-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/0bull-net/json-schema/0bull-net-post-api-v1-billing-response-schema.json

## Other 0bull APIs (1)

- [0bull API](https://apis.io/apis/0bull-net/0bull-api/)

---

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