Sample

Sample API

Sample API as documented publicly: 2 operations. Contract generated from the documentation by API Evangelist (2026-10-18); not the provider's own document.

Documentation GitHub OpenAPI

Operations 2

GET /api/v1/sql GET /api/v1/sql #

POST /api/v1/sql POST /api/v1/sql #

Specifications

⚙

OpenAPI

https://raw.githubusercontent.com/api-evangelist/samplehc/refs/heads/main/openapi/_ae-authored/samplehc-openapi-generated.yml

Schemas & Data

📊

JSONSchema

https://raw.githubusercontent.com/api-evangelist/samplehc/refs/heads/main/json-schema/samplehc-get-api-v1-sql-response-schema.json

📊

JSONSchema

https://raw.githubusercontent.com/api-evangelist/samplehc/refs/heads/main/json-schema/samplehc-post-api-v1-sql-response-schema.json

Work with this as data

Every API 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 apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
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 API

curl "https://apis.io/api/v1/apis/samplehc:samplehc-api"

All apis

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

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.

OpenAPI Specification

openapi: 3.1.0
info:
  title: Sample API
  version: '2026-10-18'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-18: 2 operation(s) read from 2 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; Sample has published no machine-readable contract that the pipeline
    could find. Engine: local.'
  x-evidence-tiers:
    code-example: 2
    documentation: 0
    pages-with-code: 1
    pages-read: 2
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-18'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://docs.samplehc.com/api-reference/v1/execute-sql-query
  - https://docs.samplehc.com/api-reference/task/retry-task.md
paths:
  /api/v1/sql:
    get:
      operationId: get_api_v1_sql
      tags:
      - Api
      summary: GET /api/v1/sql
      x-source: https://docs.samplehc.com/api-reference/v1/execute-sql-query
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1SqlResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl);\nif ($err) {\n echo \"cURL Error #:\" . $err;\n} else {\n echo $response;\n} package main\nimport (\n \"fmt\"\n \"strings\"\
          \n \"net/http\"\n \"io\"\n)\nfunc main() {\n url := \"https://api.example.com/api/v1/sql\"\n payload := strings.NewReader(\"{\\n \\\"\
          query\\\": \\\"<string>\\\",\\n \\\"params\\\": [],\\n \\\"arrayMode\\\": true\\n}\")\n req, _ := http.NewRequest(\"POST\", url, payload)\n\
          \ req.Header.Add(\"Content-Type\", \"application/json\""
    post:
      operationId: post_api_v1_sql
      tags:
      - Api
      summary: POST /api/v1/sql
      x-source: https://docs.samplehc.com/api-reference/v1/execute-sql-query
      responses:
        '201':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiV1SqlResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl curl --request POST  --url https://api.example.com/api/v1/sql  --header 'Content-Type: application/json'  --data ' \n {\
          \ \n \"query\": \"<string>\", \n \"params\": [], \n \"arrayMode\": true \n } \n ' import requests\nurl = \"https://api.example.com/api/v1/sql\"\
          \npayload = {\n \"query\": \"<string>\",\n \"params\": [],\n \"arrayMode\": True\n}\nheaders = {\"Content-Type\": \"application/json\"\
          }\nresponse = requests.post(url, jso"
components:
  schemas:
    GetApiV1SqlResponse:
      type: object
      properties:
        rows:
          type: string
    PostApiV1SqlResponse:
      type: object
      properties:
        rows:
          type: string
  securitySchemes:
    Authorization:
      type: http
      scheme: bearer
      x-source: https://docs.samplehc.com/guides/authentication.md
tags:
- name: Api
security:
- Authorization: []