Skip to content

Get documents (resident documents)

Request

Retrieves resident-specific documents including medical records, assessments, care plans, and other resident documentation.

Filters:

  • homeId - Filter by specific care home
  • residentId - Filter by specific resident
  • categoryId - Filter by document category
  • startDate, endDate - Date range filtering
  • dateField - Date field to filter on (default: createdAt)
  • page, limit - Pagination controls (default: page=1, limit=10, max=100)
Security
bearer
Query
startDatestring, (date)

Start date for filtering (inclusive)

Example:startDate=2026-01-01
endDatestring, (date)

End date for filtering (inclusive)

Example:endDate=2026-12-31
pagenumber, >= 1

Page number (1-based)

Default:1
Example:page=1
limitnumber, [ 1 .. 100 ]

Number of records per page

Default:10
Example:limit=10
homeIdstring

Filter by home ID

Example:homeId=home-123-abc
residentIdstring

Filter by resident ID

Example:residentId=63299b624e4c26570fe21e75
categoryIdstring

Filter by document category ID

Example:categoryId=5f155c4ac49007031a671d4f
dateFieldstring

Date field to filter on (only createdAt supported)

Default:"createdAt"
Value:"createdAt"
Example:dateField=createdAt
GET
/api/documents
curl -i -X GET \
  'https://data.logmycare.co.uk/openapi/api/documents?startDate=2026-01-01&endDate=2026-12-31&page=1&limit=10&homeId=home-123-abc&residentId=63299b624e4c26570fe21e75&categoryId=5f155c4ac49007031a671d4f&dateField=createdAt'

Responses

Successfully retrieved records

Bodyapplication/json
dataArray of objectsrequired

Array of documents with enriched data

Example:
[
  {
    "id": "6977686fc18f55207654e609",
    "name": "Medical Assessment - January 2026",
    "createdAt": "2026-01-26T13:13:19.529Z",
    "home": { … },
    "resident": { … },
    "category": { … },
    "pdf": "https://lmc-care-uploads.s3.eu-west-2.amazonaws.com/docs/home/documents/example-home-id/document-file.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=EXAMPLE%2F20260126%2Feu-west-2%2Fs3%2Faws4_request&X-Amz-Date=20260126T131319Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=examplesignature",
    "originalFile": "Medical_Assessment_Jan2026.pdf",
    "attachedToCarePlan": true
  }
]
paginationobject(PaginationMetaDto)required

Pagination metadata

Response
{
  "data": [
    { … }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 150,
    "totalPages": 15,
    "hasNext": true,
    "hasPrev": false
  }
}