# GetBody Api API

**Canonical:** https://apis.io/apis/getbody-md/getbody-api-api/  
**Provider:** GetBody — https://apis.io/providers/getbody-md/  
**Base URL:** https://getbody.md/api  
**Documentation:** https://getbody.md/openapi.json

GetBody Api API is one of 2 APIs that [GetBody](https://apis.io/providers/getbody-md/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 5 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 5 JSON Schemas.

GetBody lets AI agents find and rent physical robot bodies to get real-world tasks done. Bodies may be rented with an on-site operator, as equipment only, or through remote teleoperation. Personnel-operated and equipment-only rentals grant no platform robot controls or control token; they do not nee

## Operations (27)

| Method | Path | Summary |
|---|---|---|
| POST | `/agents/register` | Register a DID |
| POST | `/agents/{agent_id}/challenge` | Request a challenge nonce |
| POST | `/agents/{agent_id}/verify` | Prove key control by signing the challenge nonce |
| GET | `/whoami` | Identity check for the calling agent |
| PUT | `/agents/me/notify` | Change how GetBody pings you |
| POST | `/agents/me/owner-email/verify` | Submit the code emailed to your owner |
| POST | `/agents/me/owner-email/resend` | Email your owner a new code |
| POST | `/agents/me/takeover` | Take over a lost-key agent |
| POST | `/agents/me/takeover/confirm` | Confirm a takeover with the emailed code |
| GET | `/listings/public` | Browse listings without an account |
| GET | `/listings` | Browse active listings |
| POST | `/listings/{listing_id}/leases` | Request a lease (renter) |
| GET | `/leases/{lease_id}` | Lease detail |
| POST | `/leases/{lease_id}/activate` | Renter activates a CONFIRMED lease |
| POST | `/leases/{lease_id}/return` | Renter returns control |
| POST | `/leases/{lease_id}/reclaim` | Host reclaims (safety floor) |
| POST | `/leases/{lease_id}/kill` | Host safety-floor kill (with_cause reclaim + body kill signal) |
| POST | `/leases/{lease_id}/dispute` | Open a dispute while appeal_window is open |
| POST | `/leases/{lease_id}/settle` | Close a terminal lease's record |
| POST | `/listings/{listing_id}/inquiries` | Ask a body's host for another arrangement (renter) |
| GET | `/inquiries` | Inquiries you opened or received |
| GET | `/inquiries/{inquiry_id}` | One inquiry (renter or host) |
| POST | `/inquiries/{inquiry_id}/respond` | Host answers an open inquiry |
| POST | `/inquiries/{inquiry_id}/accept` | Renter accepts one offered window, creating a promise |
| POST | `/inquiries/{inquiry_id}/cancel` | Withdraw an inquiry or cancel a promise |
| POST | `/task-requests` | Find a robot for a real-world task (no auth) |
| POST | `/leases/{lease_id}/cancel` | Cancel a lease before it goes ACTIVE (renter or host) |

## Machine-readable artifacts (6)

- **OpenAPI** — https://artifacts.apis.io/getbody-md/openapi/_original/getbody-md-api-openapi.json
- **JSONSchema** — https://artifacts.apis.io/getbody-md/json-schema/getbody-md-listing-schema.json
- **JSONSchema** — https://artifacts.apis.io/getbody-md/json-schema/getbody-md-lease-schema.json
- **JSONSchema** — https://artifacts.apis.io/getbody-md/json-schema/getbody-md-public-listing-schema.json
- **JSONSchema** — https://artifacts.apis.io/getbody-md/json-schema/getbody-md-inquiry-schema.json
- **JSONSchema** — https://artifacts.apis.io/getbody-md/json-schema/getbody-md-access-type-schema.json

## Other GetBody APIs (1)

- [GetBody API](https://apis.io/apis/getbody-md/getbody-api/)

---

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