---
title: "GET /contracts/{id}"
method: GET
path: "/contracts/{id}"
tags: ["Contract Vault"]
---

# GET /contracts/{id}

`GET /contracts/{id}`

## Request

- Base URL: `https://api.cxxx.eagleeyenetworks.com/api/v3.0`
- URL: `https://api.cxxx.eagleeyenetworks.com/api/v3.0/contracts/{id}`
- Auth: HTTP bearer

Retrieves a contract record by its ID.

## Path parameters

- `id` string, required

## Response `200`

Successful retrieval of the contract record.

- ContractRecord: Represents a contract vault record.
  - `id` string, required: Unique identifier for the recording.
  - `customers` object[], required: List of customer names associated with the recording. A primary and secondary customer may be present.
    - `firstName` string, required: First name of the customer.
    - `lastName` string, required: Last name of the customer.
    - `primary` boolean, required: Indicates if this customer is the primary contact.
  - `agent` object, required: Information about the agent associated with the recording.
    - `firstName` string: First name of the agent.
    - `lastName` string: Last name of the agent.
    - `email` string, email: Email address of the agent.
  - `manager` object: Information about the manager associated with the recording.
    - `firstName` string: First name of the manager.
    - `lastName` string: Last name of the manager.
  - `extStockNumber` string: Stock number associated with the recording.
  - `extContractNumber` string: Contract number associated with the recording.
  - `extServiceEntity` string: The service entity associated with the recording.
  - `videoAvailable` boolean, required: Indicates if the video is available.
  - `noVideoReason` 'equipmentOrCommunicationFailure' | 'ownerRefusedConsent' | 'noRoomAvailable' | 'noQaAvailable' | 'noVloAvailable' | 'recording' | 'medical' | 'unspecified' | 'other': Reason for not having a video.
  - `video` object: Video metadata including URL and other details.
    - `durationSec` string, required: Length of the video recording.
    - `startTimestamp` string, date-time, required: Start time of the video recording in ISO 8601 format.
    - `endTimestamp` string, date-time, required: End time of the video recording in ISO 8601 format.
  - `cameraIds` string[]: Unique identifiers for the cameras used in the recording.
  - `layoutId` string: Unique identifier for the layout used in the recording.
  - `updateTimestamp` string, date-time: Date and time when the record was last updated.

## Other responses

- `401` (unresolved $ref)
- `403` (unresolved $ref)
- `404`: Referenced resource could not be found.
- `500` (unresolved $ref)

---

[API](https://skmtc.dev/eagleeyenetworks/apis/contract-vault-api.md) - [All operations](https://skmtc.dev/eagleeyenetworks/apis/contract-vault-api/llms.txt) - [OpenAPI document](https://skmtc.dev/eagleeyenetworks/apis/contract-vault-api/revisions/25c6c110d2b9?raw)