GlucoPilot Docs

Template by CloudCannon

Getting Started Edit

Welcome to our API.

This API document is designed for those interested in developing for our platform.

This API is still under development and will evolve.

You’ll succeed if you do this.

Here’s some useful information.

Something may not happen if you try and do this.

Something bad will happen if you do this.

Authentication Edit

You need to be authenticated for all API requests. You can generate an auth token by calling the /identity/v1/login endpoint with your email and password.

JWT tokens should be provided via HTTP Bearer authentication.

Authorization: Bearer YOUR_ACCESS_TOKEN

Nothing will work unless you include this API key

 curl http://api.myapp.com/api/v1/readings/ \
 -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Errors Edit

Code Name Description
200 OK Success
201 Created Creation Successful
400 Bad Request We could not process that action due to an invalid request
403 Forbidden We couldn’t authenticate you
404 Not Found The requested resource was not found
409 Conflict The requested resource is in conflict with the current state of the server
500 Internal Server Error An unexpected error occurred on the server

Errors will return JSON in the following format:

{
  "source": "string",
  "message": "string",
  "errorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "supportMessage": "string",
  "statusCode": 500,
  "messages": [
    "string",
    "string"
  ]
}

{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "errors": {
    "additionalProp1": [
      "string"
    ],
    "additionalProp2": [
      "string"
    ],
    "additionalProp3": [
      "string"
    ]
  },
  "additionalProp1": "string",
  "additionalProp2": "string",
  "additionalProp3": "string"
}

/api/v1/identity/register Edit

Register a new user

Parameters
email
User's email address
password
User's password
confirmPassword
User password confirmation
acceptedTerms
Whether the user has accepted the terms and conditions
patientId
User's patient ID

The user is regsitered

Registers a new user. If the patient ID is not provided, the user will be registered as a patient, oterwise as a care giver.

{
  "email": "user@example.com",
  "password": "string",
  "confirmPassword": "string",
  "acceptedTerms": true,
  "patientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "email": "string",
  "created": "2025-04-06T12:40:45.388Z",
  "updated": "2025-04-06T12:40:45.388Z",
  "acceptedTerms": true
}

{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "errors": {
    "additionalProp1": [
      "string"
    ],
    "additionalProp2": [
      "string"
    ],
    "additionalProp3": [
      "string"
    ]
  },
  "additionalProp1": "string",
  "additionalProp2": "string",
  "additionalProp3": "string"
}

{
  "source": "string",
  "message": "string",
  "errorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "supportMessage": "string",
  "statusCode": 0,
  "messages": [
    "string"
  ]
}

/api/v1/identity/login Edit

Authenticates a user

Parameters
email
User's email address
password
User's password

The user is logged in and a JWT token is returned

Authenticates a user, returning a JWT token if successful.

{
  "email": "string",
  "password": "string",
}

{
  "token": "string",
  "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "email": "string",
  "isVerified": true,
  "glucoseProvider": "None",
}

{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "errors": {
    "additionalProp1": [
      "string"
    ],
    "additionalProp2": [
      "string"
    ],
    "additionalProp3": [
      "string"
    ]
  },
  "additionalProp1": "string",
  "additionalProp2": "string",
  "additionalProp3": "string"
}

{
  "source": "string",
  "message": "string",
  "errorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "supportMessage": "string",
  "statusCode": 0,
  "messages": [
    "string"
  ]
}

/api/v1/identity/verify-email Edit

Verifies a user's email address

Parameters
token
The verification token sent to the user's email address

The user’s email address is verified using the provided token.

Verifies a user’s email address using the provided token.

curl http://api.myapp.com/api/v1/identity/verify-email?token=string

<h1>Success</h1>
<p>Your email has been verified.</p>

{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "errors": {
    "additionalProp1": [
      "string"
    ],
    "additionalProp2": [
      "string"
    ],
    "additionalProp3": [
      "string"
    ]
  },
  "additionalProp1": "string",
  "additionalProp2": "string",
  "additionalProp3": "string"
}

{
  "source": "string",
  "message": "string",
  "errorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "supportMessage": "string",
  "statusCode": 0,
  "messages": [
    "string"
  ]
}

