toolaby-app Customers API
The Customers API from toolaby-app — 2 operation(s) for customers.
The Customers API from toolaby-app — 2 operation(s) for customers.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/toolaby-app:toolaby-app-customers-api"
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.
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: 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_….'