# API Blueprint API

**Canonical:** https://apis.io/apis/api-blueprint/api-blueprint-api/  
**Provider:** API Blueprint — https://apis.io/providers/api-blueprint/  
**Base URL:** https://api.apiblueprint.org  
**Documentation:** https://apiblueprintapi.docs.apiary.io/

API Blueprint API is one of 2 APIs that [API Blueprint](https://apis.io/providers/api-blueprint/) 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 API Design, Parsing, and Specification Language. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, and 1 JSON Schema.

The API Blueprint API is the parsing service operated at api.apiblueprint.org by the API Blueprint project. It parses API Blueprint and Swagger 2.0 documents into the Refract Parse Result Namespace (API Elements) and composes API Blueprint back out of API Elements. The service is open, requires no authentication or API key, and is driven entirely by HTTP content negotiation. Probed live and answering on 2026-09-02 even though every apiaryio GitHub repository was archived on 2024-11-08.

## Operations (5)

| Method | Path | Summary |
|---|---|---|
| GET | `/` | List |
| POST | `/parser` | Parse |
| POST | `/composer` | Compose |
| POST | `/validate` | Validate |
| POST | `/transform` | Transform |

## Machine-readable artifacts (10)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/api-blueprint/refs/heads/main/openapi/api-blueprint-parsing-service-openapi.yml
- **APIBlueprint** — https://raw.githubusercontent.com/api-evangelist/api-blueprint/refs/heads/main/apib/api-blueprint-api.apib
- **Documentation** — https://apiblueprintapi.docs.apiary.io/
- **SourceCode** — https://github.com/apiaryio/api.apiblueprint.org
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/api-blueprint/refs/heads/main/authentication/api-blueprint-authentication.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/api-blueprint/refs/heads/main/errors/api-blueprint-problem-types.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/api-blueprint/refs/heads/main/conventions/api-blueprint-conventions.yml
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/api-blueprint/refs/heads/main/overlays/api-blueprint-parsing-service-overlay.yaml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/api-blueprint/refs/heads/main/data-model/api-blueprint-data-model.yml
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/api-blueprint/refs/heads/main/json-schema/api-blueprint-api-elements-element-schema.json

## Other API Blueprint APIs (1)

- [API Blueprint](https://apis.io/apis/api-blueprint/api-blueprint/)

## Tags

API Design, Parsing, Specification Language

---

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