/api/v1/identity/is-verified Edit

Determines whether a user is email verified

Parameters
token
The verification token sent to the user's email address

HTTP204 NoContent: The user’s email has been verified.

HTTP403 Forbidden: The user’s email has not been verified.

Indicates whether or not the requested user is email verified or not.

curl http://api.myapp.com/api/v1/identity/is-verified?email=string



{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "errors": {
    "additionalProp1": [
      "string"
    ],
    "additionalProp2": [
      "string"
    ],
    "additionalProp3": [
      "string"
    ]
  },
  "additionalProp1": "string",
  "additionalProp2": "string",
  "additionalProp3": "string"
}

{
  "source": "string",
  "message": "string",
  "errorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "supportMessage": "string",
  "statusCode": 0,
  "messages": [
    "string"
  ]
}

{
  "source": "string",
  "message": "string",
  "errorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "supportMessage": "string",
  "statusCode": 0,
  "messages": [
    "string"
  ]
}

/api/v1/librelink/login Edit

LibreLink Authenticate

Parameters
username
The username of the LibreLink Up user
password
The password of the LibreLink Up user

Authenticates GlucoPilot patient with LibreLink Up.

{
  "username": "string",
  "password": "string"
}

{
  "token": "string",
  "expires": 0,
  "duration": 0
}

{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "errors": {
    "additionalProp1": [
      "string"
    ],
    "additionalProp2": [
      "string"
    ],
    "additionalProp3": [
      "string"
    ]
  },
  "additionalProp1": "string",
  "additionalProp2": "string",
  "additionalProp3": "string"
}

{
  "source": "string",
  "message": "string",
  "errorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "supportMessage": "string",
  "statusCode": 0,
  "messages": [
    "string"
  ]
}

/api/v1/librelink/connections Edit

List connections

Lists all the users LibreLink connections.

curl http://api.myapp.com/api/v1/librelink/connections \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"

[
  {
    "patientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "firstName": "string",
    "lastName": "string"
  }
]

{
  "source": "string",
  "message": "string",
  "errorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "supportMessage": "string",
  "statusCode": 0,
  "messages": [
    "string"
  ]
}

/api/v1/librelink/pair Edit

Pair connection

Lists all the users LibreLink connections.

{
  "patientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "patientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "firstName": "string",
  "lastName": "string"
}

{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "errors": {
    "additionalProp1": [
      "string"
    ],
    "additionalProp2": [
      "string"
    ],
    "additionalProp3": [
      "string"
    ]
  },
  "additionalProp1": "string",
  "additionalProp2": "string",
  "additionalProp3": "string"
}

{
  "source": "string",
  "message": "string",
  "errorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "supportMessage": "string",
  "statusCode": 0,
  "messages": [
    "string"
  ]
}

/api/v1/ingredients Edit

List ingredients

Parameters
page
Page number to retrieve
pageSize
Number of ingredients to retrieve per page

Ingredients are ordered by date descending.

Paginates all ingredients.

curl http://api.myapp.com/api/v1/ingredients?Page=0&PageSize=10 \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "numberOfPages": 0,
  "ingredients": [
      {
          "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "name": "string",
          "carbs": 0,
          "protein": 0,
          "fat": 0,
          "calories": 0,
          "uom": "Unit",
          "created": "2025-04-12T20:13:22.207Z"
      }
  ]
}

{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "errors": {
    "additionalProp1": [
      "string"
    ],
    "additionalProp2": [
      "string"
    ],
    "additionalProp3": [
      "string"
    ]
  },
  "additionalProp1": "string",
  "additionalProp2": "string",
  "additionalProp3": "string"
}

{
  "source": "string",
  "message": "string",
  "errorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "supportMessage": "string",
  "statusCode": 0,
  "messages": [
    "string"
  ]
}

/api/v1/ingredients Edit

Add ingredient

Adds the ingredient with the given name.

{
  "name": "string",
  "carbs": 0,
  "protein": 0,
  "fat": 0,
  "calories": 0,
  "uom": "Unit"
}

  {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "created": "2025-04-12T20:26:31.607Z",
      "name": "string",
      "carbs": 0,
      "protein": 0,
      "fat": 0,
      "calories": 0,
      "uom": "Unit"
  }

