Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Growaify Autonomous Agent Commerce Agent Test API
version: 2.3.0
description: 'Autonomous agent commerce API. Everything under /x402 is sold for USDC on Base over x402: unpaid requests answer HTTP 402 and the deliverable ships in the paid response. Everything else is free to read.'
servers:
- url: https://growaify.com
description: Production Engine
tags:
- name: Agent Test
paths:
/api/v1/agent-test/register:
post:
summary: Take a private paywall to test your own agent against
description: 'Free, no account. Returns a private path where your agent meets a real HTTP 402 - the production wire format, the production signing requirements and the production facilitator, priced at our cheapest artefact so a success costs $0.001 rather than a guess. The id is the capability: whoever holds it can read the report, so it is generated for you rather than chosen.'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- name
properties:
name:
type: string
description: Which agent is being tested. Required.
note:
type: string
description: Anything worth recording about it. Optional.
responses:
'200':
description: test_url to point the agent at, report_url to read the funnel from, and the price in USD.
'400':
description: No name was supplied.
tags:
- Agent Test
operationId: postApiV1AgentTestRegister
x-operation-id-source: derived
/api/v1/agent-test/{test_id}:
get:
summary: One agent's own funnel at the test paywall
description: How many times the agent was challenged, whether it attempted to pay, the exact rejection reason if it did, and whether it ever settled - reconstructed from the same event log the public funnel is built from, so the figures cannot disagree with the published ones.
parameters:
- name: test_id
in: path
required: true
schema:
type: string
responses:
'200':
description: The test's stages and outcomes.
'404':
description: unknown_test. The body names the register call that issues an id.
tags:
- Agent Test
operationId: getApiV1AgentTestByTestId
x-operation-id-source: derived
x-discovery:
x402: https://growaify.com/.well-known/x402
catalogue: https://growaify.com/api/v1/x402/resources
micro: https://growaify.com/api/v1/x402/micro
mcp: https://growaify.com/mcp
agentCard: https://growaify.com/.well-known/agent-card.json
llms: https://growaify.com/llms.txt
erc8004: https://growaify.com/.well-known/agent-registration.json
did: did:web:growaify.com
attestations: https://growaify.com/api/v1/attest/summary
agentTest: https://growaify.com/api/v1/agent-test/register
funnel: https://growaify.com/api/v1/x402/funnel
cohorts: https://growaify.com/api/v1/live/cohorts
research: https://growaify.com/api/v1/research/agent-commerce.json