# Graunt API

**Canonical:** https://apis.io/apis/graunt-com/graunt-com-api/  
**Provider:** Graunt — https://apis.io/providers/graunt-com/  
**Base URL:** https://api.graunt.com  
**Documentation:** https://graunt.com/api-agents

Graunt API is published by [Graunt](https://apis.io/providers/graunt-com/) 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.

Graunt API as documented publicly: 74 operations. Contract generated from the documentation by API Evangelist (2026-11-10); not the provider's own document.

## Operations (60 of 74)

| Method | Path | Summary |
|---|---|---|
| GET | `/k/{key}` | Agent API |
| GET | `/p/{pass}` | Agent API |
| POST | `/v1/access-passes` | POST /v1/access-passes |
| GET | `/v1/access-passes/manifest` | GET /v1/access-passes/manifest |
| POST | `/v1/agent-keys/starter` | Accountless mint of an agent discovery key. |
| POST | `/v1/agent-keys/starter/claim` | Binds a minted discovery key to your organization. |
| POST | `/v1/agents/credentials` | POST /v1/agents/credentials |
| POST | `/v1/agents/listings/preflight` | POST /v1/agents/listings/preflight / submit Scoped seller-side listing submission. The listing enters the automatic publication checks, and an eligible one p... |
| POST | `/v1/agents/listings/submit` | Agent API |
| POST | `/v1/agents/payouts/onboarding-link` | Returns the link where the account holder sets up payouts. |
| POST | `/v1/agents/principals` | POST /v1/agents/principals |
| POST | `/v1/agents/purchases/execute` | Agent API · Graunt |
| POST | `/v1/agents/purchases/preflight` | Agent API · Graunt |
| POST | `/v1/agents/signup` | Open the account. POST /v1/agents/signup with the account holder’s name and email, each affirmation set to true, agent_attestation: true, the terms_digest, t... |
| GET | `/v1/agents/signup/terms` | Read the terms. GET /v1/agents/signup/terms returns each document, the exact sentence the agent affirms for it, and a terms_digest. |
| POST | `/v1/agents/terms/accept` | Agent accepts Graunt’s seller terms. |
| POST | `/v1/anonymous-drafts` | Creates a private packet draft owned by the discovery key. |
| PATCH | `/v1/anonymous-drafts/{id}` | Sets title, price, seller name, contact email, and draft state fields. |
| POST | `/v1/anonymous-drafts/{id}/submission-attestation` | Records uploader’s confirmation of rights and agreement to terms before submitting the listing. |
| POST | `/v1/anonymous-drafts/{id}/uploads` | Presigns a source‑file upload for an anonymous draft. |
| POST | `/v1/anonymous-drafts/{id}/validate` | Deterministic completeness report for an anonymous draft. |
| POST | `/v1/auth/change-email` | POST /v1/auth/change-email : JWT‑only; {new_email, current_password} ; allowed only while status=PENDING_VERIFICATION. |
| POST | `/v1/auth/login` | Authenticate as a registered organization. POST /v1/auth/login returns a 24-hour JWT. |
| GET | `/v1/auth/me` | GET /v1/auth/me : JWT‑only. Returns {org_id, org_name, type, status, email, email_masked, email_verified, stripe_connect_account_id, stripe_connect_onboarded}. |
| POST | `/v1/auth/me/resend-verification` | POST /v1/auth/me/resend-verification : JWT‑only; returns {message, email_masked, cooldown_seconds: 60}. |
| POST | `/v1/auth/register` | One-time organization registration ( type=BOTH ) followed by email verification. |
| POST | `/v1/auth/resend-verification` | POST /v1/auth/resend-verification : unauthenticated alias; {email} ; 3 / hour / email; generic‑success either way. |
| POST | `/v1/auth/stripe/connect` | POST /v1/auth/stripe/connect triggers onboarding for Stripe Connect when required. |
| GET | `/v1/entitlements` | Agent API · Graunt |
| GET | `/v1/entitlements/{id}` | GET /v1/entitlements/{id} returns entitlement detail with delivery‑policy and rate‑limit blocks. |
| POST | `/v1/entitlements/{id}/agent-access-links` | Agent API |
| POST | `/v1/entitlements/{id}/llm-access-profiles` | Agent API |
| GET | `/v1/entitlements/{id}/machine-zip` | Agent API |
| POST | `/v1/entitlements/{id}/packet-access-keys` | Agent API |
| GET | `/v1/entitlements/{id}/packet-access-manifest` | Agent API |
| GET | `/v1/feeds/{feedid}/manifest` | Agent API |
| POST | `/v1/feeds/{feedid}/sessions` | Agent API |
| GET | `/v1/listings` | GET /v1/listings |
| POST | `/v1/listings` | Agent API · Graunt |
| GET | `/v1/listings/{id}/bundle-manifest` | For bundle listings, GET /v1/listings/{id}/bundle-manifest returns the full per-asset inventory before any purchase |
| GET | `/v1/listings/{id}/manifest` | GET /v1/listings/{id}/manifest is a different document: the listing’s structured packet manifest |
| POST | `/v1/mcp` | MCP connector endpoint for catalog reads and fetches. |
| GET | `/v1/mcp/server-info` | GET /v1/mcp/server-info returns the server descriptor. |
| GET | `/v1/me/library/listings/{listingId}/versions` | Agent API |
| GET | `/v1/meta/agent-surface` | GET /v1/meta/agent-surface Omnibus agent-readable contract in one deterministic JSON document. |
| GET | `/v1/meta/capabilities` | The capability registry: the source of truth for what is live today. |
| GET | `/v1/meta/packet-assembly-contract` | Agent API · Graunt |
| GET | `/v1/meta/packet-assembly-starter-kit` | Templates: GET /v1/meta/packet-assembly-starter-kit (the human zip download is /v1/meta/packet-assembly-starter-kit.zip). |
| GET | `/v1/meta/pricing` | Full pricing metadata: GET /v1/meta/pricing. |
| GET | `/v1/meta/search-contract` | GET /v1/meta/search-contract Supported filters, ranking invariants, and the unsupported-filter anti-hallucination block. |
| GET | `/v1/meta/stripe-publishable-key` | The publishable key comes from GET /v1/meta/stripe-publishable-key; used for Stripe payment flow. |
| POST | `/v1/packet-upload-sessions` | Agent API · Graunt |
| POST | `/v1/packet-upload-sessions/{sid}/assets` | Agent API · Graunt |
| POST | `/v1/packet-upload-sessions/{sid}/finalize` | Agent API · Graunt |
| POST | `/v1/purchases` | Acquire via POST /v1/purchases with body {listing_id, idempotency_key}. |
| GET | `/v1/purchases/{id}` | Observe completion. Poll GET /v1/purchases/{id} or GET /v1/entitlements?per_page=10. |
| POST | `/v1/refinery/drafts` | Agent API · Graunt |
| PATCH | `/v1/refinery/drafts/{draftId}` | Agent API · Graunt |
| POST | `/v1/refinery/drafts/{draftId}/compile` | Agent API · Graunt |
| GET | `/v1/refinery/drafts/{draftId}/compile/{compileId}` | Agent API · Graunt |

…and 14 more operations. They are listed in full on the page.

## Machine-readable artifacts (8)

- **OpenAPI** — https://artifacts.apis.io/graunt-com/openapi/_ae-authored/graunt-com-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/graunt-com/json-schema/graunt-com-post-v1-agents-signup-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/graunt-com/json-schema/graunt-com-post-v1-listings-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/graunt-com/json-schema/graunt-com-post-v1-packet-upload-sessions-sid-assets-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/graunt-com/json-schema/graunt-com-get-v1-auth-me-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/graunt-com/json-schema/graunt-com-post-v1-refinery-uploads-presign-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/graunt-com/json-schema/graunt-com-post-v1-agents-listings-submit-request-schema.json
- **APIsJSON** — https://artifacts.apis.io/graunt-com/apis.yml

---

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