{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "errors": {
    "additionalProp1": [
      "string"
    ],
    "additionalProp2": [
      "string"
    ],
    "additionalProp3": [
      "string"
    ]
  },
  "additionalProp1": "string",
  "additionalProp2": "string",
  "additionalProp3": "string"
}

{
  "source": "string",
  "message": "string",
  "errorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "supportMessage": "string",
  "statusCode": 0,
  "messages": [
    "string"
  ]
}

/api/v1/ingredients/:id Edit

Update ingredient

Parameters
id
The id of the updated ingredient

The ingredient for the given id.

{
  "name": "string",
  "carbs": 0,
  "protein": 0,
  "fat": 0,
  "calories": 0,
  "uom": "Unit"
}

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "string",
  "carbs": 0,
  "protein": 0,
  "fat": 0,
  "calories": 0,
  "uom": "Unit"
}

{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "errors": {
    "additionalProp1": [
      "string"
    ],
    "additionalProp2": [
      "string"
    ],
    "additionalProp3": [
      "string"
    ]
  },
  "additionalProp1": "string",
  "additionalProp2": "string",
  "additionalProp3": "string"
}

{
  "source": "string",
  "message": "string",
  "errorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "supportMessage": "string",
  "statusCode": 0,
  "messages": [
    "string"
  ]
}

/api/v1/ingredients/:id Edit

Remove ingredient

Parameters
id
Ingredient id
curl -X DELETE http://api.myapp.com/api/v1/ingredients/3fa85f64-5717-4562-b3fc-2c963f66afa6 \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"



{
  "source": "string",
  "message": "string",
  "errorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "supportMessage": "string",
  "statusCode": 0,
  "messages": [
    "string"
  ]
}

{
  "source": "string",
  "message": "string",
  "errorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "supportMessage": "string",
  "statusCode": 0,
  "messages": [
      "string"
  ]
}

/api/v1/injections Edit

List injections

Parameters
page
Page number to retrieve
pageSize
Number of injections to retrieve per page

Injections are ordered by date descending.

Paginates all injections.

curl http://api.myapp.com/api/v1/injections?Page=1&PageSize=1 \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "numberOfPages": 0,
  "injections": [
      {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "created": "2025-04-13T21:51:38.532Z",
      "insulinId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "insulinName": "string",
      "units": 0
      }
  ]
}

{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "errors": {
    "additionalProp1": [
      "string"
    ],
    "additionalProp2": [
      "string"
    ],
    "additionalProp3": [
      "string"
    ]
  },
  "additionalProp1": "string",
  "additionalProp2": "string",
  "additionalProp3": "string"
}

{
  "source": "string",
  "message": "string",
  "errorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "supportMessage": "string",
  "statusCode": 0,
  "messages": [
    "string"
  ]
}

/api/v1/injections Edit

Add injection

Adds the injection with the defined insulin and units.

{
  "insulinId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "units": 0,
  "created": "2025-04-15T16:23:33.110Z"
}

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "created": "2025-04-15T16:23:33.110Z",
  "insulinId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "units": 0
}

{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "errors": {
    "additionalProp1": [
      "string"
    ],
    "additionalProp2": [
      "string"
    ],
    "additionalProp3": [
      "string"
    ]
  },
  "additionalProp1": "string",
  "additionalProp2": "string",
  "additionalProp3": "string"
}

{
  "source": "string",
  "message": "string",
  "errorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "supportMessage": "string",
  "statusCode": 0,
  "messages": [
    "string"
  ]
}

/api/v1/injections/:id Edit

Get injection

Parameters
id
Injection id

The injection for the given id.

curl http://api.myapp.com/api/v1/injections/3fa85f64-5717-4562-b3fc-2c963f66afa6 \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "created": "2025-04-14T17:11:03.360Z",
  "insulinId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "insulinName": "string",
  "units": 0
}

{
  "source": "string",
  "message": "string",
  "errorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "supportMessage": "string",
  "statusCode": 0,
  "messages": [
    "string"
  ]
}

