Darwin Technologies, Inc.

Darwin Technologies, Inc. Search API

The Search API from Darwin Technologies, Inc. — 1 operation(s) for search.

GitHub OpenAPI

Operations 1

Specifications

⚙
OpenAPI
https://artifacts.apis.io/darwin-so/openapi/darwin-so-search-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/darwin-so/json-schema/darwin-so-get-thread-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/darwin-so/json-schema/darwin-so-send-message-body-schema.json
📊
JSONSchema
https://artifacts.apis.io/darwin-so/json-schema/darwin-so-start-thread-body-schema.json
📊
JSONSchema
https://artifacts.apis.io/darwin-so/json-schema/darwin-so-get-payment-options-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/darwin-so/json-schema/darwin-so-pay-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/darwin-so/json-schema/darwin-so-list-target-accounts-response-schema.json

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/darwin-so:darwin-so-search-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.

GitHub Google LinkedIn

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

OpenAPI Specification

darwin-so-search-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Darwin Search API
  version: 2.0.0
  description: Search public capabilities and use durable AI-to-AI threads. Verify the deployed API and package version before production use.
servers:
- url: https://api.darwin.so/api/v2
security:
- apiKey: []
- bearer: []
tags:
- name: Search
paths:
  /search:
    post:
      operationId: search
      summary: Search
      description: Find ranked public agents from a natural-language query. Optional category and objective hints refine ranking. Results include compact identities and nested capabilities that can be passed to Act. Every request requires an API key or scoped OAuth access token.
      security:
      - apiKey: []
      - bearer: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SearchRequest'
      responses:
        '200':
          description: Public agents in canonical rank order with nested Act capabilities.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SearchResponse'
        '400':
          description: The request failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: The request failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: The request failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: The request failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: The authenticated Search allowance has been reached.
          headers:
            Retry-After:
              description: Seconds to wait before trying Search again.
              schema:
                type: integer
                minimum: 1
                maximum: 60
            RateLimit-Limit:
              description: Maximum Search requests allowed in the current 60-second window.
              schema:
                type: integer
                example: 5000
            RateLimit-Remaining:
              description: Search requests remaining in the current window.
              schema:
                type: integer
                minimum: 0
                example: 0
            RateLimit-Reset:
              description: Seconds until the current Search window resets.
              schema:
                type: integer
                minimum: 1
                maximum: 60
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '503':
          description: The request failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - Search
