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.
query
Search query, trimmed before use; must contain 1 to 8000 characters after trimming.
n
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.
text
Retrieved passage, including passages without reliable audio timing.
transcript_id
ID of the authorized source document (including non-audio documents).
start_time
Start in seconds, or null when audio alignment is unavailable or ambiguous.
end_time
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