GET PlanCare2Api/Documents/MyDocuments/Metadata?categoryId={categoryId}

Returns a list of MyDocument documents of the employee in the given category.

Requires 'Start' permission for function Documents {1EF42D55-A0FE-49F0-91C3-CD03DD18D244}

Request Information

URI Parameters

Name Description Type Additional information
categoryId

Document category identifier as provided by MyDocumentCategories

integer

Required

Body Parameters

None.

Response Information

Resource Description

Collection of DocumentMetadata
Name Description Type Additional information
Id

Id of the document. Should be 0 for new instance.

integer

Required

CategoryId

Id of the document category.

integer

Required

OwnerId

The internal id of the person who has done the registration (The Access user id). When the person is not the same as the logged on employee, then the logged on employee must be authorized in Plancare2 to store information on behalf of the given person. The ownerId may not be changed by the user of the API.

integer

Required

Name

The name of the document.

string

Required

FileName

The original full path to the document. Please note that backslashes should be escaped (see RFC7159). Example: The Windows path to C:\Temp\LogFile.Text should be passed as C:\\Temp\\LogFile.Text.

string

Required

FileSize

Binary size of the document.

integer

-

DateCreated

Date / time the document is stored the first time.

date

-

Response Formats

application/json, text/json

Sample:
[
  {
    "$id": "1",
    "Id": 1,
    "CategoryId": 2,
    "OwnerId": 3,
    "Name": "sample string 4",
    "FileName": "sample string 5",
    "FileSize": 6,
    "DateCreated": "2026-05-26T23:19:31.4253963+02:00"
  },
  {
    "$ref": "1"
  }
]

application/xml, text/xml

Sample:
<ArrayOfDocumentMetadata xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/DHS.PlanCare.Web.Api.Interface.Documents">
  <DocumentMetadata>
    <CategoryId>2</CategoryId>
    <DateCreated>2026-05-26T23:19:31.4253963+02:00</DateCreated>
    <FileName>sample string 5</FileName>
    <FileSize>6</FileSize>
    <Id>1</Id>
    <Name>sample string 4</Name>
    <OwnerId>3</OwnerId>
  </DocumentMetadata>
  <DocumentMetadata>
    <CategoryId>2</CategoryId>
    <DateCreated>2026-05-26T23:19:31.4253963+02:00</DateCreated>
    <FileName>sample string 5</FileName>
    <FileSize>6</FileSize>
    <Id>1</Id>
    <Name>sample string 4</Name>
    <OwnerId>3</OwnerId>
  </DocumentMetadata>
</ArrayOfDocumentMetadata>