/api/v1/injections/:id Edit

Update injection

Parameters
id
The id of the updated injection

The injection for the given id.

{
  "insulinId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "units": 0,
  "type": "Bolus"
}

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "insulinId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "insulinName": "string",
  "units": 0
}

{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "errors": {
    "additionalProp1": [
      "string"
    ],
    "additionalProp2": [
      "string"
    ],
    "additionalProp3": [
      "string"
    ]
  },
  "additionalProp1": "string",
  "additionalProp2": "string",
  "additionalProp3": "string"
}

{
  "source": "string",
  "message": "string",
  "errorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "supportMessage": "string",
  "statusCode": 0,
  "messages": [
    "string"
  ]
}

/api/v1/injections/:id Edit

Remove injection

Parameters
id
Injection id
curl -X DELETE http://api.myapp.com/api/v1/injections/3fa85f64-5717-4562-b3fc-2c963f66afa6 \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"



{
  "source": "string",
  "message": "string",
  "errorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "supportMessage": "string",
  "statusCode": 0,
  "messages": [
    "string"
  ]
}

{
  "source": "string",
  "message": "string",
  "errorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "supportMessage": "string",
  "statusCode": 0,
  "messages": [
      "string"
  ]
}

/api/v1/insulins Edit

List insulins

Parameters
page
Page number to retrieve
pageSize
Number of insulins to retrieve per page

Insulins are ordered by date descending.

Paginates all insulins.

curl http://api.myapp.com/api/v1/insulins?Type=Bolus&Page=1&PageSize=1 \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "numberOfPages": 0,
  "insulins": [
      {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "string",
      "type": "Bolus",
      "duration": 0,
      "scale": 0,
      "peakTime": 0,
      "created": "2025-04-13T09:25:21.025Z"
      }
  ]
}

{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "errors": {
    "additionalProp1": [
      "string"
    ],
    "additionalProp2": [
      "string"
    ],
    "additionalProp3": [
      "string"
    ]
  },
  "additionalProp1": "string",
  "additionalProp2": "string",
  "additionalProp3": "string"
}

{
  "source": "string",
  "message": "string",
  "errorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "supportMessage": "string",
  "statusCode": 0,
  "messages": [
    "string"
  ]
}

/api/v1/insulins Edit

Add insulin

Adds the insulin with the given name.

{
  "name": "string",
  "type": "Bolus",
  "duration": 0,
  "scale": 0,
  "peakTime": 0
}

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "string",
  "type": "Bolus",
  "duration": 0,
  "scale": 0,
  "peakTime": 0,
  "created": "2025-04-13T09:21:35.406Z"
}

{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "errors": {
    "additionalProp1": [
      "string"
    ],
    "additionalProp2": [
      "string"
    ],
    "additionalProp3": [
      "string"
    ]
  },
  "additionalProp1": "string",
  "additionalProp2": "string",
  "additionalProp3": "string"
}

{
  "source": "string",
  "message": "string",
  "errorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "supportMessage": "string",
  "statusCode": 0,
  "messages": [
    "string"
  ]
}

/api/v1/insulins/:id Edit

Get insulin

Parameters
id
Insulin id

The insulin for the given id.

curl http://api.myapp.com/api/v1/insulins/3fa85f64-5717-4562-b3fc-2c963f66afa6 \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "string",
  "type": "Bolus",
  "duration": 0,
  "scale": 0,
  "peakTime": 0,
  "created": "2025-04-13T13:17:36.963Z"
}

{
  "source": "string",
  "message": "string",
  "errorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "supportMessage": "string",
  "statusCode": 0,
  "messages": [
    "string"
  ]
}

/api/v1/insulins/:id Edit

Update insulin

Parameters
id
The id of the updated insulin

The insulin for the given id.

{
  "name": "string",
  "type": "Bolus",
  "duration": 0,
  "scale": 0,
  "peakTime": 0
}

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "string",
  "type": "Bolus",
  "duration": 0,
  "scale": 0,
  "peakTime": 0
}

