Test Specifications · JSON Structure

Test Specifications Structure

Structural documentation for API test specification documents.

Type: object Properties: 0
Acceptance TestingContract TestingDocumentationOpenAPIQuality AssuranceTesting

Test Specifications Structure is a JSON Structure definition published by Test Specifications.

Meta-schema:

JSON Structure

test-specifications-structure.json Raw ↑
{
  "title": "Test Specification Structure",
  "description": "Structural documentation for API test specification documents.",
  "type": "object",
  "fields": [
    { "name": "id", "type": "string", "required": true },
    { "name": "name", "type": "string", "required": true },
    { "name": "version", "type": "string", "required": true },
    { "name": "description", "type": "string", "required": false },
    {
      "name": "scope",
      "type": "object",
      "required": true,
      "description": "The API or system this specification covers.",
      "fields": [
        { "name": "name", "type": "string", "required": true },
        { "name": "version", "type": "string", "required": false },
        { "name": "specificationUrl", "type": "string", "format": "uri", "required": false }
      ]
    },
    {
      "name": "format",
      "type": "string",
      "required": false,
      "enum": ["openapi", "asyncapi", "json-schema", "gherkin", "pact", "hurl", "custom"]
    },
    {
      "name": "testCases",
      "type": "array",
      "required": false,
      "items": {
        "type": "object",
        "fields": [
          { "name": "id", "type": "string", "required": true },
          { "name": "name", "type": "string", "required": true },
          { "name": "description", "type": "string", "required": false },
          { "name": "given", "type": "object", "required": true },
          { "name": "expected", "type": "object", "required": true },
          { "name": "priority", "type": "string", "required": false },
          { "name": "tags", "type": "array", "required": false }
        ]
      }
    },
    { "name": "conformanceLevels", "type": "array", "required": false },
    { "name": "tags", "type": "array", "required": false },
    { "name": "created", "type": "string", "format": "date", "required": false },
    { "name": "modified", "type": "string", "format": "date", "required": false }
  ]
}

Work with this as data

Every JSON Structure 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 json structure

4 MCP tools reach this
  • find_json_structuresBrowse and filter every JSON Structure in the catalog.
  • 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 JSON Structure
curl "https://apis.io/api/v1/json-structures/test-specifications-structure"
All json structure
curl "https://apis.io/api/v1/json-structures?limit=25"

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

Get an API key

Free tier, no email required.

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