RAML

RAML (RESTful API Modeling Language) is a YAML-based specification language for describing RESTful APIs with first-class support for reusable patterns, traits, resource types, data type annotations, libraries, overlays, and extensions. Developed by MuleSoft and Salesforce, RAML 1.0 is the current stable version. The raml-org GitHub organization maintains the canonical specification and related tooling, all of which are archived and read-only as of February 2024.

RAML publishes 1 API on the APIs.io network. Tagged areas include API Design, Specification Language, Standards, YAML, and REST.

The RAML catalog on APIs.io includes 1 JSON-LD context and 1 Spectral governance ruleset.

RAML’s developer surface includes documentation and 14 more developer resources.

🌐 Visit website 📡 Source on GitHub

24.0/100 emerging ▬ flat Agent 3/100 human only Full breakdown ↓
scored 2026-09-08 · rubric v0.20.0

AccessFreemium

1 APIs

API Design Specification Language Standards YAML RESTAPI Modeling

Kin Score

Kin Score How this is scored →
scored 2026-09-08 · rubric v0.20.0

Composite quality — 24.0/100 · emerging

Contract Quality 5.7 / 25

Developer Ergonomics 2.9 / 20

Access Clarity 3.2 / 20

Operational Transparency 3.4 / 13

Contract Governance 3.0 / 12

Discoverability 5.9 / 10

Agent readiness — 3/100 · human only

Machine-Readable Contract 0 / 18

Agentic Access Contract 0 / 10

Documented Reversibility 0 / 6

MCP Server 0 / 12

Machine-Readable Auth 0 / 10

Idempotency 0 / 9

Stable Error Semantics 0 / 8

Request/Response Examples 0 / 7

Rate-Limit Signaling 7 / 7

Typed Event Surface 0 / 6

Agent Skills 0 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 0 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 0 / 4

Delegated User Identity 0 / 6

Protected Resource Metadata 0 / 5

Registration Without a Human 0 / 6

Agentic Commerce Well-Known Document 0 / 5

Create-or-Update Ergonomics could not be measured. We hold no machine-readable contract for this provider to read, so there is nothing to measure a write surface against. Excluded rather than scored zero: never-measured and measured-empty are different facts. Publishing an OpenAPI is what makes this facet — and several others — scorable at all.

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. Every facet and dimension name above is a link: it opens that measurement's own page — what it means, the exact checks that feed it, how the whole catalog distributes on it, and the providers at the top of it. This rating is computed from github.com/api-evangelist/raml: open an issue to ask a question, or submit a pull request to add artifacts. Submit an artifact on GitHub — free → Manage your own listing — the Influence plan, $499/mo →

APIs 1

Individual APIs this provider publishes, each with its own machine-readable definition.

RAML Specification

The RAML (RESTful API Modeling Language) specification defines a YAML 1.2-based language for describing HTTP-based APIs. RAML 1.0 introduces a unified type system, annotations, ...

Pricing Plans 1

Published pricing tiers and plan structures.

Raml Plans Pricing

3 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Raml Rate Limits

5 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Raml Finops

FINOPS

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Raml Context

15 classes · 18 properties

JSON-LD

Spectral Rules 1

Spectral governance rulesets for linting and validating these APIs.

RAML API Rules

6 rules · 4 warnings 2 info

SPECTRAL

JSON Schema 1

Standalone JSON Schema definitions for this provider's data models.

RAML 1.0 Document

13 properties

JSON SCHEMA

JSON Structure 1

JSON Structure definitions describing this provider's data shapes.

Raml Document Structure

0 properties

JSON STRUCTURE

Examples 2

Example request and response payloads for these APIs.

Raml Basic Api Example

4 fields

EXAMPLE

Raml Traits Example

4 fields

EXAMPLE

Security Posture 1

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Raml Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Resources

Documentation 3

Reference material describing how the API behaves

Documentation

Documentation

Specification

Specification

JSONSchemaConverter

JSONSchemaConverter

Design & Contract 2

Pagination, idempotency, versioning, errors, and events

JSONLD

JSONLD

Vocabulary

Vocabulary

Build 1

SDKs, sample code, and the tooling you integrate with

GitHubOrganization

GitHubOrganization

Access & Security 1

Authentication, authorization, and security posture

DomainSecurity

DomainSecurity

Operate 3

