---
updatedAt: 2026-06-18T17:50:57.000Z
agentTools:
  siteIndex: https://developer.paylocity.com/llms.txt
  projectIndex: https://developer.paylocity.com/integrations/llms.txt
---

# Get Documents List by Company

**Summary Description**

The GET company documents resource will return a list of documents for a specified company ID.


# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Document Management API",
    "description": "The Document Management API provides tools for managing documents associated with employee records and company records.  This includes the ability to list documents, filter documents by various criteria, and retrieve document download URLs.",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://dc1demogwext.paylocity.com"
    }
  ],
  "paths": {
    "/documents/v1/companies/{companyId}/companyDocuments": {
      "get": {
        "tags": [
          "Documents"
        ],
        "summary": "Get Documents List by Company",
        "description": "**Summary Description**\n\nThe GET company documents resource will return a list of documents for a specified company ID.\n",
        "operationId": "GET_Documents_v1_companies_{companyId}_companyDocuments",
        "parameters": [
          {
            "name": "companyId",
            "in": "path",
            "description": "The Paylocity Company Identifier. This is the unique value provided by Paylocity to each specific Payroll Entity.\r\n                **Allowable Values:**\r\n                9 char max",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Authorization",
            "in": "header",
            "description": "Authorization token. Ex. Bearer ...",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "uploadedDate",
            "in": "query",
            "description": "Allows for an equals comparison to the uploadedDate field. Time portion of the input is ignored.",
            "allowEmptyValue": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "uploadedDate.lessThanOrEqualTo",
            "in": "query",
            "description": "Allows for a Less Than Or Equal (<=) comparison to the uploadedDate field. Time portion of the input is ignored.",
            "allowEmptyValue": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "uploadedDate.greaterThanOrEqualTo",
            "in": "query",
            "description": "Allows for a Greater Than Or Equal (>=) comparison to the uploadedDate field. Time portion of the input is ignored.",
            "allowEmptyValue": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "includeTotalCount",
            "in": "query",
            "description": "Requests that the response include the Pcty-Total-Count header containing the total number of objects that match the request.  This may be useful if requesting a small [limit].",
            "allowEmptyValue": true,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Defines the maximum number of items to be returned in the response.",
            "allowEmptyValue": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "description": "Defines the start location to return.  Ex. offset=100 means starting at item 100, return the next [limit] items.",
            "allowEmptyValue": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/CompanyDocumentModel"
                  }
                }
              },
              "text/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/CompanyDocumentModel"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Error400Model"
                  }
                }
              },
              "text/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Error400Model"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {}
          },
          "500": {
            "description": "Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Error500Model"
                  }
                }
              },
              "text/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Error500Model"
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "CompanyDocumentModel": {
        "type": "object",
        "properties": {
          "documentId": {
            "type": "string",
            "format": "uuid"
          },
          "companyId": {
            "type": "string"
          },
          "displayName": {
            "type": "string"
          },
          "receivedDate": {
            "type": "string",
            "format": "date-time"
          },
          "uploadedDate": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Error400Model": {
        "type": "object",
        "properties": {
          "code": {
            "type": "integer",
            "format": "int32"
          },
          "message": {
            "type": "string"
          },
          "moreInfoUrl": {
            "type": "string"
          },
          "exception": {
            "$ref": "#/components/schemas/ExceptionModel"
          },
          "fields": {
            "type": "string"
          },
          "options": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OptionModel"
            }
          }
        }
      },
      "Error500Model": {
        "type": "object",
        "properties": {
          "code": {
            "type": "integer",
            "format": "int32"
          },
          "message": {
            "type": "string"
          },
          "moreInfoUrl": {
            "type": "string"
          },
          "exception": {
            "$ref": "#/components/schemas/ExceptionModel"
          },
          "errorId": {
            "type": "string"
          }
        }
      },
      "ExceptionModel": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "source": {
            "type": "string"
          },
          "stackTrace": {
            "type": "string"
          },
          "innerException": {
            "$ref": "#/components/schemas/ExceptionModel"
          }
        }
      },
      "OptionModel": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string"
          },
          "description": {
            "type": "string"
          }
        }
      }
    }
  },
  "x-original-swagger-version": "2.0"
}
```