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/apiable:apiable-companies-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: 3.2.0
info:
title: Apiable Platform Companies API
description: '## Introduction
The Apiable Platform API is a RESTful API that allows you to manage your portal, teams, users, and subscriptions. The API is designed to be simple and easy to use, with a focus on security and performance. The Platform API is designed to be used by developers to build custom integrations and applications that interact with the Apiable Portal. The included endpoints allow you to manage, including, but not limited to, your portal products, plans, teams, users, and subscriptions. ## Authentication
The authentication is done using a Bearer token, that must be included in all requests. ## Errors
The API uses standard HTTP status codes to indicate the success or failure of a request. In case of an error, the response body will contain a JSON object with an error message. ## Rate Limiting
## Pagination and Filtering
Calls that return multiple items will be paginated to 10 items by default. You can specify further pages with the `page` parameter. For most such resources, you can also set a custom page size up to 100 with the `size` parameter. Requests that return multiple items also include `search` parameter to filter the results. ## Versioning
The API is versioned using the `X-API-Version` header. The API responses always with latest version, if not set otherwise. ## Glossary of Terms
### Product
The product object represents a high-level abstraction of your API products. It is used to group plans together and to provide a high-level overview of the product. A product can have multiple plans associated with it. Products are typically used to group plans together that are related to a specific API or service. ### Plan
The plan object represents a subscription plan that can be associated with a product. A plan can have multiple APIs associated with it. Plans can be free or paid, and can have different pricing models. ### Subscription
The subscription object represents a subscription to a plan. Subscriptions, both paid and free, are associated with a team, and a single user as the primary owner of the subscription. The owner of the subscription is considered to be the one responsible for the billing of the subscription. Depending on the permissions within a team, API key and billing information can be viewed managed by not just the subscription owner, but other members of the team as well. ### Team
The team object represents a group of users that work together. A team can have multiple members and can be associated with a company. Teams are a way to group users together and manage permissions and roles within a group. ### Company
The company object represents a group of teams. A company can have multiple teams associated with it. Companies are a way to manage multiple teams and users together. Companies do not have roles and permissions, nor are subscriptions shared between different teams under the same company. ### User
The user object represents a user of the platform. A user can be a member of one or more teams and can have different roles and permissions within each team. Users can be invited to join a team, and can be assigned different roles and permissions within a team. ### Invitation
The invitation object represents an invitation to join a team. Invitations are typically sent by team members to new users, and can be accepted or ignored by the invitee. Invitations can be sent to users that are not yet registered on the platform, and can be used to invite new users to join the platform and team of the inviter. ### Webhook
The webhook object represents a webhook that can be used to receive notifications about events that occur on the platform. Webhooks can be used to trigger actions in external systems based on events that occur on the platform. Webhooks can be configured to send notifications for specific events, such as when a new subscription is created, or when a subscription is updated. ### API Key Tutorial
To interact with the API, you will need to obtain an JWT Access Token.'
contact:
name: Apiable Team
url: https://apiable.io
email: support@apiable.io
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
version: v2
servers:
- url: https://developer.apiable.io
tags:
- name: Companies
description: Companies, similar to teams are a way to group users together. Companies are a way to manage multiple teams and users together. An example being a company that has teams for different departments, such as backend and frontend development teams.Multiple teams can be part of the same company, and unlike teams, companies do not have roles and permissions, nor are subscriptions shared between different teams under the same company.
paths:
/api/companies/{id}:
get:
tags:
- Companies
summary: Get company by ID
description: Fetches a specific company by its unique identifier.
operationId: findCompanyById
parameters:
- name: id
in: path
description: Company ID to retrieve
required: true
style: simple
explode: false
schema:
type: string
example: 6268ec80a098ed05f047f278
- name: X-API-Version
in: header
description: API version to use.
required: false
style: simple
explode: false
schema:
type: string
enum:
- '2024-09-25'
responses:
'200':
description: 'OK: Successfully retrieved the company details.'
content:
application/json:
schema:
description: Company
properties:
version:
type: integer
format: int32
created:
type: string
format: date-time
updated:
type: string
format: date-time
id:
type: string
domain:
type: string
description: 'The domain name of the company. e.g: "example.com"'
name:
type: string
description: The name of the company, defaults to the domain name of the company.
examples:
Example response:
description: Example company.
value:
id: 6697dd1e54d9ff2d372e135f
created: '2024-07-17T17:02:54.005'
updated: '2024-07-17T17:02:54.005'
domain: yahoo.com
name: Saruman Rings S.A.
version: 0
'401':
description: 'Unauthorized for operation: findCompanyById'
content:
application/json:
schema:
type: object
properties:
message:
type: string
example: Unauthorized
status:
type: string
example: '401'
'404':
description: 'Not Found: The requested company does not exist.'
content:
application/json:
schema:
type: string
examples:
NotFound:
description: Error message when the retrieved company is not found.
value: Company not found
security:
- oauth-cc:
- apiable/platform
patch:
tags:
- Companies
summary: Update a company
description: Updates a company with the provided fields using JSON patch operations.
operationId: updateCompany
parameters:
- name: id
in: path
description: The ID of the company to be updated
required: true
style: simple
explode: false
schema:
type: string
example: 6268ec80a098ed05f047f278
- name: X-API-Version
in: header
description: API version to use.
required: false
style: simple
explode: false
schema:
type: string
enum:
- '2024-09-25'
requestBody:
description: 'Request body for operation: updateCompany.'
content:
application/json:
schema:
type: array
items:
description: Patch object for subscription
properties:
op:
type: string
description: Supported patch operations
enum:
- replace
path:
type: string
description: Supported patch paths for Subscription
enum:
- /name
- /expires
- /stripeSubscriptionId
- /priceIds
- /usageMeter
- /owner
- /email
value:
type: string
examples:
Example patch operations:
description: Patch operation to update the company name.
value:
- op: replace
path: /name
value: Mordor Rings Inc.
required: true
responses:
'200':
description: 'OK: Company updated successfully.'
content:
application/json:
schema:
description: Company
properties:
version:
type: integer
format: int32
created:
type: string
format: date-time
updated:
type: string
format: date-time
id:
type: string
domain:
type: string
description: 'The domain name of the company. e.g: "example.com"'
name:
type: string
description: The name of the company, defaults to the domain name of the company.
examples:
Example response:
description: Updated company.
value:
id: 6697dd1e54d9ff2d372e135f
created: '2024-07-17T17:02:54.005'
updated: '2024-07-17T17:02:54.005'
domain: yahoo.com
name: Saruman Rings S.A.
version: 0
'400':
description: 'Bad Request: Invalid update parameters or operation.'
content:
application/json:
schema:
type: string
examples:
BadRequest:
description: Error message when the patch operation is not allowed for the company.
value: Invalid patch operation
'401':
description: 'Unauthorized for operation: updateCompany'
content:
application/json:
schema:
type: object
properties:
message:
type: string
example: Unauthorized
status:
type: string
example: '401'
'404':
description: 'Not Found: The company to be updated does not exist.'
content:
application/json:
schema:
type: string
examples:
NotFound:
description: Error message when the company to be updated is not found.
value: Company not found
security:
- oauth-cc:
- apiable/platform
/api/companies:
get:
tags:
- Companies
summary: Get list of companies
description: Retrieves a paginated, sortable, and filterable list of all companies from the platform. Returns basic company information such as ID, name, and creation date. This operation supports pagination, sorting by various properties, and filtering using search parameters.
operationId: findAllCompanies
parameters:
- name: page
in: query
description: Zero-based page index for the findAllCompanies operation
required: false
style: form
explode: true
schema:
type: integer
format: int32
example: 0
- name: size
in: query
description: Number of companies per page in the findAllCompanies results
required: false
style: form
explode: true
schema:
type: integer
format: int32
example: 10
- name: sort
in: query
description: 'Sorting criteria for companies, in the format: property,asc|desc'
required: false
style: form
explode: true
schema:
type: array
items:
type: string
example:
- created,desc
- name: search
in: query
description: 'Search filter for companies, in the format: property.op=value'
required: false
style: form
explode: true
schema:
type: array
items:
type: string
example:
- name.contains=example
- name: X-API-Version
in: header
description: API version to use.
required: false
style: simple
explode: false
schema:
type: string
enum:
- '2024-09-25'
- name: resolve
in: query
required: false
style: form
explode: true
schema:
type: array
items:
type: string
responses:
'200':
description: Successfully retrieved the list of companies that match the search and pagination criteria.
content:
application/json:
schema:
description: Response object for paginated company results
properties:
content:
type: array
items:
description: Company
properties:
version:
type: integer
format: int32
created:
type: string
format: date-time
updated:
type: string
format: date-time
id:
type: string
domain:
type: string
description: 'The domain name of the company. e.g: "example.com"'
name:
type: string
description: The name of the company, defaults to the domain name of the company.
pageable:
description: The PageableObject schema is used to represent pagination information for API responses. It includes details such as the current page number, size of the page, total number of pages, and total number of items available.
properties:
offset:
type: integer
format: int64
pageNumber:
type: integer
format: int32
pageSize:
type: integer
format: int32
paged:
type: boolean
unpaged:
type: boolean
sort:
description: The SortObject schema is used to represent sorting information for API responses.
properties:
empty:
type: boolean
sorted:
type: boolean
unsorted:
type: boolean
last:
type: boolean
totalElements:
type: integer
format: int64
totalPages:
type: integer
format: int32
size:
type: integer
format: int32
number:
type: integer
format: int32
sort:
description: The SortObject schema is used to represent sorting information for API responses.
properties:
empty:
type: boolean
sorted:
type: boolean
unsorted:
type: boolean
first:
type: boolean
numberOfElements:
type: integer
format: int32
empty:
type: boolean
examples:
Example response:
description: Example list of companies matching the request.
value:
content:
- id: 6697dd1e54d9ff2d372e135f
created: '2024-07-17T17:02:54.005'
updated: '2024-07-17T17:02:54.005'
domain: yahoo.com
name: Saruman Rings S.A.
version: 0
- id: 6697e00e54d9ff2d372e13d9
created: '2024-07-17T17:15:26.776'
updated: '2024-07-17T17:15:26.776'
domain: apiable.io
name: Gondor Rings Inc.
version: 0
pageable:
pageNumber: 0
pageSize: 10
sort:
empty: false
unsorted: false
sorted: true
offset: 0
paged: true
unpaged: false
last: true
totalElements: 2
totalPages: 1
size: 10
number: 0
sort:
empty: false
unsorted: false
sorted: true
first: true
numberOfElements: 2
empty: false
'401':
description: 'Unauthorized for operation: findAllCompanies'
content:
application/json:
schema:
type: object
properties:
message:
type: string
example: Unauthorized
status:
type: string
example: '401'
security:
- oauth-cc:
- apiable/platform
components:
securitySchemes:
oauth-cc:
type: oauth2
description: 'OAuth 2.0: Client Credentials'
flows:
clientCredentials:
tokenUrl: https://developer.apiable.io/api/oauth2/token
scopes: {}
x-receive-token-in: request-body
x-client-id: ''
x-client-secret: ''