FirstSales System API

Service health.

GitHub OpenAPI

Operations 1

GET /api/v1/health Service health check #

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/firstsales-io:firstsales-io-system-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.

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

OpenAPI Specification

firstsales-io-system-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Firstsales Io System API
  version: 1.0.0
  contact:
    name: FirstSales Support
    email: firstsales@support.communicate.so
    url: https://firstsales.io
  license:
    name: Terms of Service
    url: https://firstsales.io/terms-of-service/
  termsOfService: https://firstsales.io/terms-of-service/
  x-apiVersioning:
    strategy: url-path
    current: v1
    pattern: https://firstsales.io/api/v1/{operation}
    policyUrl: https://firstsales.io/developers/#versioning
    note: A breaking change ships under a new prefix (/api/v2/); v1 keeps its contract. The unprefixed /api/{operation} form is an unversioned alias of the current version and may change without notice - call the /api/v1/ form.
  x-deprecationPolicy:
    minimumNoticeDays: 180
    signalling: 'A deprecated version''s responses carry Deprecation: true and a Sunset header with the retirement date (RFC 8594), plus a Link rel="deprecation" to the migration notes.'
    announcement: https://firstsales.io/developers/#deprecation-policy
    policyUrl: https://firstsales.io/developers/#deprecation-policy
    currentlyDeprecated: []
  description: 'Operations tagged System across 2 of this provider''s published API definitions: firstsales-io-openapi.json, openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://firstsales.io
  description: Production
security: []
tags:
- name: System
  description: Service health.
paths:
  /api/v1/health:
    get:
      operationId: getHealth
      summary: Service health check
      description: Returns service status, ISO timestamp, and process uptime in seconds. Call this to confirm the API is reachable before calling other endpoints. Limited to 120 requests per minute per IP, and every response carries the RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset and RateLimit-Policy headers so an agent can read the live contract from a single unauthenticated GET.
      tags:
      - System
      security: []
      responses:
        '200':
          description: Service is healthy.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HealthResponse'
        '400':
          description: Invalid request — bad input, missing field, or malformed value.
          headers:
            RateLimit-Limit:
              description: Requests allowed in the current window.
              schema:
                type: integer
            RateLimit-Remaining:
              description: Requests still available in the current window.
              schema:
                type: integer
            RateLimit-Reset:
              description: Seconds until the current window resets.
              schema:
                type: integer
            RateLimit-Policy:
              description: Policy in the form "<limit>;w=<window seconds>".
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Rate limit exceeded for this endpoint. Wait Retry-After seconds and retry.
          headers:
            RateLimit-Limit:
              description: Requests allowed in the current window.
              schema:
                type: integer
            RateLimit-Remaining:
              description: Requests still available in the current window.
              schema:
                type: integer
            RateLimit-Reset:
              description: Seconds until the current window resets.
              schema:
                type: integer
            RateLimit-Policy:
              description: Policy in the form "<limit>;w=<window seconds>".
              schema:
                type: string
            Retry-After:
              description: Seconds to wait before retrying.
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Unexpected server error.
          headers:
            RateLimit-Limit:
              description: Requests allowed in the current window.
              schema:
                type: integer
            RateLimit-Remaining:
              description: Requests still available in the current window.
              schema:
                type: integer
            RateLimit-Reset:
              description: Seconds until the current window resets.
              schema:
                type: integer
            RateLimit-Policy:
              description: Policy in the form "<limit>;w=<window seconds>".
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
    servers:
    - url: https://firstsales.io
      description: Production
components:
  schemas:
    Error:
      type: object
      description: Shared error envelope used by public endpoints and the rate-limit wrapper. Mail-tester handler errors use MailTesterError.
      properties:
        error:
          type: string
          description: Machine-readable error code, e.g. `invalid_input`.
        message:
          type: string
          description: Human-readable explanation.
        hint:
          type: string
          description: How to fix the request.
      required:
      - error
      - message
      - hint
    HealthResponse:
      type: object
      properties:
        status:
          type: string
          enum:
          - ok
        timestamp:
          type: string
          format: date-time
        uptime:
          type: number
          description: Process uptime in seconds.
      required:
      - status
      - timestamp
      - uptime
x-refined-from:
- firstsales-io-openapi.json
- openapi.json
x-apiVersioning:
  strategy: url-path
  current: v1
  pattern: https://firstsales.io/api/v1/{operation}
  policyUrl: https://firstsales.io/developers/#versioning
  note: A breaking change ships under a new prefix (/api/v2/); v1 keeps its contract. The unprefixed /api/{operation} form is an unversioned alias of the current version and may change without notice - call the /api/v1/ form.
x-deprecationPolicy:
  minimumNoticeDays: 180
  signalling: 'A deprecated version''s responses carry Deprecation: true and a Sunset header with the retirement date (RFC 8594), plus a Link rel="deprecation" to the migration notes.'
  announcement: https://firstsales.io/developers/#deprecation-policy
  policyUrl: https://firstsales.io/developers/#deprecation-policy
  currentlyDeprecated: []