The 'fieldSalesVisits' field is deprecated.

Please use `appSessions` query instead.

- Marked as deprecated on 2025-08-10.
- Scheduled for removal on or after 2025-10-01.

Arguments

after : String

before : String

first : Int

last : Int

postcode : String!


            required

The postcode of the addresses to return.

Returns

FieldSalesVisitConnectionTypeConnection!

Possible Errors

KT-CT-1113: Disabled GraphQL field requested.
KT-CT-7899: An internal error occurred.
KT-GB-1301: The provided postcode is not a UK postcode.

Allowed Viewers

Customer

Partner User

Third party

Required Permissions

Can query field sales visits

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 FieldSalesVisits(
  $after: String,
  $before: String,
  $first: Int,
  $last: Int,
  $postcode: String!
) {
  fieldSalesVisits(
    after: $after,
    before: $before,
    first: $first,
    last: $last,
    postcode: $postcode
  ) {
    edgeCount
    edges {
      ...FieldSalesVisitConnectionTypeEdgeFragment
    }
    pageInfo {
      ...PageInfoFragment
    }
    totalCount
  }
}

Variables

{
  "after": "YXJyYXljb25uZWN0aW9uOjEw=",
  "before": "YXJyYXljb25uZWN0aW9uOjEw=",
  "first": 10,
  "last": 10,
  "postcode": "position-hour-town-like-various"
}

Response

{
  "data": {
    "fieldSalesVisits": {
      "edgeCount": 71,
      "edges": [FieldSalesVisitConnectionTypeEdge],
      "pageInfo": PageInfo,
      "totalCount": 62
    }
  }
}