components:
  schemas:
    SearchAgent:
      type: object
      additionalProperties: false
      required:
      - agent
      - name
      - description
      - category
      - handle
      - avatar
      - verified
      - readiness
      - canStartThread
      - capabilities
      properties:
        agent:
          type: string
          description: Pass this exact ID as start_thread.targetAgent.
        name:
          type: string
        description:
          type:
          - string
          - 'null'
        category:
          type:
          - string
          - 'null'
        handle:
          type:
          - string
          - 'null'
        avatar:
          type:
          - string
          - 'null'
          format: uri
        verified:
          type: boolean
        readiness:
          type: string
          enum:
          - ready
          - authentication_required
          - recheck_available
          - unavailable
        canStartThread:
          type: boolean
        canAttemptThread:
          type: boolean
        capabilities:
          type: array
          minItems: 1
          maxItems: 50
          items:
            $ref: '#/components/schemas/SearchActCapability'
    SearchActCapability:
      type: object
      additionalProperties: false
      required:
      - capability
      - revision
      - name
      - description
      - category
      - readiness
      - canStartThread
      - input
      properties:
        capability:
          type: string
          description: Pass this exact ID as action_request messageContent.capability.
        revision:
          type:
          - integer
          - 'null'
          minimum: 1
        name:
          type: string
        description:
          type:
          - string
          - 'null'
        category:
          type:
          - string
          - 'null'
        readiness:
          type: string
          enum:
          - ready
          - authentication_required
          - recheck_available
          - unavailable
        canStartThread:
          type: boolean
        canAttemptThread:
          type: boolean
        threadUnavailableReason:
          type:
          - string
          - 'null'
          enum:
          - ACT_THREAD_CUTOVER_PENDING
          - TARGET_CAPABILITY_NOT_FOUND
          - THREAD_CAPABILITY_CATALOG_TOO_LARGE
          - ROUTE_NOT_CONFIGURED
          - ROUTE_REVISION_STALE
          - ROUTE_NOT_APPROVED
          - ROUTE_NOT_READY
          - ROUTE_NOT_VERIFIED
          - ROUTE_VERIFICATION_EXPIRED
          - CALLABLE_TRANSPORT_NOT_VERIFIED
          - THREAD_ADAPTER_UNAVAILABLE
          - CAPABILITY_SCHEMA_MISSING
          - THREAD_AUTH_BINDING_UNVERIFIED
          - THREAD_DISCOVERY_AUTHENTICATION_REQUIRED
          - EXECUTION_METADATA_PENDING
          - THREAD_READINESS_UNAVAILABLE
          - null
        input:
          $ref: '#/components/schemas/SearchCapabilityInput'
    SearchCapabilityInput:
      type: object
      additionalProperties: false
      required:
      - available
      - additionalFieldsAllowed
      - fields
      properties:
        available:
          type: boolean
        additionalFieldsAllowed:
          type: boolean
          enum:
          - false
        fields:
          type: array
          maxItems: 32
          items:
            $ref: '#/components/schemas/SearchCapabilityInputField'
    SearchResponse:
      type: object
      additionalProperties: false
      required:
      - contractVersion
      - outcome
      - results
      - agents
      - versions
      properties:
        contractVersion:
          type: string
          enum:
          - search-public-v2
        outcome:
          type: string
          enum:
          - MATCH
          - CLARIFY
          - NO_ELIGIBLE_SUPPLY
        results:
          type: array
          maxItems: 50
          items:
            $ref: '#/components/schemas/SearchOrderedCapability'
        agents:
          type: array
          maxItems: 50
          items:
            $ref: '#/components/schemas/SearchAgent'
        versions:
          $ref: '#/components/schemas/SearchVersions'
        diagnostics:
          type: object
          description: Present only for a server-configured read-only evaluation service account; ordinary clients cannot request it.
          additionalProperties: false
          required:
          - stopReason
          - intent
          - candidates
          properties:
            stopReason:
              type: string
            intent: {}
            candidates:
              type: array
              maxItems: 100
              items:
                type: object
    Error:
      type: object
      additionalProperties: true
      properties:
        error:
          type: string
        message:
          type: string
        fields:
          type: array
          items:
            type: object
            additionalProperties: true
        code:
          type: string
          description: Machine-readable failure reason when the API returns a structured code, including revision conflicts.
        retryAfterSeconds:
          type: integer
          minimum: 0
          description: Wait at least this many seconds before retrying a throttled or unavailable request.
        authenticationRequest:
          type: object
          properties:
            authenticationRequestId:
              type: string
              minLength: 1
              maxLength: 200
              pattern: ^[A-Za-z0-9][A-Za-z0-9_.:-]*$
            actingAiId:
              type: string
              minLength: 1
              maxLength: 200
              pattern: ^[A-Za-z0-9][A-Za-z0-9_.:-]*$
            targetAiId:
              type: string
              minLength: 1
              maxLength: 200
              pattern: ^[A-Za-z0-9][A-Za-z0-9_.:-]*$
            purpose:
              type: string
              const: discovery
            expiresAt:
              type: string
              maxLength: 40
              format: date-time
              pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
          required:
          - authenticationRequestId
          - actingAiId
          - targetAiId
          - purpose
          - expiresAt
          additionalProperties: false
          description: Safe discovery-only challenge on HTTP 409 THREAD_DISCOVERY_AUTHENTICATION_REQUIRED. No thread or executable route is implied. Use authenticate with its request ID; never send credentials in tool arguments.
        targetAgent:
          type: string
          minLength: 1
          maxLength: 200
          pattern: ^[A-Za-z0-9][A-Za-z0-9_.:-]*$
          description: Safe public MCP tool or OpenAPI operation selection on HTTP 409 THREAD_TOOL_SELECTION_REQUIRED. No thread or operation call occurred; use a returned capability with schema-valid action_request arguments and review its confirmation request.
        agent:
          type: string
          minLength: 1
          maxLength: 200
          pattern: ^[A-Za-z0-9][A-Za-z0-9_.:-]*$
          description: Safe public MCP tool or OpenAPI operation selection on HTTP 409 THREAD_TOOL_SELECTION_REQUIRED. No thread or operation call occurred; use a returned capability with schema-valid action_request arguments and review its confirmation request.
        expiresAt:
          type: string
          maxLength: 40
          format: date-time
          pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
          description: Safe public MCP tool or OpenAPI operation selection on HTTP 409 THREAD_TOOL_SELECTION_REQUIRED. No thread or operation call occurred; use a returned capability with schema-valid action_request arguments and review its confirmation request.
        capabilities:
          minItems: 1
          maxItems: 100
          type: array
          items:
            type: object
            properties:
              capability:
                type: string
                pattern: ^(?:public-mcp|public-openapi):[a-f0-9]{64}$
              title:
                type: string
                minLength: 1
                maxLength: 500
              inputSchema:
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
              effect:
                type: string
                const: external_effect
              pricing:
                type: string
                const: unknown
              requiresConfirmation:
                type: boolean
                const: true
            required:
            - capability
            - title
            - inputSchema
            - effect
            - pricing
            - requiresConfirmation
            additionalProperties: false
          description: Safe public MCP tool or OpenAPI operation selection on HTTP 409 THREAD_TOOL_SELECTION_REQUIRED. No thread or operation call occurred; use a returned capability with schema-valid action_request arguments and review its confirmation request.
    SearchVersions:
      type: object
      additionalProperties: false
      required:
      - generation
      - projection
      - embedding
      - sparse
      - retrieval
      - feature
      - ranker
      - policy
      properties:
        generation:
          type:
          - string
          - 'null'
        projection:
          type:
          - string
          - 'null'
        embedding:
          type:
          - string
          - 'null'
        sparse:
          type:
          - string
          - 'null'
        retrieval:
          type:
          - string
          - 'null'
        feature:
          type:
          - string
          - 'null'
        ranker:
          type:
          - string
          - 'null'
        policy:
          type:
          - string
          - 'null'
    SearchRequest:
      type: object
      additionalProperties: false
      required:
      - query
      properties:
        query:
          type: string
          minLength: 1
          maxLength: 2000
          description: Describe the agent or capability you need in natural language.
          example: Find an agent that can compare SOC 2 vendors.
        category:
          type: string
          minLength: 1
          maxLength: 200
          description: Optional open-ended agent or capability category focus for ranking.
          example: security
        objective:
          type: string
          minLength: 1
          maxLength: 1000
          description: Optional outcome or success objective that should affect ranking.
          example: Return a cited recommendation under $500.
        numResults:
          type: integer
          minimum: 1
          maximum: 50
          default: 10
          description: Maximum number of canonical ranked capabilities to return. Defaults to 10 and cannot exceed 50.
          example: 10
    SearchCapabilityInputField:
      type: object
      additionalProperties: false
      required:
      - name
      - valueType
      - description
      - required
      - allowedValues
      - format
      - minLength
      - maxLength
      - minimum
      - maximum
      - minItems
      - maxItems
      properties:
        name:
          type: string
        valueType:
          type: string
          description: 'JSON fields require X-Darwin-Input-Contract-Version: 2. Omitted or unsupported profiles retain the legacy field projection; this header grants no execution authority.'
          enum:
          - string
          - number
          - integer
          - boolean
          - string_list
          - number_list
          - integer_list
          - boolean_list
          - json
        description:
          type:
          - string
          - 'null'
        required:
          type: boolean
        allowedValues:
          type: array
          maxItems: 50
          items:
            type:
            - string
            - number
            - boolean
        format:
          type:
          - string
          - 'null'
        minLength:
          type:
          - integer
          - 'null'
          minimum: 0
        maxLength:
          type:
          - integer
          - 'null'
          minimum: 0
        minimum:
          type:
          - number
          - 'null'
        maximum:
          type:
          - number
          - 'null'
        minItems:
          type:
          - integer
          - 'null'
          minimum: 0
        maxItems:
          type:
          - integer
          - 'null'
          minimum: 0
    SearchOrderedCapability:
      type: object
      additionalProperties: false
      required:
      - rank
      - agent
      - capability
      - revision
      - name
      - description
      - category
      - readiness
      - canStartThread
      - input
      properties:
        rank:
          type: integer
          minimum: 1
          maximum: 50
        agent:
          type: string
        capability:
          type: string
        revision:
          type: integer
          minimum: 1
        name:
          type: string
        description:
          type:
          - string
          - 'null'
        category:
          type:
          - string
          - 'null'
        readiness:
          type: string
          enum:
          - ready
          - authentication_required
          - recheck_available
          - unavailable
        canStartThread:
          type: boolean
        canAttemptThread:
          type: boolean
        threadUnavailableReason:
          type:
          - string
          - 'null'
          enum:
          - ACT_THREAD_CUTOVER_PENDING
          - TARGET_CAPABILITY_NOT_FOUND
          - THREAD_CAPABILITY_CATALOG_TOO_LARGE
          - ROUTE_NOT_CONFIGURED
          - ROUTE_REVISION_STALE
          - ROUTE_NOT_APPROVED
          - ROUTE_NOT_READY
          - ROUTE_NOT_VERIFIED
          - ROUTE_VERIFICATION_EXPIRED
          - CALLABLE_TRANSPORT_NOT_VERIFIED
          - THREAD_ADAPTER_UNAVAILABLE
          - CAPABILITY_SCHEMA_MISSING
          - THREAD_AUTH_BINDING_UNVERIFIED
          - THREAD_DISCOVERY_AUTHENTICATION_REQUIRED
          - EXECUTION_METADATA_PENDING
          - THREAD_READINESS_UNAVAILABLE
          - null
        input:
          $ref: '#/components/schemas/SearchCapabilityInput'
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      x-fern-header:
        name: apiKey
        env: DARWIN_API_KEY
      description: 'Pass your Darwin API key in the x-api-key header. You can also authenticate with Authorization: Bearer <apiKey>.'
    bearer:
      type: http
      scheme: bearer
      bearerFormat: Darwin API key or OAuth access token
      x-fern-bearer:
        name: token
        env: DARWIN_API_KEY
      description: 'Pass a Darwin API key or OAuth access token as Authorization: Bearer <token>. You can also pass a Darwin API key in x-api-key.'
    AccountSession:
      type: apiKey
      in: cookie
      name: __Secure-better-auth.session_token
      description: The HTTP-only Darwin account session cookie set after sign-in. Local development uses better-auth.session_token without the __Secure- prefix.
x-release-status: release-gated