IsraBase Companies API
The Companies API from IsraBase — 4 operation(s) for companies.
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/israbase-com:israbase-com-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 Specification
openapi: 3.2.0
info:
title: IsraBase Companies API
version: 1.0.0
contact:
name: IsraBase
url: https://israbase.com/developers
email: api@israbase.com
license:
name: 'Data: data.gov.il open data'
url: https://data.gov.il
x-logo:
url: https://israbase.com/icon.svg
altText: IsraBase
summary: Israeli companies, nonprofits, partnerships and the business-for-sale board.
description: 'Read-only JSON API for the IsraBase registry (ישראבייס). Data comes from data.gov.il. Credit IsraBase and data.gov.il when you reuse it. Anonymous clients: 5 requests per minute and 50 per UTC day. A free API key: 5 per minute and 50 per UTC day. Send the key as Authorization: Bearer or as X-API-Key. A key is optional. A free key uses the same limits. Request a free key at https://israbase.com/developers/key. For a higher quota, write to api@israbase.com. Query q is at most 100 characters. Query limit is at most 100, except marketplace listings which allow at most 50. A 401, a 429, and a response to a request with an API key include RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset. Those responses are Cache-Control: private, no-store. An anonymous 200 may be cached and does not include those counters. A 429 response also includes Retry-After.'
servers:
- url: https://israbase.com
security:
- bearerAuth: []
- apiKeyHeader: []
- {}
tags:
- name: Companies
paths:
/api/v1/companies/by-city:
get:
operationId: listCompaniesByCity
summary: Visible companies in one city
parameters:
- name: city
in: query
required: true
schema:
type: string
minLength: 1
maxLength: 80
description: Exact Hebrew city name.
- name: limit
in: query
schema:
type: integer
minimum: 1
maximum: 100
default: 20
- name: offset
in: query
schema:
type: integer
minimum: 0
maximum: 200000
default: 0
- name: page
in: query
schema:
type: integer
minimum: 1
description: 1-based page. Do not send page and offset together.
responses:
'200':
description: Visible companies. count, limit, offset, city and data.
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'429':
$ref: '#/components/responses/TooManyRequests'
tags:
- Companies
/api/v1/companies/by-year:
get:
operationId: listCompaniesByYear
summary: Visible companies registered in one year
parameters:
- name: year
in: query
required: true
schema:
type: integer
minimum: 1900
maximum: 2026
description: Registration year, 1900 to 2026.
- name: limit
in: query
schema:
type: integer
minimum: 1
maximum: 100
default: 20
- name: offset
in: query
schema:
type: integer
minimum: 0
maximum: 200000
default: 0
- name: page
in: query
schema:
type: integer
minimum: 1
description: 1-based page. Do not send page and offset together.
responses:
'200':
description: Visible companies. count, limit, offset, year and data.
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'429':
$ref: '#/components/responses/TooManyRequests'
tags:
- Companies
/api/v1/companies/by-type:
get:
operationId: listCompaniesByType
summary: Visible companies in one segment
parameters:
- name: type
in: query
required: true
schema:
type: string
enum:
- government
- public
- foreign
- bonds
- name: limit
in: query
schema:
type: integer
minimum: 1
maximum: 100
default: 20
- name: offset
in: query
schema:
type: integer
minimum: 0
maximum: 200000
default: 0
- name: page
in: query
schema:
type: integer
minimum: 1
description: 1-based page. Do not send page and offset together.
responses:
'200':
description: Visible companies. count, limit, offset, type and data.
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'429':
$ref: '#/components/responses/TooManyRequests'
tags:
- Companies
/api/v1/companies/recent:
get:
operationId: listRecentCompanies
summary: Newest visible companies by incorporation date
parameters:
- name: limit
in: query
schema:
type: integer
minimum: 1
maximum: 100
default: 20
- name: offset
in: query
schema:
type: integer
minimum: 0
maximum: 200000
default: 0
- name: page
in: query
schema:
type: integer
minimum: 1
description: 1-based page. Do not send page and offset together.
responses:
'200':
description: Visible companies. count, limit, offset and data.
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'429':
$ref: '#/components/responses/TooManyRequests'
tags:
- Companies
components:
responses:
BadRequest:
description: A query parameter is missing or invalid.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorObject'
example:
error:
code: invalid_request
message: city is required.
Unauthorized:
description: The API key is missing a match, empty, or revoked.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorObject'
example:
error:
code: invalid_api_key
message: Invalid API key.
TooManyRequests:
description: Minute or UTC-day quota exceeded.
headers:
Retry-After:
schema:
type: integer
description: Seconds until the client may retry.
RateLimit-Limit:
schema:
type: integer
RateLimit-Remaining:
schema:
type: integer
RateLimit-Reset:
schema:
type: integer
description: Seconds until this window resets.
content:
application/json:
schema:
$ref: '#/components/schemas/RateLimited'
example:
error:
code: rate_limited
message: Rate limit exceeded. Retry after 12 seconds.
retry_after: 12
schemas:
RateLimited:
type: object
required:
- error
properties:
error:
type: object
required:
- code
- message
- retry_after
properties:
code:
const: rate_limited
message:
type: string
examples:
- Rate limit exceeded. Retry after 12 seconds.
retry_after:
type: integer
examples:
- 12
ErrorObject:
type: object
required:
- error
properties:
error:
type: object
required:
- code
- message
properties:
code:
type: string
message:
type: string
retry_after:
type: integer
description: Seconds. Present when code is rate_limited.
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: Optional free API key. An invalid key returns 401.
apiKeyHeader:
type: apiKey
in: header
name: X-API-Key
description: Optional API key. Same key as bearerAuth.