Discovery needs no key. Ratings and market analysis are Pro.
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: Allowance Pricing API
version: 0.1.0-pre-launch
description: Consumer trust layer for AI agent payments.
contact:
name: Allowance
email: hello@useallowance.com
url: https://useallowance.com/
x-pre-launch: true
x-status-url: https://useallowance.com/status.json
x-ap2-compatible: true
servers:
- url: https://api.useallowance.com/v1
description: Production (pre-launch — not yet active)
security:
- ApiKeyAuth: []
tags:
- name: Pricing
paths:
/pricing:
get:
operationId: getPricing
summary: Retrieve pricing information
description: Mirrors https://useallowance.com/pricing.json.
security: []
responses:
'200':
description: Pricing information
content:
application/json:
schema:
type: object
'501':
$ref: '#/components/responses/NotImplemented'
tags:
- Pricing
components:
schemas:
Error:
type: object
required:
- error
properties:
error:
type: object
required:
- code
- message
properties:
code:
type: string
message:
type: string
param:
type: string
doc_url:
type: string
format: uri
responses:
NotImplemented:
description: 'Pre-launch: this endpoint is not yet active'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: not_implemented
message: Allowance is pre-launch. This endpoint is not yet active. Contact hello@useallowance.com for early access.
doc_url: https://useallowance.com/connect-agent
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-Allowance-Key
description: API key with prefix alw_. Contact hello@useallowance.com for early access.
OAuth2:
type: oauth2
description: OAuth2 authorization code flow (planned — not yet active)
flows:
authorizationCode:
authorizationUrl: https://useallowance.com/oauth/authorize
tokenUrl: https://useallowance.com/oauth/token
scopes:
mandates:write: Propose and manage spending mandates
mandates:read: Read mandate details and status
credentials:request: Request payment credentials against active mandates
x-rate-limits:
standard: 100 requests per minute per API key
credential_requests_post: 10 requests per minute per API key
headers:
- X-RateLimit-Limit
- X-RateLimit-Remaining
- X-RateLimit-Reset
x-agent-notes: 'All monetary amounts are integers in minor currency units (cents for USD). Example: 47231 = $472.31. Never use floats. Always set Idempotency-Key on credential requests. Poll GET /v1/mandates/{id} to detect when a mandate moves from pending_approval to active — do not request credentials until the mandate is active.'
x-ap2:
compatible: true
mandate_mapping: AllowanceMandate → AP2 Intent Mandate (human-not-present scenario)
future_changes: Mandate body will be a signed VDC. Human approval will produce a cryptographic attestation. Payment tokens will be AP2 Payment Mandate VDCs.
spec_url: https://ap2-protocol.org/specification/