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/handover-sh:handover-sh-reports-api"

All apis

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

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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.2.0
info:
  title: Handover Reports API
  version: 1.16.0
  description: Versioned context and revision-anchored review shared by humans and agents. Browser requests use the signed-in human session; agents authenticate with a scoped bearer credential.
servers:
- url: /api/v1
security:
- bearerAuth: []
tags:
- name: Reports
paths:
  /reports:
    get:
      operationId: listReporterContexts
      summary: List Reporter-compatible published reports
      responses:
        '200':
          description: Published reports
      tags:
      - Reports
    post:
      operationId: deployReporterContext
      summary: Publish a Reporter-compatible folder payload
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ReporterDeployInput'
      responses:
        '201':
          description: Report published
      tags:
      - Reports
  /reports/{slug}:
    parameters:
    - name: slug
      in: path
      required: true
      schema:
        type: string
    get:
      operationId: getReporterContext
      summary: Inspect a Reporter-compatible report
      responses:
        '200':
          description: Report descriptor
      tags:
      - Reports
    put:
      operationId: updateReporterContext
      summary: Replace report files with a new immutable revision
      responses:
        '200':
          description: Report republished
      tags:
      - Reports
  /reports/{slug}/pull:
    post:
      operationId: pullReporterContext
      summary: Pull report files with binary-safe encodings
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Report files and pull manifest data
      tags:
      - Reports
components:
  schemas:
    ReporterFile:
      type: object
      additionalProperties: false
      required:
      - path
      - content
      properties:
        path:
          type: string
        content:
          type: string
        content_type:
          type: string
        encoding:
          type: string
          enum:
          - utf-8
          - base64
    ReporterDeployInput:
      type: object
      additionalProperties: false
      required:
      - name
      - files
      properties:
        name:
          type: string
        slug:
          type: string
        description:
          type: string
        entry_file:
          type: string
        access:
          type: string
          enum:
          - organization
          - public
        files:
          type: array
          minItems: 1
          maxItems: 50
          items:
            $ref: '#/components/schemas/ReporterFile'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: hnd_tok_<id>_<secret>
      description: Scoped agent credential. Create it from the People & agents view; the secret is shown once.