Agreement List

Returns the agreement catalog visible to callers.

Method and path

• Method: GET
• Path: /agreements
• Auth: not required

Query parameters

• tags: comma-separated agreement tags
• capability: comma-separated capability tags
• scenario: comma-separated scenario tags

Response

• 200 OK: array of agreement summary objects
• 500 Internal Server Error: error payload with error and message

Key fields in each item:

• id
• name
• version
• description
• tags
• updated
• versions

Notes:

• The list response does not include full agreement originalContent.
• Read agreement detail or version detail when the full contract body is needed.

Example

curl "https://api.asahub.ai/agreements?tags=auth"

[
  {
    "id": "agreement-auth",
    "name": "auth-email",
    "version": "v1.0.2",
    "description": "Email-based authentication agreement",
    "tags": ["auth", "email"],
    "updated": "2026-04-20T09:30:00Z"
  }
]