Care Management

Here are examples for working with care management collections through the REST API.

My CareList

Creating Care Lists

const createCareList = async (token, ownerId) => {
  const response = await fetch('https://api.picoshealth.com/v1/my-care-list', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${token}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      title: 'Mom\'s Weekly Care',
      owner: ownerId,
      items: [
        {
          product: 'prod-uuid-1',
          quantity: 12,
        },
      ],
    }),
  });
  return response.json();
};

Getting Care Lists

const getUserCareLists = async (token, userId) => {
  const response = await fetch(
    `https://api.picoshealth.com/v1/my-care-list?where={"owner":{"equals":"${userId}"}}`,
    {
      headers: { 'Authorization': `Bearer ${token}` },
    }
  );
  return response.json();
};

Updating Care List Items

const updateCareListItems = async (token, careListId, newItems) => {
  const response = await fetch(
    `https://api.picoshealth.com/v1/my-care-list/${careListId}`,
    {
      method: 'PATCH',
      headers: {
        'Authorization': `Bearer ${token}`,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({
        items: newItems,
      }),
    }
  );
  return response.json();
};

Patients

Creating Patient Records

const createPatientRecord = async (token, userId) => {
  const response = await fetch('https://api.picoshealth.com/v1/patients', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${token}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      user: userId,
      dateOfBirth: '1970-05-15',
      medicalConditions: ['diabetes', 'hypertension'],
      medications: ['Metformin', 'Lisinopril'],
    }),
  });
  return response.json();
};

Getting Patient Details

const getPatientDetails = async (token, patientId) => {
  const response = await fetch(
    `https://api.picoshealth.com/v1/patients/${patientId}?depth=2`,
    {
      headers: { 'Authorization': `Bearer ${token}` },
    }
  );
  return response.json();
};

Overseers

Adding Overseer for Patient

const addOverseerForPatient = async (token, overseerUserId, patientId) => {
  const response = await fetch('https://api.picoshealth.com/v1/overseers', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${token}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      overseer: overseerUserId,
      patient: patientId,
      permissions: ['view_profile', 'approve_orders', 'view_transactions'],
      approvalRequired: true,
    }),
  });
  return response.json();
};

Getting Patient Overseers

const getPatientOverseers = async (token, patientId) => {
  const response = await fetch(
    `https://api.picoshealth.com/v1/overseers?where={"patient":{"equals":"${patientId}"}}`,
    {
      headers: { 'Authorization': `Bearer ${token}` },
    }
  );
  return response.json();
};

Last Updated: June 22, 2026