AI Demos company relationships API

The company relationships API from AI Demos — 10 operation(s) for company relationships.

Operations 10

GET /v2/company-relationships/intelligence/context Intelligence Context #
GET /v2/company-relationships/intelligence/findings Intelligence Thread Findings #
POST /v2/company-relationships/intelligence/failures Intelligence Failure #
POST /v2/company-relationships/intelligence/batches Intelligence Batch #
POST /v2/company-relationships/intelligence/manual-reviews Manual Intelligence Review #
GET /v2/company-relationships/access-tracker Access Tracker #
GET /v2/company-relationships/access-readiness Get Readiness #
GET /v2/company-relationships/view-status View Status #
POST /v2/company-relationships/refresh Refresh View #
GET /v2/company-relationships Get Dashboard #

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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/aidemos-com:aidemos-com-company-relationships-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.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

aidemos-com-company-relationships-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Aidemos Com company relationships API
  version: 0.1.0
  description: 'Operations tagged company relationships across 2 of this provider''s published API definitions: aidemos-com-openapi.json, mcp-openapi.json. Each path carries the servers of the definition it was published in.'
tags:
- name: company relationships
paths:
  /v2/company-relationships/intelligence/context:
    get:
      tags:
      - company relationships
      summary: Intelligence Context
      operationId: intelligence_context_v2_company_relationships_intelligence_context_get
      parameters:
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      - name: x-api-key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v2/company-relationships/intelligence/findings:
    get:
      tags:
      - company relationships
      summary: Intelligence Thread Findings
      operationId: intelligence_thread_findings_v2_company_relationships_intelligence_findings_get
      parameters:
      - name: threads
        in: query
        required: true
        schema:
          type: string
          title: Threads
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      - name: x-api-key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v2/company-relationships/intelligence/failures:
    post:
      tags:
      - company relationships
      summary: Intelligence Failure
      operationId: intelligence_failure_v2_company_relationships_intelligence_failures_post
      parameters:
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      - name: x-api-key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Failure'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v2/company-relationships/intelligence/batches:
    post:
      tags:
      - company relationships
      summary: Intelligence Batch
      operationId: intelligence_batch_v2_company_relationships_intelligence_batches_post
      parameters:
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      - name: x-api-key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Batch'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v2/company-relationships/intelligence/manual-reviews:
    post:
      tags:
      - company relationships
      summary: Manual Intelligence Review
      operationId: manual_intelligence_review_v2_company_relationships_intelligence_manual_reviews_post
      parameters:
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      - name: x-api-key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ManualReview'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v2/company-relationships/access-tracker:
    get:
      tags:
      - company relationships
      summary: Access Tracker
      operationId: access_tracker_v2_company_relationships_access_tracker_get
      parameters:
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      - name: x-api-key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v2/company-relationships/access-readiness:
    get:
      tags:
      - company relationships
      summary: Get Readiness
      operationId: get_readiness_v2_company_relationships_access_readiness_get
      parameters:
      - name: benchmark
        in: query
        required: false
        schema:
          type: string
          default: ''
          title: Benchmark
      - name: subject
        in: query
        required: false
        schema:
          type: string
          default: ''
          title: Subject
      - name: company
        in: query
        required: false
        schema:
          type: string
          default: ''
          title: Company
      - name: versions
        in: query
        required: false
        schema:
          type: string
          default: current
          title: Versions
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      - name: x-api-key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v2/company-relationships/view-status:
    get:
      tags:
      - company relationships
      summary: View Status
      operationId: view_status_v2_company_relationships_view_status_get
      parameters:
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      - name: x-api-key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v2/company-relationships/refresh:
    post:
      tags:
      - company relationships
      summary: Refresh View
      operationId: refresh_view_v2_company_relationships_refresh_post
      parameters:
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      - name: x-api-key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v2/company-relationships:
    get:
      tags:
      - company relationships
      summary: Get Dashboard
      description: The stored view (rebuilt by the worker; see company_relationship_view). A filtered call is composed live.
      operationId: get_dashboard_v2_company_relationships_get
      parameters:
      - name: search
        in: query
        required: false
        schema:
          type: string
          default: ''
          title: Search
      - name: owner
        in: query
        required: false
        schema:
          type: string
          default: ''
          title: Owner
      - name: subject
        in: query
        required: false
        schema:
          type: string
          default: ''
          title: Subject
      - name: benchmark
        in: query
        required: false
        schema:
          type: string
          default: ''
          title: Benchmark
      - name: company
        in: query
        required: false
        schema:
          type: string
          default: ''
          title: Company
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      - name: x-api-key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    ManualCoverage:
      properties:
        thread_dispositions:
          additionalProperties:
            type: string
            enum:
            - reviewed
            - unrelated
            - unresolved
          type: object
          title: Thread Dispositions
        review_methods:
          additionalProperties:
            type: string
            enum:
            - full_word_content
            - prior_unchanged_authority
            - metadata_only_exclusion
            - delivery_notice_projection
          type: object
          title: Review Methods
        threads:
          type: integer
          maximum: 100.0
          minimum: 1.0
          title: Threads
        messages:
          type: integer
          maximum: 1000.0
          minimum: 1.0
          title: Messages
      additionalProperties: false
      type: object
      required:
      - thread_dispositions
      - review_methods
      - threads
      - messages
      title: ManualCoverage
    Attachment:
      properties:
        filename:
          type: string
          maxLength: 1000
          title: Filename
        mime_type:
          anyOf:
          - type: string
            maxLength: 200
          - type: 'null'
          title: Mime Type
        size:
          anyOf:
          - type: integer
            minimum: 0.0
          - type: 'null'
          title: Size
        attachment_id:
          anyOf:
          - type: string
            maxLength: 3000
          - type: 'null'
          title: Attachment Id
      additionalProperties: false
      type: object
      required:
      - filename
      title: Attachment
    Batch:
      properties:
        schema_version:
          type: integer
          const: 1
          title: Schema Version
        run_id:
          type: string
          maxLength: 150
          minLength: 8
          title: Run Id
        session_id:
          type: string
          pattern: ^(session_|cse_)[A-Za-z0-9]+$
          title: Session Id
        behavior_version:
          type: string
          enum:
          - company-intelligence-v1
          - company-intelligence-v2
          title: Behavior Version
        mailbox:
          type: string
          const: collaborate@aidemos.com
          title: Mailbox
        previous_cursor:
          anyOf:
          - $ref: '#/components/schemas/Cursor'
          - type: 'null'
        next_cursor:
          $ref: '#/components/schemas/Cursor'
        coverage:
          $ref: '#/components/schemas/Coverage'
        communications:
          items:
            $ref: '#/components/schemas/Communication'
          type: array
          maxItems: 1000
          title: Communications
        bindings:
          items:
            $ref: '#/components/schemas/Binding'
          type: array
          maxItems: 100
          title: Bindings
        findings:
          items:
            $ref: '#/components/schemas/Finding'
          type: array
          maxItems: 300
          title: Findings
      additionalProperties: false
      type: object
      required:
      - schema_version
      - run_id
      - session_id
      - behavior_version
      - mailbox
      - previous_cursor
      - next_cursor
      - coverage
      - communications
      - bindings
      - findings
      title: Batch
    Cursor:
      properties:
        history_id:
          type: string
          maxLength: 100
          pattern: ^\d+$
          title: History Id
        history_page_token:
          anyOf:
          - type: string
            maxLength: 5000
          - type: 'null'
          title: History Page Token
        backfill_page_token:
          anyOf:
          - type: string
            maxLength: 5000
          - type: 'null'
          title: Backfill Page Token
        backfill_complete:
          type: boolean
          title: Backfill Complete
        outstanding_offset:
          type: integer
          minimum: 0.0
          title: Outstanding Offset
          default: 0
      additionalProperties: false
      type: object
      required:
      - history_id
      - backfill_complete
      title: Cursor
    Binding:
      properties:
        thread_id:
          type: string
          pattern: ^[a-f0-9]{8,32}$
          title: Thread Id
        company_id:
          type: string
          format: uuid
          title: Company Id
        reason:
          type: string
          maxLength: 1500
          minLength: 10
          title: Reason
        evidence_message_ids:
          items:
            type: string
          type: array
          maxItems: 30
          minItems: 1
          title: Evidence Message Ids
      additionalProperties: false
      type: object
      required:
      - thread_id
      - company_id
      - reason
      - evidence_message_ids
      title: Binding
    ManualAuthority:
      properties:
        provider:
          type: string
          const: codex
          title: Provider
        session_id:
          type: string
          format: uuid
          title: Session Id
      additionalProperties: false
      type: object
      required:
      - provider
      - session_id
      title: ManualAuthority
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    ManualReview:
      properties:
        schema_version:
          type: integer
          const: 1
          title: Schema Version
        run_id:
          type: string
          pattern: ^codex-manual-[a-z0-9-]{8,100}$
          title: Run Id
        authority:
          $ref: '#/components/schemas/ManualAuthority'
        source_review_sha256:
          type: string
          pattern: ^[a-f0-9]{64}$
          title: Source Review Sha256
        source_review_ref:
          type: string
          maxLength: 1500
          minLength: 10
          title: Source Review Ref
        mailbox:
          type: string
          const: collaborate@aidemos.com
          title: Mailbox
        coverage:
          $ref: '#/components/schemas/ManualCoverage'
        communications:
          items:
            $ref: '#/components/schemas/Communication'
          type: array
          maxItems: 1000
          minItems: 1
          title: Communications
        bindings:
          items:
            $ref: '#/components/schemas/Binding'
          type: array
          maxItems: 100
          title: Bindings
        findings:
          items:
            $ref: '#/components/schemas/Finding'
          type: array
          maxItems: 300
          title: Findings
      additionalProperties: false
      type: object
      required:
      - schema_version
      - run_id
      - authority
      - source_review_sha256
      - source_review_ref
      - mailbox
      - coverage
      - communications
      - bindings
      - findings
      title: ManualReview
      description: Recorded evidence adoption; deliberately no routine cursor or success flag.
    Finding:
      properties:
        id:
          type: string
          pattern: ^[a-f0-9]{64}$
          title: Id
        kind:
          type: string
          enum:
          - outreach
          - response
          - outbound_message
          - meaningful_reply
          - automated_receipt
          - access_request
          - access_acknowledgement
          - access_offer
          - access_invitation
          - access_grant
          - access_declined
          - access_revoked
          - access_limitation
          - access_expiry
          - access_renewal
          - report_delivery
          - report_acknowledgement
          - report_feedback
          - report_ready
          - competitor_analysis
          - competitor_analysis_delivery
          - competitor_analysis_acknowledgement
          - competitor_analysis_feedback
          - commercial_interest
          - commercial_discussion
          - proposal
          - commercial_outcome
          - unanswered_question
          - missed_reply
          - commitment
          - overdue_followup
          - reactivation
          - access_verification
          - communication_quality
          - source_conflict
          - unrelated
          - identity_unresolved
          - call_requested
          - call_proposed
          - call_scheduled
          - call_held
          - call_cancelled
          title: Kind
        company_id:
          anyOf:
          - type: string
            format: uuid
          - type: 'null'
          title: Company Id
        subject_id:
          anyOf:
          - type: string
            format: uuid
          - type: 'null'
          title: Subject Id
        benchmark_version_id:
          anyOf:
          - type: string
            format: uuid
          - type: 'null'
          title: Benchmark Version Id
        round:
          anyOf:
          - type: integer
            minimum: 1.0
          - type: 'null'
          title: Round
        execution_task_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Execution Task Id
        report_task_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Report Task Id
        thread_id:
          type: string
          pattern: ^[a-f0-9]{8,32}$
          title: Thread Id
        evidence_message_ids:
          items:
            type: string
          type: array
          maxItems: 30
          minItems: 1
          title: Evidence Message Ids
        provenance:
          type: string
          enum:
          - original
          - quoted
          - claim
          - unknown
          title: Provenance
        occurred_at:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Occurred At
        occurrence:
          type: string
          enum:
          - supported
          - disputed
          - unknown
          title: Occurrence
        summary:
          type: string
          maxLength: 700
          minLength: 5
          title: Summary
        interpretation:
          type: string
          maxLength: 1500
          minLength: 5
          title: Interpretation
        reason:
          type: string
          maxLength: 1500
          minLength: 10
          title: Reason
        confidence:
          type: string
          enum:
          - high
          - medium
          - low
          title: Confidence
        waiting_on:
          type: string
          enum:
          - Us
          - Company
          - Third party
          - Nobody
          - Unknown
          title: Waiting On
        waiting_since:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Waiting Since
        next_action:
          type: string
          maxLength: 1000
          minLength: 5
          title: Next Action
        owner_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Owner Id
        owner_basis:
          type: string
          enum:
          - existing_clickup_owner
          - proposed
          - unassigned
          title: Owner Basis
        due_at:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Due At
        scheduled_for:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Scheduled For
        priority:
          type: string
          enum:
          - urgent
          - high
          - normal
          - low
          title: Priority
        sentiment:
          type: string
          enum:
          - positive
          - negative
          - mixed
          - unknown
          title: Sentiment
          default: unknown
        missing_evidence:
          items:
            type: string
          type: array
          maxItems: 20
          title: Missing Evidence
        supersedes_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Supersedes Id
      additionalProperties: false
      type: object
      required:
      - id
      - kind
      - company_id
      - thread_id
      - evidence_message_ids
      - provenance
      - occurred_at
      - occurrence
      - summary
      - interpretation
      - reason
      - confidence
      - waiting_on
      - next_action
      - owner_basis
      - priority
      title: Finding
    Coverage:
      properties:
        thread_dispositions:
          additionalProperties:
            type: string
            enum:
            - reviewed
            - unrelated
            - unresolved
          type: object
          title: Thread Dispositions
        history_recovery:
          type: boolean
          title: History Recovery
          default: false
        backfill_complete:
          type: boolean
          title: Backfill Complete
          default: false
        threads:
          anyOf:
          - type: integer
            maximum: 100.0
            minimum: 0.0
          - type: 'null'
          title: Threads
        messages:
          anyOf:
          - type: integer
            maximum: 1000.0
            minimum: 0.0
          - type: 'null'
          title: Messages
        mailbox_messages_total:
          anyOf:
          - type: integer
            minimum: 0.0
          - type: 'null'
          title: Mailbox Messages Total
      additionalProperties: false
      type: object
      required:
      - thread_dispositions
      title: Coverage
    Failure:
      properties:
        run_id:
          type: string
          maxLength: 150
          minLength: 8
          title: Run Id
        session_id:
          type: string
          pattern: ^(session_|cse_)[A-Za-z0-9]+$
          title: Session Id
        stage:
          type: string
          enum:
          - authentication
          - identity
          - retrieval
          - validation
          - persistence
          title: Stage
        code:
          type: string
          enum:
          - authorization_failed
          - wrong_identity
          - source_unavailable
          - contract_refused
          - receipt_unverified
          title: Code
      additionalProperties: false
      type: object
      required:
      - run_id
      - session_id
      - stage
      - code
      title: Failure
    Communication:
      properties:
        message_id:
          type: string
          pattern: ^[a-f0-9]{8,32}$
          title: Message Id
        thread_id:
          type: string
          pattern: ^[a-f0-9]{8,32}$
          title: Thread Id
        content_hash:
          type: string
          pattern: ^[a-f0-9]{64}$
          title: Content Hash
        received_at:
          type: string
          format: date-time
          title: Received At
        header_date:
          anyOf:
          - type: string
            maxLength: 200
          - type: 'null'
          title: Header Date
        direction:
          type: string
          enum:
          - inbound
          - outbound
          - internal
          - unknown
          title: Direction
        sender:
          type: string
          maxLength: 300
          title: Sender
        to:
          type: string
          maxLength: 5000
          title: To
          default: ''
        cc:
          type: string
          maxLength: 5000
          title: Cc
          default: ''
        subject:
          type: string
          maxLength: 500
          title: Subject
        labels:
          items:
            type: string
          type: array
          maxItems: 30
          title: Labels
        attachment_count:
          type: integer
          maximum: 1000.0
          minimum: 0.0
          title: Attachment Count
        rfc_message_id:
          anyOf:
          - type: string
            maxLength: 1000
          - type: 'null'
          title: Rfc Message Id
        attachments:
          items:
            $ref: '#/components/schemas/Attachment'
          type: array
          maxItems: 1000
          title: Attachments
      additionalProperties: false
      type: object
      required:
      - message_id
      - thread_id
      - content_hash
      - received_at
      - direction
      - sender
      - subject
      - attachment_count
      title: Communication
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
x-refined-from:
- aidemos-com-openapi.json
- mcp-openapi.json