IsraBase Company API

openapi: 3.2.0
info:
  title: IsraBase Company 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: Company
paths:
  /api/v1/company/{id}:
    get:
      operationId: getCompany
      summary: One company by ח.פ
      parameters:
      - name: id
        in: path
        required: true
        description: Company number (ח.פ)
        schema:
          type: integer
      responses:
        '200':
          description: Company record plus canonical url, nesach_url and annual_report_compliant.
          content:
            application/json:
              example:
                data:
                  company_number: 520013954
                  name_he: דוגמה בע"מ
                  status: פעילה
                  url: https://israbase.com/company/520013954
                  nesach_url: https://israbase.com/nesach?company=520013954
                  annual_report_compliant: true
                  is_violator: ''
                source: data.gov.il/ica_companies
        '400':
          description: Invalid company number
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          description: Company not found
        '429':
          $ref: '#/components/responses/TooManyRequests'
      tags:
      - Company
components:
  schemas:
    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.
    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
  responses:
    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
    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.
  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.