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/toolaby-app:toolaby-app-customers-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.2.0
info:
  title: Toolaby Customers API
  version: '2026-09-16'
  description: 'Look up whether a person holds a tool, and grant or revoke access. Keys are created under Configure → API and sent as a bearer token. Errors are `{ error: { type, message, param? } }`.'
servers:
- url: /
security:
- bearer: []
tags:
- name: Customers
paths:
  /api/v1/tools/{slug}/customers:
    get:
      tags:
      - Customers
      summary: List customers
      description: Everyone who holds the tool or has signed in to it, newest first. Page with `cursor` from the previous response.
      parameters:
      - schema:
          type: string
          pattern: ^[a-z0-9][a-z0-9-]{1,118}$
          example: invoice-grabber
          description: 'The tool id: the full one (acme--invoice-grabber) or the short one the dashboard shows (invoice-grabber).'
        required: true
        description: 'The tool id: the full one (acme--invoice-grabber) or the short one the dashboard shows (invoice-grabber).'
        name: slug
        in: path
      - schema:
          type: integer
          minimum: 1
          maximum: 500
          default: 50
          description: 1 to 500. Default 50.
        required: false
        description: 1 to 500. Default 50.
        name: limit
        in: query
      - schema:
          type: string
          description: '`next_cursor` from the previous page.'
        required: false
        description: '`next_cursor` from the previous page.'
        name: cursor
        in: query
      - schema:
          type: string
          enum:
          - 'true'
          - 'false'
          description: Only customers who hold the tool now, or only those who do not.
        required: false
        description: Only customers who hold the tool now, or only those who do not.
        name: entitled
        in: query
      responses:
        '200':
          description: A page of customers.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/CustomerListItem'
                  has_more:
                    type: boolean
                  next_cursor:
                    type:
                    - string
                    - 'null'
                required:
                - data
                - has_more
                - next_cursor
        '400':
          description: A parameter is missing or wrong; `param` names it.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: No key, a malformed key, or a revoked one.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: 'The workspace''s plan does not allow it: on Hobby, 100 passes at once.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: No such tool, grant or person in this workspace.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: More than a minute's requests — 600 from this key, 1,200 from the workspace's keys together, 2,400 from its owner's — more than 30 pages of customers in a minute from the workspace, a tool's 1,000 grants in a day, or the workspace's 20,000 additions in a day.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Toolaby's fault, or it cannot count the workspace's additions just now. Retry.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      operationId: getApiV1ToolsBySlugCustomers
      x-operation-id-source: derived
  /api/v1/tools/{slug}/customers/{email}:
    get:
      tags:
      - Customers
      summary: Retrieve a customer
      description: Whether the address holds the tool now, and how. An address with no account still answers for a licence bought under it.
      parameters:
      - schema:
          type: string
          pattern: ^[a-z0-9][a-z0-9-]{1,118}$
          example: invoice-grabber
          description: 'The tool id: the full one (acme--invoice-grabber) or the short one the dashboard shows (invoice-grabber).'
        required: true
        description: 'The tool id: the full one (acme--invoice-grabber) or the short one the dashboard shows (invoice-grabber).'
        name: slug
        in: path
      - schema:
          type: string
          format: email
          example: name@example.com
        required: true
        name: email
        in: path
      responses:
        '200':
          description: The customer.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Customer'
        '400':
          description: A parameter is missing or wrong; `param` names it.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: No key, a malformed key, or a revoked one.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: 'The workspace''s plan does not allow it: on Hobby, 100 passes at once.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: No such tool, grant or person in this workspace.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: More than a minute's requests (600 from this key, 1,200 from the workspace's keys, 2,400 from its owner's), or the workspace's 20,000 lookups in a day — or its owner's, across their workspaces.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Toolaby's fault, or it cannot count the workspace's additions just now. Retry.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      operationId: getApiV1ToolsBySlugCustomersByEmail
      x-operation-id-source: derived
components:
  schemas:
    Customer:
      type: object
      properties:
        email:
          type: string
          format: email
          example: name@example.com
        account:
          type: boolean
          description: The address has signed in to your workspace.
        entitled:
          type: boolean
          description: 'Holds the tool now: by a licence, a subscription, a trial, a grant, or a bundle that names it.'
        via:
          type:
          - string
          - 'null'
          enum:
          - licence
          - subscription
          - trial
          - grant
          - null
        paid_at:
          type:
          - string
          - 'null'
        plan:
          description: 'The plan held: id, name, billing, amountCents, currency, interval. Null when not entitled.'
        subscription: {}
        trial: {}
      required:
      - email
      - account
      - entitled
      - via
      - paid_at
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            type:
              type: string
              enum:
              - authentication_error
              - invalid_request_error
              - idempotency_error
              - plan_limit_error
              - not_found
              - rate_limit_error
              - api_error
            message:
              type: string
            param:
              type: string
          required:
          - type
          - message
      required:
      - error
    CustomerListItem:
      type: object
      properties:
        email:
          type: string
          format: email
          example: name@example.com
        account:
          type: boolean
          description: The address has signed in to your workspace.
        entitled:
          type: boolean
          description: Holds the tool now.
        via:
          type:
          - string
          - 'null'
          enum:
          - licence
          - subscription
          - trial
          - grant
          - null
        since:
          type: string
          description: When they first held the tool, or first signed in to it.
        last_active_at:
          type:
          - string
          - 'null'
          description: The last check-in from any of their devices.
        devices:
          type: integer
          description: Devices signed in or activated.
      required:
      - email
      - account
      - entitled
      - via
      - since
      - last_active_at
      - devices
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      description: 'An API key from the dashboard: wk_test_… or wk_live_….'