--- title: "Search transcriptions" method: POST path: "/v1/cdrs" tags: ["CDRs"] --- # Search transcriptions `POST /v1/cdrs` Searches call transcriptions for the given keywords or phrases and returns the matching CDRs with their transcriptions. ## Request body - CDRSearchRequest - `type` 'placed' | 'received', required — Filters by call type. One of `placed` (outbound calls dialed by the account) or `received` (inbound calls answered by the account). - `from` string, date, required — Start date for call search in `YYYY-MM-DD` format. - `to` string, date, required — End date for call search in `YYYY-MM-DD` format. - `from_search` string — Originating phone number to filter results. Accepts full or partial number. - `to_search` string — Destination phone number to filter results. Accepts full or partial number. - `sip_trunk` string — SIP trunk login to filter outbound calls. Ignored for inbound calls. - `min_duration` integer — Minimum call duration in seconds. - `transcription` TranscriptionFilter - `agent` object, required — Search in an agent's spoken words and phrases - `must` string[] — Only calls with transcription that includes all of the specified keywords and phrases are returned. The listed keywords and phrases are combined using logical AND - `match` string[] — Only calls with transcription that includes any of the specified keywords and phrases are returned. The listed keywords and phrases are combined using logical OR - `exclude` string[] — Only calls with transcription that does not include any of the specified keywords and phrases are returned. The listed keywords and phrases are combined using logical OR - `client` object, required — Search in an customer's spoken words and phrases - `must` string[] — Only calls with transcription that includes all of the specified keywords and phrases are returned. The listed keywords and phrases are combined using logical AND - `match` string[] — Only calls with transcription that includes any of the specified keywords and phrases are returned. The listed keywords and phrases are combined using logical OR - `exclude` string[] — Only calls with transcription that does not include any of the specified keywords and phrases are returned. The listed keywords and phrases are combined using logical OR - `any` object, required — Search in both speakers' spoken words and phrases - `must` string[] — Only calls with transcription that includes all of the specified keywords and phrases are returned. The listed keywords and phrases are combined using logical AND - `match` string[] — Only calls with transcription that includes any of the specified keywords and phrases are returned. The listed keywords and phrases are combined using logical OR - `exclude` string[] — Only calls with transcription that does not include any of the specified keywords and phrases are returned. The listed keywords and phrases are combined using logical OR - `uuid` string — Call ID. - `disposition` 'answered' | 'noanswer' | 'busy' | 'failed' | 'all' — Call disposition to filter results. If omitted, returns only answered calls. Allowed values: `answered`, `busy`, `rejected`, `failed`, `all`. Use `all` to return calls regardless of their disposition. - `page` integer, required — Page number to retrieve. - `per_page` integer, required — Number of records per page. ## Response `200` Returns a paginated list of matching CDRs with their transcriptions. - CDRTranscriptionSearchResponse - `items` CDRWithTranscription[], required — List of CDRs with transcription links. - `answered_by` string, nullable — Who answered the call. Allowed values are `human`, `machine`. - `date` string, date-time, required — Date and time of the call - `from` string, required — ANI/From attribute of the call - `to` string, required — DNIS/To attribute of the call - `disposition` 'answered' | 'noanswer' | 'busy' | 'failed' | 'all', required — Final disposition of the call. One of `answered` (the called party answered), `noanswer` (no answer within the ring timeout), `busy` (the called party was busy), `failed` (the call could not be routed), or `all` (matches any disposition when used as a filter). - `duration` integer, required — Duration of the call, in seconds - `destination` string, required — Destination of the call. For outbound calls, it contains the country name and, optionally, a mobile carrier or city name. For inbound calls, the destination includes the user-defined SIP trunk name, SIP URI, or PSTN number that the call is forwarded to. - `per_minute` string, required — Price per minute, in USD - `charge` string, required — Total charge for the call, in USD - `sip_trunk` string, nullable — System-generated login of a SIP trunk. For `placed` calls only. - `forward_fee` string — PSTN forwarding price, in USD. For `received` calls only when forwarded to PSTN. - `uuid` string, required — Call ID. Deprecated — use `call_id` instead. - `call_id` string, required — Call ID. Alias of `uuid`. - `parent_uuid` string, nullable — Parent call ID. Deprecated — use `parent_call_id` instead. - `parent_call_id` string, nullable — Parent call ID. Alias of `parent_uuid`. - `transcription` TranscriptionReference, nullable, required - `uuid` string, required — Unique identifier of the call transcription. - `url` string, required — URL for retrieving the full call transcription. - `pagination` Pagination, required - `current_page` integer, required — Current page number. - `per_page` integer, required — Number of records per page. - `total` integer, required — Total number of records. - `total_pages` integer, required — Total number of pages. ## Other responses - `403` — Request failed. The feature is disabled for your account. - `422` — Validation error --- [API](https://skmtc.net/wavix/apis/wavix-apis.md) · [All operations](https://skmtc.net/wavix/apis/wavix-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wavix/wavix-apis/versions/b22f170488b6/schema)