---
title: "Get completed site audits"
method: GET
path: "/subscribers/current/siteaudit/audits/completed"
tags: ["SiteAudit"]
---

# Get completed site audits

`GET /subscribers/current/siteaudit/audits/completed`

## Request

- Base URL: `https://sb2api.servicechannel.com/v3`
- URL: `https://sb2api.servicechannel.com/v3/subscribers/current/siteaudit/audits/completed`
- Auth: OAuth 2
  - Authorization code: `https://sb2login.servicechannel.com/oauth/authorize`
  - Token URL: `https://sb2login.servicechannel.com/oauth/token`
- TypeScript: <https://skmtc.dev/servicechannel/apis/servicechannel-api-v-3/docs/subscribers/current/siteaudit/audits/completed/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves a list of completed site audits and their details for the current subscriber.

## Query parameters

- `daysPeriod` integer

## Response `200`

The list of completed audits is in the response.

- ServiceChannelServicesMessagingSiteAuditCompletedAuditListResponse: Object containing general info on completed audits.
  - `UserName` string: Username of the person who has authorized and is sending the API request.
  - `Locations` ServiceChannelServicesMessagingSiteAuditLocationExternal[]
    - `Id` integer: Unique numeric identifier of the location — generated by the system.
    - `SubscriberId` integer: Unique numeric identifier of the subscriber.
    - `StoreId` string: Unique numeric identifier of the location — specified by the user.
    - `Name` string: Location name.
    - `ShortName` string: Short name of the location.
    - `Address` string: Location address.
    - `City` string: Location city.
    - `State` string: Location state.
    - `Country` string: Location country.
    - `Zip` string: Location ZIP code.
  - `TemplateTypes` ServiceChannelServicesMessagingSiteAuditAuditTypeExternal[]
    - `Id` integer: Unique numeric identifier of the template. The template determines the audit type.
    - `SubscriberId` integer: Unique numeric identifier of the subscriber.
    - `Name` string: Template name.
  - `CompletedAudits` ServiceChannelServicesMessagingSiteAuditCompletedAuditInfoExternal[]
    - `Id` integer: Unique numeric identifier of the completed audit.
    - `LocationId` integer: Unique numeric identifier of the location — generated by the system.
    - `StartDate` string, date-time: Date and time when the site audit was started. The format is YYYY-MM-DDThh:mm:ss.sss.
    - `EndDate` string, date-time: Date and time when the site audit was completed. The format is YYYY-MM-DDThh:mm:ss.sss.
    - `TemplateTypeId` integer: Unique numeric identifier of the template that was used to complete the site audit. The template determines the audit type.
    - `UserName` string: Username of the person who conducted the audit.

## Other responses

- `401`: The request is not authorized. <br/>Error codes: 504 &mdash; Missing or incorrect authentication credentials
- `500`: The server was unable to complete the request due to an internal error. <br/>Error codes: 501 &mdash; Unspecified internal server error occurred

---

[API](https://skmtc.dev/servicechannel/apis/servicechannel-api-v-3.md) - [All operations](https://skmtc.dev/servicechannel/apis/servicechannel-api-v-3/llms.txt) - [OpenAPI document](https://skmtc.dev/servicechannel/apis/servicechannel-api-v-3/revisions/d490d6596809?raw)