> ## Documentation Index > Fetch the complete documentation index at: https://darwin.so/docs/llms.txt > Use this file to discover all available pages before exploring further. # Get search > Read a search and its ordered response history. Use the owner API key or OAuth grant. For an anonymous search, send the `searchToken` from its first response in `X-Search-Token`. A `searchId` alone does not grant access. Use `cursor` and `limit` to page through responses. ## OpenAPI ````yaml openapi-v3.json GET /v3/search/{searchId} openapi: 3.1.0 info: title: Darwin Search and Act version: 3.0.0 servers: - url: https://api.darwin.so/api security: [] paths: /v3/search/{searchId}: get: summary: Get search operationId: get_search parameters: - name: searchId in: path required: true schema: type: string - name: cursor in: query required: false schema: type: integer minimum: 0 - name: limit in: query required: false schema: type: integer minimum: 1 maximum: 20 responses: '200': description: Ordered, paginated responses in this search content: application/json: schema: $ref: '#/components/schemas/AdaptiveSearchHistoryResponse' security: - apiKey: [] - bearer: [] - searchToken: [] components: schemas: AdaptiveSearchHistoryResponse: type: object properties: searchId: type: string pattern: ^srch_[a-f0-9-]{36}$ responses: maxItems: 64 type: array items: type: object properties: searchId: type: string pattern: ^srch_[a-f0-9-]{36}$ responseId: type: string pattern: ^sresp_[a-f0-9-]{36}$ previousResponseId: anyOf: - type: string pattern: ^sresp_[a-f0-9-]{36}$ - type: 'null' contractVersion: type: string const: search-v3.0 status: type: string enum: - completed - needs_input - no_match response: type: object properties: agents: maxItems: 20 type: array items: type: object properties: agentId: type: string minLength: 1 maxLength: 200 agentSlug: anyOf: - type: string minLength: 1 maxLength: 200 - type: 'null' capabilityId: type: string minLength: 1 maxLength: 200 capabilityRevision: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 rank: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 selected: type: boolean name: type: string minLength: 1 maxLength: 500 description: anyOf: - type: string maxLength: 8000 - type: 'null' imageUrl: anyOf: - type: string format: uri - type: 'null' avatarUrl: anyOf: - type: string format: uri - type: 'null' requiredSetup: default: null anyOf: - type: object properties: kind: type: string enum: - credential - installation - provider_configuration suppliedBy: type: string enum: - user - provider - runtime description: type: string minLength: 1 maxLength: 500 required: - kind - suppliedBy - description additionalProperties: false - type: 'null' executionRequirements: default: null anyOf: - type: object properties: contractVersion: type: string const: 1.0.0 providerAuthentication: type: object properties: state: type: string enum: - REQUIRED - NOT_REQUIRED - UNKNOWN - NOT_APPLICABLE mechanisms: maxItems: 20 type: array items: type: string enum: - BEARER - API_KEY - OAUTH2 - HTTP_BASIC - MUTUAL_TLS - SIGNED_REQUEST - SESSION_COOKIE - OPERATION_SECRET_INPUT - UNSPECIFIED placements: maxItems: 20 type: array items: type: string enum: - HEADER - QUERY - COOKIE - BODY - TOOL_ARGUMENT - ENVIRONMENT - AUTH_CONTINUATION scopes: maxItems: 100 type: array items: type: string minLength: 1 maxLength: 200 evidence: type: string enum: - PROVIDER_DECLARED - PROVIDER_OBSERVED - DERIVED_FROM_VERIFIED_RECEIPT - UNKNOWN required: - state - mechanisms - placements - scopes - evidence additionalProperties: false operationCredentials: type: object properties: state: type: string enum: - REQUIRED - NOT_REQUIRED - UNKNOWN - NOT_APPLICABLE sensitiveInputNames: maxItems: 100 type: array items: type: string minLength: 1 maxLength: 200 required: - state - sensitiveInputNames additionalProperties: false runtime: type: object properties: kind: type: string enum: - REMOTE_MCP - LOCAL_STDIO - A2A_JSONRPC - HTTP_JSON - OPENAPI_HTTP - BOUNDED_FETCH - BROWSER - X402_PAYMENT - COMMERCE - UNSUPPORTED package: anyOf: - type: object properties: ecosystem: type: string minLength: 1 maxLength: 40 identifier: type: string minLength: 1 maxLength: 500 version: type: string minLength: 1 maxLength: 200 runtimeProfile: type: string minLength: 1 maxLength: 120 required: - ecosystem - identifier - version - runtimeProfile additionalProperties: false - type: 'null' requiredEnvironmentNames: maxItems: 100 type: array items: type: string minLength: 1 maxLength: 200 required: - kind - package - requiredEnvironmentNames additionalProperties: false payment: type: object properties: state: type: string enum: - REQUIRED - NOT_REQUIRED - UNKNOWN - NOT_APPLICABLE termsDigest: anyOf: - type: string maxLength: 200 - type: 'null' required: - state - termsDigest additionalProperties: false browser: type: object properties: state: type: string enum: - REQUIRED - NOT_REQUIRED - UNKNOWN - NOT_APPLICABLE sessionKind: anyOf: - type: string enum: - ANONYMOUS - PROVIDER_SESSION - UNKNOWN - type: 'null' required: - state - sessionKind additionalProperties: false providerContract: type: object properties: route: type: string enum: - RESOLVED - MISSING - AMBIGUOUS - UNSAFE - UNSUPPORTED - UNKNOWN inputSchema: type: string enum: - CONCRETE - DIGEST_ONLY - MISSING - UNKNOWN outputSchema: type: string enum: - CONCRETE - DIGEST_ONLY - MISSING - UNKNOWN required: - route - inputSchema - outputSchema additionalProperties: false providerBlockers: maxItems: 20 type: array items: type: object properties: code: type: string enum: - PROVIDER_ROUTE_UNSUPPORTED - PROVIDER_SCHEMA_MISSING - PROVIDER_AUTH_SCHEME_UNSPECIFIED - PROVIDER_METADATA_INCOMPLETE - DARWIN_ADAPTER_UNAVAILABLE - DARWIN_ROUTE_NOT_APPROVED - DARWIN_LOCAL_RUNTIME_UNAVAILABLE - DARWIN_BROWSER_RUNTIME_UNAVAILABLE - DARWIN_PAYMENT_RUNTIME_UNAVAILABLE owner: type: string enum: - PROVIDER - DARWIN required: - code - owner additionalProperties: false derivation: type: object properties: normalizerVersion: type: string const: execution-requirements-v1 sourceRevision: type: string minLength: 1 maxLength: 240 sourceReceiptDigest: anyOf: - type: string maxLength: 200 - type: 'null' completeness: type: string enum: - COMPLETE - PARTIAL derivationKey: type: string pattern: ^sha256:[a-f0-9]{64}$ required: - normalizerVersion - sourceRevision - sourceReceiptDigest - completeness - derivationKey additionalProperties: false required: - contractVersion - providerAuthentication - operationCredentials - runtime - payment - browser - providerContract - providerBlockers - derivation additionalProperties: false - type: 'null' executionGuidance: default: null anyOf: - type: object properties: credentialSummaryCode: type: string minLength: 1 maxLength: 200 credentialSummary: type: string minLength: 1 maxLength: 1000 setupSummaryCode: type: string minLength: 1 maxLength: 200 setupSummary: type: string minLength: 1 maxLength: 1000 recordBlockers: maxItems: 20 type: array items: type: object properties: code: type: string enum: - PROVIDER_ROUTE_UNSUPPORTED - PROVIDER_SCHEMA_MISSING - PROVIDER_AUTH_SCHEME_UNSPECIFIED - PROVIDER_METADATA_INCOMPLETE - DARWIN_ADAPTER_UNAVAILABLE - DARWIN_ROUTE_NOT_APPROVED - DARWIN_LOCAL_RUNTIME_UNAVAILABLE - DARWIN_BROWSER_RUNTIME_UNAVAILABLE - DARWIN_PAYMENT_RUNTIME_UNAVAILABLE owner: type: string enum: - PROVIDER - DARWIN required: - code - owner additionalProperties: false primaryBlockerCode: anyOf: - type: string enum: - PROVIDER_ROUTE_UNSUPPORTED - PROVIDER_SCHEMA_MISSING - PROVIDER_AUTH_SCHEME_UNSPECIFIED - PROVIDER_METADATA_INCOMPLETE - DARWIN_ADAPTER_UNAVAILABLE - DARWIN_ROUTE_NOT_APPROVED - DARWIN_LOCAL_RUNTIME_UNAVAILABLE - DARWIN_BROWSER_RUNTIME_UNAVAILABLE - DARWIN_PAYMENT_RUNTIME_UNAVAILABLE - type: 'null' rendererVersion: type: string const: execution-guidance-v1 required: - credentialSummaryCode - credentialSummary - setupSummaryCode - setupSummary - recordBlockers - primaryBlockerCode - rendererVersion additionalProperties: false - type: 'null' readiness: type: string enum: - ready - authentication_required - recheck_required - unavailable canStartThread: type: boolean reasons: maxItems: 3 type: array items: type: string maxLength: 250 uncertainties: maxItems: 3 type: array items: type: string maxLength: 250 inquiry: type: object properties: status: type: string enum: - contacting - waiting - following_up - replied - needs_input - no_reply - not_contacted - outcome_unknown fit: type: string enum: - matches - partial - not_fit - unknown expiresAt: type: string 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))$ threadId: type: string minLength: 1 maxLength: 200 question: type: string minLength: 1 maxLength: 2000 replies: maxItems: 4 type: array items: type: object properties: messageId: type: string minLength: 1 maxLength: 200 text: type: string minLength: 1 maxLength: 8000 at: type: string 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: - messageId - text - at additionalProperties: false description: type: string maxLength: 1200 reason: type: string maxLength: 250 required: - status - question - replies additionalProperties: false providerCheck: type: string enum: - not_attempted - confirmed - unconfirmed - unavailable connectionMethods: default: [] maxItems: 3 type: array items: type: object properties: protocol: type: string enum: - MCP - A2A - WEBMCP environment: type: string enum: - remote_client - browser_session endpointUrl: anyOf: - type: string format: uri - type: 'null' endpointStatus: type: string enum: - not_published - verified documentationUrl: type: string format: uri required: - protocol - environment - endpointUrl - endpointStatus - documentationUrl additionalProperties: false connectionPrompt: type: string minLength: 1 maxLength: 60000 required: - agentId - agentSlug - capabilityId - capabilityRevision - rank - selected - name - description - requiredSetup - executionRequirements - executionGuidance - readiness - canStartThread - reasons - uncertainties - providerCheck - connectionMethods - connectionPrompt additionalProperties: false assessment: type: object properties: outcome: type: string enum: - strong - partial - clarify - no_match - unverified explanation: type: string minLength: 1 maxLength: 2000 required: - outcome - explanation additionalProperties: false relatedSearches: default: [] maxItems: 3 type: array items: type: object properties: query: type: string minLength: 1 maxLength: 200 reason: type: string minLength: 1 maxLength: 250 required: - query - reason additionalProperties: false plan: anyOf: - type: object properties: steps: minItems: 1 maxItems: 8 type: array items: type: object properties: stepId: type: string minLength: 1 maxLength: 200 agentId: type: string minLength: 1 maxLength: 200 capabilityId: type: string minLength: 1 maxLength: 200 objective: type: string minLength: 1 maxLength: 250 dependsOn: maxItems: 8 type: array items: type: string minLength: 1 maxLength: 200 alternatives: maxItems: 3 type: array items: type: object properties: agentId: type: string minLength: 1 maxLength: 200 capabilityId: type: string minLength: 1 maxLength: 200 required: - agentId - capabilityId additionalProperties: false required: - stepId - agentId - capabilityId - objective - dependsOn additionalProperties: false required: - steps additionalProperties: false - type: 'null' question: anyOf: - type: string minLength: 1 maxLength: 500 - type: 'null' noMatchReason: anyOf: - type: string minLength: 1 maxLength: 500 - type: 'null' overview: anyOf: - type: string maxLength: 32000 - type: 'null' required: - agents - relatedSearches - plan - question - noMatchReason additionalProperties: false searchToken: type: string required: - searchId - responseId - previousResponseId - contractVersion - status - response additionalProperties: false nextCursor: anyOf: - type: string - type: 'null' required: - searchId - responses - nextCursor additionalProperties: false securitySchemes: apiKey: type: apiKey in: header name: x-api-key bearer: type: http scheme: bearer searchToken: type: apiKey in: header name: X-Search-Token ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.