RAML website screenshot

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 12 more developer resources.

🌐 Visit website 📡 Source on GitHub
35.5/100 thin ▼ -5.4 Agent 3/100 human only Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessFreemium
1 APIs
API DesignSpecification LanguageStandardsYAMLRESTAPI Modeling

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 35.5/100 · thin
Contract Quality 6.9 / 25
Developer Ergonomics 1.7 / 20
Commercial Clarity 7.9 / 20
Operational Transparency 4.8 / 13
Governance 8.3 / 12
Discoverability 5.9 / 10
Agent readiness — 3/100 · human only
Machine-Readable Contract 0 / 18
Agentic Access Contract 0 / 10
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
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. 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. Want it done for you? Prioritized profiling — $2,500 →

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 1

Status, limits, changes, and where to get help

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 JavaScript
 Parser PHP
Parser PHP
 TCK
TCK
 WebapiParser
WebapiParser

Source (apis.yml)

apis.yml Raw ↑ 
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
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.19'
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: 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