---
updatedAt: 2025-06-02T22:58:51.000Z
agentTools:
  projectIndex: https://developer.retrotax-aci.com/llms.txt
---

# get

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "version": "2018-11-19T07:39:37Z",
    "title": "Retrotax TCID"
  },
  "paths": {
    "/employees/{employee_id}/documents": {
      "get": {
        "parameters": [
          {
            "name": "X-AUTH-TOKEN",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-AUTH-IV",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "employee_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "200 response",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "type": "string"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "type": "string"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "type": "string"
                }
              },
              "Pragma": {
                "schema": {
                  "type": "string"
                }
              },
              "Expires": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Documents"
                }
              }
            }
          },
          "400": {
            "description": "400 response",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "type": "string"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "type": "string"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "type": "string"
                }
              },
              "Pragma": {
                "schema": {
                  "type": "string"
                }
              },
              "Expires": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "description": "401 response",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "type": "string"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "type": "string"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "type": "string"
                }
              },
              "Pragma": {
                "schema": {
                  "type": "string"
                }
              },
              "Expires": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "403": {
            "description": "403 response",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "type": "string"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "type": "string"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "type": "string"
                }
              },
              "Pragma": {
                "schema": {
                  "type": "string"
                }
              },
              "Expires": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "description": "404 response",
            "headers": {
              "Cache-Control": {
                "schema": {
                  "type": "string"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "type": "string"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "type": "string"
                }
              },
              "Pragma": {
                "schema": {
                  "type": "string"
                }
              },
              "Expires": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        },
        "security": [
          {
            "api_key": []
          }
        ]
      }
    }
  },
  "servers": [
    {
      "url": "https://api.retrotax-aci.com"
    }
  ],
  "components": {
    "securitySchemes": {
      "api_key": {
        "type": "apiKey",
        "name": "x-api-key",
        "in": "header"
      }
    },
    "schemas": {
      "Documents": {
        "title": "Documents",
        "type": "array",
        "items": {
          "type": "object",
          "title": "Document",
          "properties": {
            "code": {
              "type": "string",
              "description": "The document code used by the API. This field is used to identify the type of document and shall be used while uploading the document using the POST method.",
              "default": "FORM A"
            },
            "description": {
              "type": "string",
              "description": "The description of the document which details what is expected for this document.",
              "default": "New Employee Form A"
            },
            "status": {
              "type": "string",
              "description": "The status of the document for this employee. There will be three possible statuses. missing | pending | approved. Status missing indicates that the document is not yet uploaded. Pending indicates that the document has been uploaded by the hiring manager/employee and is under review by the Retrotax Staff. Approved indicates that the document has been uploaded by the hiring manager/employee and approved by the Retrotax Staff",
              "default": "missing"
            },
            "document_url": {
              "type": "string",
              "description": "The link to access the uploaded document. If the status is missing, then this field shall be null.",
              "default": ""
            },
            "thumbnail_urls": {
              "type": "object",
              "title": "thumbnail urls",
              "properties": {
                "small": {
                  "type": "string",
                  "description": "Small thumbnail of the uploaded document.",
                  "default": ""
                },
                "medium": {
                  "type": "string",
                  "description": "Medium thumbnail of the uploaded document.",
                  "default": ""
                }
              }
            },
            "pdf_sample": {
              "type": "string",
              "description": "Link to the PDF Sample of the document.",
              "default": ""
            },
            "image_sample": {
              "type": "string",
              "description": "Link to the Image Sample of the document.",
              "default": ""
            },
            "client_help_text": {
              "type": "string",
              "description": "The help section for the client to make understable about document.",
              "default": ""
            }
          }
        }
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}
```