{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "errors": {
    "additionalProp1": [
      "string"
    ],
    "additionalProp2": [
      "string"
    ],
    "additionalProp3": [
      "string"
    ]
  },
  "additionalProp1": "string",
  "additionalProp2": "string",
  "additionalProp3": "string"
}

{
  "source": "string",
  "message": "string",
  "errorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "supportMessage": "string",
  "statusCode": 0,
  "messages": [
    "string"
  ]
}

/api/v1/insulins/:id Edit

Remove insulin

Parameters
id
Insulin id
curl -X DELETE http://api.myapp.com/api/v1/insulins/3fa85f64-5717-4562-b3fc-2c963f66afa6 \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"



{
  "source": "string",
  "message": "string",
  "errorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "supportMessage": "string",
  "statusCode": 0,
  "messages": [
    "string"
  ]
}

{
  "source": "string",
  "message": "string",
  "errorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "supportMessage": "string",
  "statusCode": 0,
  "messages": [
      "string"
  ]
}

/api/v1/meals Edit

List meals

Parameters
page
Page number to retrieve
pageSize
Number of meals to retrieve per page

Meals are ordered by date descending.

Paginates all meals.

curl http://api.myapp.com/api/v1/meals?page=0&pageSize=10 \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "numberOfPages": 0,
  "meals": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "string",
      "created": "2025-04-15T10:47:54.134Z",
      "totalCalories": 0,
      "totalCarbs": 0,
      "totalProtein": 0,
      "totalFat": 0,
      "mealIngredients": [
        {
          "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "ingredient": {
            "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "name": "string",
            "carbs": 0,
            "protein": 0,
            "fat": 0,
            "calories": 0,
            "uom": "Unit"
          },
          "quantity": 0
        }
      ]
    }
  ]
}

{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "errors": {
    "additionalProp1": [
      "string"
    ],
    "additionalProp2": [
      "string"
    ],
    "additionalProp3": [
      "string"
    ]
  },
  "additionalProp1": "string",
  "additionalProp2": "string",
  "additionalProp3": "string"
}

{
  "source": "string",
  "message": "string",
  "errorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "supportMessage": "string",
  "statusCode": 0,
  "messages": [
    "string"
  ]
}

/api/v1/meals Edit

Add meal

Parameters
name
Meal name
mealIngredients
Collection of meal ingredients

Adds the meal with the given name and ingredients.

{
  "name": "string",
  "mealIngredients": [
    {
      "ingredient": {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "name": "string",
        "carbs": 0,
        "protein": 0,
        "fat": 0,
        "calories": 0,
        "uom": "Unit"
      },
      "quantity": 0
    }
  ]
}

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "string"
}

{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "errors": {
    "additionalProp1": [
      "string"
    ],
    "additionalProp2": [
      "string"
    ],
    "additionalProp3": [
      "string"
    ]
  },
  "additionalProp1": "string",
  "additionalProp2": "string",
  "additionalProp3": "string"
}

{
  "source": "string",
  "message": "string",
  "errorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "supportMessage": "string",
  "statusCode": 0,
  "messages": [
    "string"
  ]
}

/api/v1/meals/:id Edit

Get meal

Parameters
id
Meal id

The meal for the given id.

curl http://api.myapp.com/api/v1/meals/3fa85f64-5717-4562-b3fc-2c963f66afa6 \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "string",
  "created": "2025-04-15T10:48:56.009Z",
  "totalCalories": 0,
  "totalCarbs": 0,
  "totalProtein": 0,
  "totalFat": 0,
  "mealIngredients": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "ingredient": {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "name": "string",
        "carbs": 0,
        "protein": 0,
        "fat": 0,
        "calories": 0,
        "uom": "Unit"
      },
      "quantity": 0
    }
  ]
}

{
  "source": "string",
  "message": "string",
  "errorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "supportMessage": "string",
  "statusCode": 0,
  "messages": [
    "string"
  ]
}

/api/v1/meals/:id Edit

Update meal

Parameters
id
The id of the updated meal

The meal for the given id.

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "string",
  "mealIngredients": [
    {
      "ingredient": {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "name": "string",
        "carbs": 0,
        "protein": 0,
        "fat": 0,
        "calories": 0,
        "uom": "Unit"
      },
      "quantity": 0
    }
  ]
}