Status, limits, changes, and where to get help

IssueTracker

IssueTracker

Releases

Releases

Forums

Forums

Company 1

The organization behind the API

Website

Website

Other 4

Properties that don't map to a standard resource type

Parser JavaScript

Parser PHP

TCK

WebapiParser

Source (apis.yml)

aid: raml
name: RAML
description: RAML (RESTful API Modeling Language) is a YAML-based specification language for describing RESTful APIs with
  first-class support for reusable patterns, traits, resource types, data type annotations, libraries, overlays, and extensions.
  Developed by MuleSoft and Salesforce, RAML 1.0 is the current stable version. The raml-org GitHub organization maintains
  the canonical specification and related tooling, all of which are archived and read-only as of February 2024.
type: Index
deliveryModel:
  model: unknown
  open_source: unknown
  commercial: false
  callable_host: false
  label: Delivery model not determined — needs a product licence on record
  confidence: low
  source:
  - repository-unlicensed
  generated: '2026-08-28'
  method: derived
accessModel:
  pricing: freemium
  onboarding: unknown
  trial: false
  try_now: false
  public: false
  label: Freemium
  confidence: medium
  source:
  - plans
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/raml.png
tags:
- API Design
- Specification Language
- Standards
- YAML
- REST
- API Modeling
created: '2026-03-25'
modified: '2026-05-02'
url: https://raw.githubusercontent.com/api-evangelist/raml/refs/heads/main/apis.yml
specificationVersion: '0.23'
apis:
- aid: raml:raml-spec
  name: RAML Specification
  description: The RAML (RESTful API Modeling Language) specification defines a YAML 1.2-based language for describing HTTP-based
    APIs. RAML 1.0 introduces a unified type system, annotations, libraries, overlays, extensions, and improved OAuth support
    over RAML 0.8.
  humanURL: https://raml.org
  tags:
  - API Design
  - Specification Language
  - Standards
  - YAML
  properties:
  - type: Documentation
    url: https://raml.org/developers/raml-100-tutorial
  - type: Specification
    url: https://github.com/raml-org/raml-spec
  - type: GitHubRepository
    url: https://github.com/raml-org/raml-spec
  - type: JSONSchema
    url: json-schema/raml-document-schema.json
  - type: JSONStructure
    url: json-structure/raml-document-structure.json
common:
- type: IssueTracker
  url: https://github.com/raml-org/raml-spec/issues
- type: Releases
  url: https://github.com/raml-org/raml-spec/releases
- type: DomainSecurity
  url: security/raml-domain-security.yml
- type: Website
  url: https://raml.org
- type: Documentation
  url: https://raml.org/developers/raml-100-tutorial
- type: Specification
  url: https://github.com/raml-org/raml-spec
- type: GitHubOrganization
  url: https://github.com/raml-org
- type: Forums
  url: https://forum.raml.org
- type: Parser JavaScript
  url: https://github.com/raml-org/raml-js-parser-2
- type: Parser PHP
  url: https://github.com/raml-org/raml-php-parser
- type: TCK
  url: https://github.com/raml-org/raml-tck
- type: JSONSchemaConverter
  url: https://github.com/raml-org/ramldt2jsonschema
- type: WebapiParser
  url: https://github.com/raml-org/webapi-parser
- type: JSONLD
  url: json-ld/raml-context.jsonld
- type: Vocabulary
  url: vocabulary/raml-vocabulary.yml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com

Work with this as data

Every provider here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for providers

9 MCP tools reach this

find_providersBrowse and filter every provider in the catalog.
get_provider_artifactsEvery artifact this provider publishes, grouped by type.
get_provider_operationsEvery operation across all of their OpenAPIs — one call instead of parsing every spec.
get_provider_toolsEvery MCP tool they ship, with the operation each wraps.
get_provider_evidenceHow each part of their score was established. Free — the basis for a claim should not sit behind it.
get_provider_ratingPRO — composite, band, trend and facet scores.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This provider

curl "https://apis.io/api/v1/providers/raml"

All providers

curl "https://apis.io/api/v1/providers?limit=25"

Every operation they expose

curl "https://apis.io/api/v1/providers/raml/operations?limit=25"

How their score was established

curl "https://apis.io/api/v1/providers/raml/evidence"

Discovery needs no key. Ratings and market analysis are Pro.

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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.