Luna SaludAPI ReferenceLuna Salud

Get a user's lab tests

GET/lab-tests

Retrieves a paginated list of lab tests for a specific patient with optional date filtering. Includes test metadata, provider information, and status details. Results can be filtered by date range and sorted by various criteria.

Code samples

Node.js

const fetch = require('node-fetch');

async function callApi() {
  const apiKey = 'YOUR_API_KEY';
  const patientId = 'your-patientId';
  const page = 'your-page';
  const limit = 'your-limit';
  const start_date = 'your-start_date';
  const end_date = 'your-end_date';

const queryString = new URLSearchParams({
    patientId: patientId,
    page: page,
    limit: limit,
    start_date: start_date,
    end_date: end_date
  }).toString();

  const url = `https://account.lunahealth.app/api/lab-tests` + (queryString ? `?${queryString}` : '');
  try {
    const response = await fetch(url, {
      method: 'GET',
      headers: {
        'Authorization': `Bearer ${apiKey}`,
        'Content-Type': 'application/json'
      }
    });
    
    if (!response.ok) {
      throw new Error(`API error: ${response.status}`);
    }
    
    const data = await response.json();
    console.log(data);
    return data;
  } catch (error) {
    console.error('Error calling API:', error);
    throw error;
  }
}

callApi();

Python

import requests

def call_api():
    api_key = 'YOUR_API_KEY'
    
    url = 'https://account.lunahealth.app/api/lab-tests'
    
    headers = {
        'Authorization': f'Bearer {api_key}',
        'Content-Type': 'application/json'
    }
    
    params = {
    'patientId': 'your-patientId',
    'page': 'your-page',
    'limit': 'your-limit',
    'start_date': 'your-start_date',
    'end_date': 'your-end_date'
    }
    
    try:
        response = requests.get(
            url,
            headers=headers,
            params=params
        )
        response.raise_for_status()
        
        data = response.json()
        print(data)
        return data
    except requests.exceptions.RequestException as e:
        print(f'Error calling API: {e}')
        raise

call_api()

Parameters

NameInTypeRequiredDescription
patientIdquerystringYesID of the patient to get lab tests for
pagequerynumberNo
limitquerynumberNo
start_datequerystringNo
end_datequerystringNo

Responses

StatusDescription
200Successful response
400Invalid input data
401Authorization not provided
403Insufficient access
404Not found
500Internal server error

200 — Successful response

Response fields

NameTypeRequiredDescription
itemsarray<object>Yes
metaobjectYes

Example response

{
  "items": [
    {
      "id": "string",
      "name": "string",
      "status": "string",
      "uploaded_at": "string",
      "file_count": 0,
      "biomarker_count": 0,
      "created_at": "string"
    }
  ],
  "meta": {
    "totalCount": 0,
    "currentPage": 0,
    "totalPages": 0
  }
}

400 — Invalid input data

Response fields

NameTypeRequiredDescription
messagestringYesThe error message
codestringYesThe error code
issuesarray<object>NoAn array of issues that were responsible for the error

Example response

{
  "code": "BAD_REQUEST",
  "message": "Invalid input data",
  "issues": []
}

401 — Authorization not provided

Response fields

NameTypeRequiredDescription
messagestringYesThe error message
codestringYesThe error code
issuesarray<object>NoAn array of issues that were responsible for the error

Example response

{
  "code": "UNAUTHORIZED",
  "message": "Authorization not provided",
  "issues": []
}

403 — Insufficient access

Response fields

NameTypeRequiredDescription
messagestringYesThe error message
codestringYesThe error code
issuesarray<object>NoAn array of issues that were responsible for the error

Example response

{
  "code": "FORBIDDEN",
  "message": "Insufficient access",
  "issues": []
}

404 — Not found

Response fields

NameTypeRequiredDescription
messagestringYesThe error message
codestringYesThe error code
issuesarray<object>NoAn array of issues that were responsible for the error

Example response

{
  "code": "NOT_FOUND",
  "message": "Not found",
  "issues": []
}

500 — Internal server error

Response fields

NameTypeRequiredDescription
messagestringYesThe error message
codestringYesThe error code
issuesarray<object>NoAn array of issues that were responsible for the error

Example response

{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "Internal server error",
  "issues": []
}