Returns a paginated list of the workspace's calls, ordered by start time descending. The `status` filter selects which side of the call lifecycle you get. Omit it, or pass only final statuses, and you get completed calls. Pass only the in-flight statuses (`ringing`, `in_progress`) and you get the calls happening right now. A call in flight carries no economics yet: `duration_ms`, `billable_ms`, `ended_at`, and `cost` are null until it ends, and the completed record then appears under the same `id`. In-flight and completed calls are paged separately, so a request that mixes in-flight and final statuses returns a 422 `validation_error`. Return only calls in this direction. Possible values: `inbound`, `outbound` Return only calls with one of these statuses, comma-separated. The in-flight statuses (`ringing`, `in_progress`) cannot be combined with final ones in the same request. Return only calls belonging to this session, which is how the legs of one multi-party or transferred call are correlated. Return only calls carried by this SIP trunk. Return only calls placed from this calling party number, matched as a whole number rather than as a fragment. Give it in international form: `+14155551234`, `14155551234`, and `0014155551234` all select the same calls, because a call record keeps the number exactly as the calling equipment presented it. A number given without a country code matches only calls recorded in that same form, since it names a different number in every country. Use `number` instead to match part of a number, or either side of the call. Return only calls placed to this called party number, matched as a whole number rather than as a fragment. Give it in international form: `+16505559876`, `16505559876`, and `0016505559876` all select the same calls, because a call record keeps the number exactly as the calling equipment presented it. A number given without a country code matches only calls recorded in that same form, since it names a different number in every country. Use `number` instead to match part of a number, or either side of the call. Return only calls where the calling or called number contains this value. Matches a partial number, so a country or area-code prefix returns every call to or from it. Combines with `from`/`to`, which match one side exactly. Return only calls that started at or after this instant, inclusive. RFC 3339 timestamp. Return only calls that started at or before this instant, inclusive. RFC 3339 timestamp. Maximum number of items to return per page. Cursor from the `next_cursor` field of a previous list response. Returns items immediately after the cursor position in the current sort order. Cursor from the `prev_cursor` field of a previous list response. Returns items immediately before the cursor position in the current sort order. Unique identifier for this call record. Session identifier shared across all legs of a multi-party or transferred call. Use this to correlate related call records. Null when session correlation is not available for the call. Calling party number in E.164 format. Called party number in E.164 format. Identifier of the SIP trunk that originated this call. Null when no trunk is associated. Final SIP response code received from the carrier. Null when no SIP response was received, for example on timeout or DNS failure. Why Bird refused the call before dialing a carrier. Absent when Bird did not refuse it, meaning the call either connected or it failed at the carrier, where `sip_response_code` is the whole story. When the call was initiated. When the call was answered (200 OK received). Null for unanswered calls. When the call ended (BYE or final non-2xx response). Null for calls that ended abnormally without a recorded end event. Total call duration in milliseconds, measured from the first INVITE to the BYE or final response. Null while the call is still in progress and has no final duration yet. Post-dial delay in milliseconds: how long the caller heard nothing between dialing and the phone starting to ring at the other end. High values are what callers experience as the call "not going through". Absent when the call never rang, either because it failed first or because the carrier answered it immediately. Billable duration in milliseconds, measured from answer to call end. Zero for unanswered calls, and null while the call is still in progress. How the audio sounded, as opposed to whether the call connected. Absent when the call carried no audio, or when the far end reported nothing to measure from. Mean opinion score, the single number for how the call sounded, from 1 (unintelligible) to 5 (as good as being in the same room). Anything at or above 4.0 is what most people would call a clear line, and below 3.5 is where callers start asking each other to repeat themselves. The three other fields are the impairments that move it. Variation in the arrival time of the audio packets, in milliseconds. Audio arriving unevenly is heard as choppiness even when no packets are lost at all. Percentage of audio packets that never arrived. Heard as brief gaps or clipped words, and the impairment that degrades a call fastest. Round-trip time between the two ends, in milliseconds. It does not distort the audio, but above roughly 300 ms the two parties start talking over each other. Amount billed for this call, net of tax, at full precision. Absent until the call has been rated; unanswered or unpriced calls have no cost. Decimal amount as a string, in major currency units. ISO 4217 currency code. Cursor for the next page. Pass back as `starting_after` to advance forward. Null when no next page exists. Cursor for the previous page. Pass back as `ending_before` to step backward. Null when no previous page exists. Refresh anchor. Pass back as `ending_before` later to fetch items that have appeared since this response. Non-null whenever `data` is non-empty; null only on an empty page. Distinct from `prev_cursor`.