{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "errors": {
    "additionalProp1": [
      "string"
    ],
    "additionalProp2": [
      "string"
    ],
    "additionalProp3": [
      "string"
    ]
  },
  "additionalProp1": "string",
  "additionalProp2": "string",
  "additionalProp3": "string"
}

{
  "source": "string",
  "message": "string",
  "errorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "supportMessage": "string",
  "statusCode": 0,
  "messages": [
    "string"
  ]
}

/api/v1/meals/:id Edit

Remove meal

Parameters
id
Meal id
curl -X DELETE http://api.myapp.com/api/v1/meals/3fa85f64-5717-4562-b3fc-2c963f66afa6 \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"



{
  "source": "string",
  "message": "string",
  "errorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "supportMessage": "string",
  "statusCode": 0,
  "messages": [
    "string"
  ]
}

{
  "source": "string",
  "message": "string",
  "errorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "supportMessage": "string",
  "statusCode": 0,
  "messages": [
      "string"
  ]
}

/api/v1/readings Edit

List readings

Parameters
from
Date and time to retrieve readings from
to
Date and time to retrieve readings to

The from and to parameters are inclusive.

Lists all the readings between the specified dates, ordered by date descending.

curl http://api.myapp.com/api/v1/readings \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"

[
  {
    "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "created": "2025-04-06T14:39:00.848Z",
    "glucoseLevel": 0,
    "direction": "Decrease"
  }
]

{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "errors": {
    "additionalProp1": [
      "string"
    ],
    "additionalProp2": [
      "string"
    ],
    "additionalProp3": [
      "string"
    ]
  },
  "additionalProp1": "string",
  "additionalProp2": "string",
  "additionalProp3": "string"
}

{
  "source": "string",
  "message": "string",
  "errorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "supportMessage": "string",
  "statusCode": 0,
  "messages": [
    "string"
  ]
}

/api/v1/readings Edit

Add reading

Parameters
created
Date and time the reading was taken
glucoseLevel
Glucose level in mg/dL

The reading will be added to your account.

Adds a manual glucose reading to your account.

{
  "created": "2025-04-07T21:07:36.719Z",
  "glucoseLevel": 0
}

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "errors": {
    "additionalProp1": [
      "string"
    ],
    "additionalProp2": [
      "string"
    ],
    "additionalProp3": [
      "string"
    ]
  },
  "additionalProp1": "string",
  "additionalProp2": "string",
  "additionalProp3": "string"
}

{
  "source": "string",
  "message": "string",
  "errorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "supportMessage": "string",
  "statusCode": 0,
  "messages": [
    "string"
  ]
}

/api/v1/sensors Edit

List sensors

Parameters
page
Page number to retrieve
pageSize
Number of sensors to retrieve per page

Sensors are ordered by date descending.

Paginates all sensors.

curl http://api.myapp.com/api/v1/sensors?Page=0&PageSize=10 \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "numberOfPages": 0,
  "sensors": [
      {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "sensorId": "string",
      "started": "2025-04-17T13:29:21.120Z",
      "expires": "2025-04-17T13:29:21.120Z"
      }
  ]
}

{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "errors": {
    "additionalProp1": [
      "string"
    ],
    "additionalProp2": [
      "string"
    ],
    "additionalProp3": [
      "string"
    ]
  },
  "additionalProp1": "string",
  "additionalProp2": "string",
  "additionalProp3": "string"
}

{
  "source": "string",
  "message": "string",
  "errorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "supportMessage": "string",
  "statusCode": 0,
  "messages": [
    "string"
  ]
}

/api/v1/sensors/:id Edit

Remove sensor

Parameters
id
Sensor id
curl -X DELETE http://api.myapp.com/api/v1/sensors/3fa85f64-5717-4562-b3fc-2c963f66afa6 \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"



{
  "source": "string",
  "message": "string",
  "errorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "supportMessage": "string",
  "statusCode": 0,
  "messages": [
    "string"
  ]
}

{
  "source": "string",
  "message": "string",
  "errorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "supportMessage": "string",
  "statusCode": 0,
  "messages": [
      "string"
  ]
}