> ## Documentation Index
> Fetch the complete documentation index at: https://developers.harvey.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Review Table Metadata

> Fetches metadata for a single review table by its ID, including its title, creation timestamp, and the list of file IDs associated with it.

Use the `review_table_ids` returned by **Get Vault Project Metadata** to enumerate available review tables in a project. Once you have a `review_table_id`, you can:
- Call this endpoint to retrieve the table's `title`, `created_at`, and `file_ids`.
- Call **Get Review Table Row** with a `review_table_id` and `file_id` to retrieve row-level data for a specific file.

### Permissions

Requires `Vault API` permission.


## OpenAPI

````yaml /vault_api.json get /api/v1/vault/review_table/{review_table_id}
openapi: 3.0.1
info:
  title: Vault - Upload Documents
  description: >-
    The Vault Upload Documents API enables users to programmatically upload and
    manage documents within Vault projects. This API allows organizations to
    maintain projects with their own internal files for their users to use
    within the Harvey app.
  version: 1.0.0
  contact:
    email: support@harvey.ai
servers:
  - url: https://api.harvey.ai
    description: Harvey API server
security: []
paths:
  /api/v1/vault/review_table/{review_table_id}:
    get:
      tags:
        - Vault
      summary: Get Review Table Metadata
      description: >-
        Fetches metadata for a single review table by its ID, including its
        title, creation timestamp, and the list of file IDs associated with it.


        Use the `review_table_ids` returned by **Get Vault Project Metadata** to
        enumerate available review tables in a project. Once you have a
        `review_table_id`, you can:

        - Call this endpoint to retrieve the table's `title`, `created_at`, and
        `file_ids`.

        - Call **Get Review Table Row** with a `review_table_id` and `file_id`
        to retrieve row-level data for a specific file.
      operationId: getReviewTable
      parameters:
        - name: review_table_id
          in: path
          required: true
          description: >-
            The integer ID of the review table. Obtain this from the
            `review_table_ids` array in the Get Vault Project Metadata response.
          schema:
            type: integer
      responses:
        '200':
          description: Review table metadata returned successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  response:
                    type: object
                    properties:
                      content:
                        $ref: '#/components/schemas/ReviewTable'
              examples:
                getReviewTable:
                  summary: Example response for getting a review table
                  value:
                    response:
                      content:
                        review_table_id: 2365724
                        title: Lease Review – Q1 2025
                        created_at: '2025-01-10T09:00:00.000000'
                        file_ids:
                          - 0199c5c1-50d9-7d60-93aa-cd65c3b7d5a9
                          - 01936a5f-8289-703a-9962-42bf196ae611
        '401':
          description: Unauthorized – Missing or invalid API token.
        '403':
          description: >-
            Forbidden – User does not have access to the project that contains
            this review table.
        '404':
          description: Review table not found.
      security:
        - bearerAuth: []
components:
  schemas:
    ReviewTable:
      type: object
      properties:
        review_table_id:
          type: integer
          description: The unique integer ID of the review table.
          example: 2365724
        title:
          type: string
          description: The title of the review table.
          example: Lease Review – Q1 2025
        created_at:
          type: string
          format: date-time
          nullable: true
          description: >-
            ISO 8601 timestamp when the review table was created, or null if
            unavailable.
          example: '2025-01-10T09:00:00.000000'
        file_ids:
          type: array
          items:
            type: string
          description: >-
            Array of file IDs associated with this review table. Pass a
            `review_table_id` and one of these `file_id` values to the Get
            Review Table Row endpoint to retrieve row-level data.
          example:
            - 0199c5c1-50d9-7d60-93aa-cd65c3b7d5a9
            - 01936a5f-8289-703a-9962-42bf196ae611
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````