Alkimi for Developers
The Alkimi Marketplace is built on IAB Tech Lab's agentic standards — AAMP, the Ad Context Protocol (AdCP) and the Agentic Real-Time Framework (ARTF). These resources let developers and AI agents integrate with Alkimi programmatically.
- OpenAPI 3.1 spec
Machine-readable description of the Alkimi public API.
- sellers.json
IAB transparency file of authorised sellers.
- llms.txt
Agent-oriented guide to this site and when to use it.
- Sitemap
All indexable URLs with last-modified dates.
Errors
Errors under /api/* are returned as application/problem+json bodies, per RFC 9457, with the shape:
{
"type": "https://www.alkimi.org/developers#errors",
"title": "string",
"status": number,
"code": "string",
"detail": "string?",
"resolution": "string?"
}detail and resolution are optional and only present when they add useful context. The registry of code values in use:
| Code | Endpoint | Meaning |
|---|---|---|
| invalid_json | /api/contact | Request body is not valid JSON. |
| missing_fields | /api/contact | One or more required fields are missing. |
| invalid_email | /api/contact | work_email is not a well-formed email address. |
| invalid_priority | /api/contact | priority is not one of high, standard or message. |
| submission_failed | /api/contact | The submission could not be stored upstream. |
| invalid_messages | /api/chat | The messages payload is missing or not an array. |
| origin_forbidden | /api/chat | The request did not come from an allowed origin. |
| rate_limited | /api/chat | Too many requests. Honor the Retry-After header before retrying. |
| method_not_allowed | /api/chat | The HTTP method is not supported on this endpoint. |
| invalid_secret | /api/revalidate | The ?secret= query parameter is missing or incorrect. |
| unknown_endpoint | Any unknown /api path | No route matches the requested /api path. |