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/hemrock-com:hemrock-com-usage-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: Hemrock Com Usage API
  version: 0.1.0
  description: 'Operations tagged Usage across 2 of this provider''s published API definitions: hemrock-com-openapi.json, hemrock_com_openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.hemrock.com/v1
  description: Production
security:
- bearerAuth: []
tags:
- name: Usage
paths:
  /usage:
    get:
      summary: Get compute usage
      operationId: getUsage
      description: Return access and UTC daily usage for an inclusive date range of at most 366 days.
      security:
      - bearerAuth: []
      parameters:
      - name: from
        in: query
        required: false
        description: First UTC day, inclusive.
        schema:
          type: string
          format: date
      - name: to
        in: query
        required: false
        description: Last UTC day, inclusive.
        schema:
          type: string
          format: date
      responses:
        '200':
          description: Product access and daily usage
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccessResponse'
        '400':
          description: Invalid YYYY-MM-DD range or range exceeds 366 days
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - Usage
    servers:
    - url: https://api.hemrock.com/v1
      description: Production
components:
  schemas:
    ProductAccess:
      type: object
      required:
      - product
      - name
      - priceUsd
      - allowance
      - period
      - remaining
      - active
      properties:
        product:
          type: string
          enum:
          - cap-table
          - fund-economics
        name:
          type: string
        priceUsd:
          type: number
          const: 20
        allowance:
          type: integer
          const: 6000
        period:
          anyOf:
          - type: 'null'
          - $ref: '#/components/schemas/UsagePeriod'
        remaining:
          type: integer
          minimum: 0
          description: 'Calculations this account can run now: the paid balance while a paid period is active, otherwise the lifetime free balance.'
        active:
          type: boolean
          description: Active paid term; use state/freeRemaining for trial access.
        state:
          type: string
          enum:
          - free_available
          - free_exhausted
          - paid_active
          - paid_expired
          - paid_quota_exhausted
        source:
          type: string
          enum:
          - free
          - paid
        freeRemaining:
          type: integer
          minimum: 0
        paidRemaining:
          type: integer
          minimum: 0
        paidExpiration:
          type:
          - string
          - 'null'
        nextAction:
          type: string
    DailyUsage:
      type: object
      required:
      - day
      - product
      - endpoint
      - source
      - succeeded
      - failed
      properties:
        day:
          type: string
          format: date
        product:
          type: string
          enum:
          - cap-table
          - fund-economics
        endpoint:
          type: string
        source:
          type: string
        succeeded:
          type: integer
        failed:
          type: integer
    UsagePeriod:
      type: object
      required:
      - id
      - period_start
      - period_end
      - allowance
      - consumed
      - reserved
      - enabled
      properties:
        id:
          type: string
        period_start:
          type: string
          format: date-time
        period_end:
          type: string
          format: date-time
        allowance:
          type: integer
        consumed:
          type: integer
        reserved:
          type: integer
        enabled:
          type: boolean
    MonthlyUsage:
      type: object
      required:
      - month
      - product
      - succeeded
      - failed
      properties:
        month:
          type: string
          pattern: ^[0-9]{4}-[0-9]{2}$
        product:
          type: string
          enum:
          - cap-table
          - fund-economics
        succeeded:
          type: integer
        failed:
          type: integer
    AccessResponse:
      type: object
      properties:
        data:
          type: object
          required:
          - products
          - daily
          properties:
            products:
              type: array
              items:
                $ref: '#/components/schemas/ProductAccess'
            daily:
              type: array
              items:
                $ref: '#/components/schemas/DailyUsage'
            monthly:
              type: array
              items:
                $ref: '#/components/schemas/MonthlyUsage'
            periods:
              type: array
              items:
                allOf:
                - $ref: '#/components/schemas/UsagePeriod'
                - type: object
                  required:
                  - product
                  properties:
                    product:
                      type: string
                      enum:
                      - cap-table
                      - fund-economics
    Error:
      type: object
      properties:
        error:
          type: object
          required:
          - code
          - message
          - retryable
          properties:
            code:
              type: string
              enum:
              - unauthorized
              - payment_required
              - validation_failed
              - engine_error
              - quota_exhausted
              - rate_limited
              - idempotency_conflict
              - service_unavailable
              - method_not_allowed
              - internal_error
            message:
              type: string
            retryable:
              type: boolean
            details: {}
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'Your API key (`hk_live_…`), created in the Hemrock developer dashboard. Calls use that account’s product access: lifetime free credits or an active paid allowance.'
x-refined-from:
- hemrock-com-openapi.json


# --- truncated at 32 KB (61 KB total) ---
# Full source: https://artifacts.apis.io/hemrock-com/openapi/hemrock-com-usage-api-openapi.yml