---
title: "/people/{vanId}/canvassResponses/{referenceId}"
method: GET
path: "/people/{vanId}/canvassResponses/{referenceId}"
---

# /people/{vanId}/canvassResponses/{referenceId}

`GET /people/{vanId}/canvassResponses/{referenceId}`

## Request

- Base URL: `https://api.securevan.com/v4`
- URL: `https://api.securevan.com/v4/people/{vanId}/canvassResponses/{referenceId}`
- Auth: HTTP basic

Use this endpoint to retrieve the canvass response associated with a given `referenceId`. A `referenceId` can only be obtained from a POST request to [/people/{vanId}/canvassResponses](ref:peoplevanidcanvassresponses), with the `includeReferenceIdInResponse` body parameter set to true.  After a successful POST request, it may take up to 30 minutes for the new canvass response record to be created. If you attempt to use this endpoint to retrieve information about a canvass response record within 30 minutes of the initial POST, you may receive a `404: Not Found` error response.

## Path parameters

- `vanId` integer, required
- `referenceId` string, required

## Response `200`

200

- object
  - `vanId` string
  - `canvassResponses` object[]
    - `canvassResponseId` integer
    - `canvassContext` object
      - `contactTypeId` integer
      - `inputTypeId` integer
      - `dateCanvassed` string
      - `phone` object
        - `phoneId` integer
        - `phoneNumber` string
        - `dialingPrefix` string
        - `countryCode` string
        - `ext` unknown
        - `dateCreated` string
        - `phoneType` string
        - `isPreferred` boolean
        - `smsOptInStatus` unknown
        - `phoneOptInStatus` unknown
        - `isCellStatus` object
          - `statusId` integer
          - `statusName` string
      - `campaignId` unknown
      - `contentId` unknown
      - `skipMatching` boolean
      - `teamId` unknown
      - `divisionId` unknown
      - `omitActivistCodeContactHistory` unknown
    - `resultCodeId` integer
    - `responses` unknown[]
      - unknown
    - `note` unknown
    - `emails` unknown
    - `phones` unknown
    - `externalReferenceId` string
    - `selfReportedDemographicFields` unknown

## Other responses

- `400`: 400
- `404`: 404

## Changes

- **2026-11-03** `4f2049fba5af`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ngpvan/apis/van-crm/changes/people/:vanId/canvassResponses/:referenceId/get.md)

---

[API](https://skmtc.dev/ngpvan/apis/van-crm.md) - [All operations](https://skmtc.dev/ngpvan/apis/van-crm/llms.txt) - [OpenAPI document](https://skmtc.dev/ngpvan/apis/van-crm/revisions/4f2049fba5af?raw)