# HEY Research Lab Agents API

**Canonical:** https://apis.io/apis/heyresearch-xyz/heyresearch-xyz-agents-api/  
**Provider:** HEY Research Lab — https://apis.io/providers/heyresearch-xyz/  
**Base URL:** https://heyresearch.xyz  
**Documentation:** https://heyresearch.xyz/docs/public-api

HEY Research Lab Agents API is one of 9 APIs that [HEY Research Lab](https://apis.io/providers/heyresearch-xyz/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 1 JSON Schema definition. Tagged areas include Agents. The published artifact set on APIs.io includes an OpenAPI specification and 1 JSON Schema.

Machine interfaces: the agent contract (AgentIntelligenceResponse v1), A2A and agent research receipts.

## Operations (5)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/agent` | The agent contract, described by itself |
| GET | `/api/agent/{capability}` | One answer in HEY's agent contract (AgentIntelligenceResponse v1) |
| POST | `/api/receipts/validate` | Check an agent research receipt |
| POST | `/api/a2a` | A2A JSON-RPC interface (SendMessage) |
| GET | `/api/agent/stats` | How agents use HEY, as counts |

## Machine-readable artifacts (3)

- **OpenAPI** — https://artifacts.apis.io/heyresearch-xyz/openapi/heyresearch-xyz-agents-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/heyresearch-xyz/json-schema/heyresearch-xyz-agent-intelligence-response-schema.json
- **APIsJSON** — https://artifacts.apis.io/heyresearch-xyz/apis.yml

## Other HEY Research Lab APIs (8)

- [HEY Research Lab Contracts API](https://apis.io/apis/heyresearch-xyz/heyresearch-xyz-contracts-api/)
- [HEY Research Lab Evidence API](https://apis.io/apis/heyresearch-xyz/heyresearch-xyz-evidence-api/)
- [HEY Research Lab Hey API](https://apis.io/apis/heyresearch-xyz/heyresearch-xyz-hey-api/)
- [HEY Research Lab Market API](https://apis.io/apis/heyresearch-xyz/heyresearch-xyz-market-api/)
- [HEY Research Lab Partners API](https://apis.io/apis/heyresearch-xyz/heyresearch-xyz-partners-api/)
- [HEY Research Lab Projects API](https://apis.io/apis/heyresearch-xyz/heyresearch-xyz-projects-api/)
- [HEY Research Lab Research API](https://apis.io/apis/heyresearch-xyz/heyresearch-xyz-research-api/)
- [HEY Research Lab Status API](https://apis.io/apis/heyresearch-xyz/heyresearch-xyz-status-api/)

## Tags

Agents

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/heyresearch-xyz/heyresearch-xyz-agents-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/heyresearch-xyz/.