API Reference

Base URL

https://api.agentpay.la/v1

All endpoints require a Bearer token:

Authorization: Bearer agentpay_sk_live_...

See Authentication for details on obtaining API keys.

The full OpenAPI 3.x specification is available at:

https://api.agentpay.la/openapi.json

All responses are JSON. Successful responses return 2xx status codes. Errors return a detail field:

{
  "detail": "Human-readable error message"
}

Code	Meaning
200	Success
201	Created
204	Deleted (no content)
400	Bad request (validation error)
401	Unauthorized (invalid/expired auth)
402	Payment required (no payment method)
403	Forbidden (insufficient role or tier limit)
404	Not found
409	Conflict (duplicate or already closed)
410	Gone (card closed, credentials unavailable)
429	Rate limited

AgentPay is discoverable by AI agents via:

Endpoint	Format
`/agent.txt`	Plain text agent reference
`/.well-known/mcp.json`	MCP server discovery
`/.well-known/agent-instructions.md`	Concise agent instructions
`/.well-known/ai-plugin.json`	ChatGPT plugin manifest
`/openapi.json`	Full API specification