---
title: "Gets a version of a credential."
method: GET
path: "/credentials/v1/credential/version"
tags: ["Credentials"]
---

# Gets a version of a credential.

`GET /credentials/v1/credential/version`

## Query parameters

- `document_id` string
- `version_id` string

## Response `200`

A successful response.

- S12UserdocumentsV1GetDocumentVersionResponse
  - `document_version` S12UserdocumentsV1DocumentVersion — A version is the point-in-time snapshot of a credential. A credential can have multiple versions that are added and edited over time.
    - `subject_org_id` string — The ID of the organization that a credential is stored in.
    - `subject_user_id` string — @deprecated: use subject_user instead
    - `document_type_id` string — @deprecated: use document_type instead
    - `document_id` string — The ID of a credential.
    - `document_version_id` string — The ID of a credential version.
    - `attributes` S12UserdocumentsV1DocumentVersionAttributes — Intrinsic attributes associated with a credential version.
      - `media` S12CommonMedia[] — Media array to be associated with the document.
        - `id` string
        - `token` string
        - `filename` string — full file name, including file extension
        - `media_type` 'MEDIA_TYPE_IMAGE' | 'MEDIA_TYPE_VIDEO' | 'MEDIA_TYPE_PDF' | 'MEDIA_TYPE_DOCX' | 'MEDIA_TYPE_XLSX' | 'MEDIA_TYPE_PPTX' | 'MEDIA_TYPE_CSV' — - MEDIA_TYPE_IMAGE: An image file (GIF, JPG, PNG, WEBP). - MEDIA_TYPE_VIDEO: A video file (MP4, MOV). - MEDIA_TYPE_PDF: A PDF document. - MEDIA_TYPE_DOCX: A Microsoft Word document (DOCX, DOC). - MEDIA_TYPE_XLSX: A Microsoft Excel spreadsheet (XLSX, XLS). - MEDIA_TYPE_PPTX: A Microsoft PowerPoint presentation (PPTX, PPT). - MEDIA_TYPE_CSV: A CSV file.
      - `expiry_period_start_date` GoogleTypeDate — * A full date, with non-zero year, month, and day values * A month and day value, with a zero year, such as an anniversary * A year on its own, with zero month and day values * A year and month value, with a zero day, such as a credit card expiration date Related types are [google.type.TimeOfDay][google.type.TimeOfDay] and `google.protobuf.Timestamp`.
        - `year` integer — Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
        - `month` integer — Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
        - `day` integer — Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
      - `expiry_period_end_date` GoogleTypeDate — * A full date, with non-zero year, month, and day values * A month and day value, with a zero year, such as an anniversary * A year on its own, with zero month and day values * A year and month value, with a zero day, such as a credit card expiration date Related types are [google.type.TimeOfDay][google.type.TimeOfDay] and `google.protobuf.Timestamp`.
        - `year` integer — Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
        - `month` integer — Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
        - `day` integer — Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
    - `metadata` S12UserdocumentsV1DocumentVersionMetadata — Metadata associated with a credential version.
      - `created_at` string, date-time — The creation date of a credential version.
      - `created_by_user` S12UserdocumentsV1User — Information about a SafetyCulture user.
        - `id` string — The ID of the user.
        - `first_name` string — The first name of the user.
        - `last_name` string — The last name of the user.
      - `last_modified` string, date-time — The last modified date of a credential version.
      - `last_modified_by_user` S12UserdocumentsV1User — Information about a SafetyCulture user.
        - `id` string — The ID of the user.
        - `first_name` string — The first name of the user.
        - `last_name` string — The last name of the user.
      - `expiry_status` 'EXPIRY_STATUS_VALID' | 'EXPIRY_STATUS_EXPIRED' | 'EXPIRY_STATUS_EXPIRING_SOON' — @deprecated. Use s12.common.ExpiryStatus instead. The status of a credential based on its expiration period.
      - `total_media_count` integer — The total count of media items associated with this credential version. This count is available regardless of whether the user has permissions to view the media.
      - `is_archived` boolean — Whether the credential has been archived.
      - `archived_at` string, date-time — The time at which the credential was archived. Unset if not archived.
      - `archived_by` string — The ID of the user who archived the credential. Unset if not archived.
    - `subject_user` S12UserdocumentsV1User — Information about a SafetyCulture user.
      - `id` string — The ID of the user.
      - `first_name` string — The first name of the user.
      - `last_name` string — The last name of the user.
    - `document_type` S12UserdocumentsV1DocumentType
      - `id` string — The ID of the document type.
      - `name` string — The name of the type

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/safetyculture/apis/safetyculture-api.md) · [All operations](https://skmtc.net/safetyculture/apis/safetyculture-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/safetyculture/safetyculture-api/revisions/5be91df61ded/schema)