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: Coupondroid Italia agent A2a API
version: 1.0.0
description: Machine interfaces of Coupondroid Italia (https://coupondroid.it/), a coupon and deals website for Italy. The public ones are read-only and need no authentication; coupon codes are revealed only on the website, at each coupon `url`.
servers:
- url: https://coupondroid.it
tags:
- name: A2a
paths:
/a2a:
post:
operationId: a2aAgent
summary: A2A agent (JSON-RPC binding, A2A 1.0)
description: 'Methods `SendMessage` (and `message/send` from A2A 0.3). Send a data part `{"skill": "", "arguments": {…}}` with a skill from the agent card, or a text part with a shop name to search.'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- jsonrpc
- method
properties:
jsonrpc:
type: string
const: '2.0'
id:
oneOf:
- type: string
- type: integer
method:
type: string
params:
type: object
responses:
'200':
description: JSON-RPC 2.0 response.
content:
application/json:
schema:
type: object
'429':
description: Rate limited (120 requests/minute).
tags:
- A2a
components:
securitySchemes:
oauth2:
type: oauth2
description: Authorization code with PKCE (S256); dynamic client registration at /oauth/register.
flows:
authorizationCode:
authorizationUrl: https://coupondroid.it/oauth/authorize
tokenUrl: https://coupondroid.it/oauth/token
refreshUrl: https://coupondroid.it/oauth/token
scopes:
read: Read
write: Create and edit
delete: Delete
externalDocs:
description: Site guide for LLMs
url: https://coupondroid.it/llms.txt