Skip to navigation
API ReferenceMaishiv

Search Knowledge Base Chunks

Retrieve up to n passages from the authenticated user’s Maishiv knowledge base, without generating an answer. Only owned documents are returned. Times are nullable seconds and are provided only for a unique, reliable audio alignment. Each completed search costs $0.01 from the user’s prepaid API balance, regardless of n or the number of matches. Zero-match searches are billable. Invalid requests, missing knowledge bases, and failed searches are not charged. Website subscriptions and daily question allowances do not apply.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
querystringRequired

Search query, trimmed before use; must contain 1 to 8000 characters after trimming.

nintegerOptional

Maximum passages to return; an integer from 1 to 50. Defaults to 10 when omitted or null.

Response

This endpoint returns a list of objects.
textstring
Retrieved passage, including passages without reliable audio timing.
transcript_idstring

ID of the authorized source document (including non-audio documents).

start_timedoubleOptional
Start in seconds, or null when audio alignment is unavailable or ambiguous.
end_timedoubleOptional
End in seconds, or null when audio alignment is unavailable or ambiguous.

Errors

400
Invalid Knowledge Base Search
401
Authentication Error
402
Insufficient Knowledge Base Search Balance
429
Rate Limit Error
502
Knowledge Base Search Provider Error
503
Knowledge Base Search Unavailable
504
Knowledge Base Search Timeout