Get calls involving a given phone number, most recent first, optionally filtered by call tags. For example, this can be used to check whether previous calls from a phone number were tagged in a particular way.

Arguments

after : String

before : String

callTagIds : [ID!]

Only include calls that have all of the given call tags applied.

first : Int

last : Int

phoneNumber : String!


            required

Phone number to find calls for. Matches calls where either the caller's or the recipient's phone number contains this value.

Returns

CallConnectionTypeConnection!

Paginator of Calls

Possible Errors

KT-CT-1113: Disabled GraphQL field requested.
KT-CT-11809: Call tag not found.
KT-CT-4121: Invalid phone number.
KT-CT-7899: An internal error occurred.

Allowed Viewers

Customer

Partner User

Third party

Required Permissions

Can query calls

Query Complexity

Examples

The example data in the variables and responses below are autogenerated values designed to resemble real inputs. They do not represent actual customer data, and in some cases may require additional validation.

Query

query Calls(
  $after: String,
  $before: String,
  $callTagIds: [ID!],
  $first: Int,
  $last: Int,
  $phoneNumber: String!
) {
  calls(
    after: $after,
    before: $before,
    callTagIds: $callTagIds,
    first: $first,
    last: $last,
    phoneNumber: $phoneNumber
  ) {
    edgeCount
    edges {
      ...CallConnectionTypeEdgeFragment
    }
    pageInfo {
      ...PageInfoFragment
    }
    totalCount
  }
}

Variables

{
  "after": "YXJyYXljb25uZWN0aW9uOjEw=",
  "before": "YXJyYXljb25uZWN0aW9uOjEw=",
  "callTagIds": "93488831",
  "first": 10,
  "last": 10,
  "phoneNumber": "base-guess-up-election-edge"
}

Response

{
  "data": {
    "calls": {
      "edgeCount": 50,
      "edges": [CallConnectionTypeEdge],
      "pageInfo": PageInfo,
      "totalCount": 36
    }
  }
}