Getting several documents for a patient at a time

For requests or help with our API
Post Reply
mandmdiet
Posts: 116
Joined: Tue Aug 17, 2021 9:37 am

Getting several documents for a patient at a time

Post by mandmdiet » Mon Dec 04, 2023 12:35 pm

We have a use case where we want to perform some AI image processing on x-rays to create and attach additional metadata to an image. We have been looking at the API for pulling a patient's documents and have a few questions.

Here is the API in question: Documents POST DownloadSftp (https://www.opendental.com/site/apidocuments.html)

1. Is it possible to have a version of this API that will allow us to get all of a patient's documents at once?
2. Is it possible to have a version of this API that will allow us to get all of a patient's documents for a time range? For example, all documents in the past 3 weeks?
3. Are there any file size limits for this API?

Thanks

justine
Posts: 175
Joined: Tue Dec 28, 2021 7:59 am

Re: Getting several documents for a patient at a time

Post by justine » Mon Dec 04, 2023 2:25 pm

mandmdiet wrote:
Mon Dec 04, 2023 12:35 pm
We have a use case where we want to perform some AI image processing on x-rays to create and attach additional metadata to an image. We have been looking at the API for pulling a patient's documents and have a few questions.

Here is the API in question: Documents POST DownloadSftp (https://www.opendental.com/site/apidocuments.html)

1. Is it possible to have a version of this API that will allow us to get all of a patient's documents at once?
2. Is it possible to have a version of this API that will allow us to get all of a patient's documents for a time range? For example, all documents in the past 3 weeks?
3. Are there any file size limits for this API?

Thanks
Hello mandmdiet,
mandmdiet wrote:
Mon Dec 04, 2023 12:35 pm
1. Is it possible to have a version of this API that will allow us to get all of a patient's documents at once?
Not at this time. However, we can enhance documents GET to no longer require a PatNum, which would allow you get all documents data at once.
mandmdiet wrote:
Mon Dec 04, 2023 12:35 pm
2. Is it possible to have a version of this API that will allow us to get all of a patient's documents for a time range? For example, all documents in the past 3 weeks?
We can enhance documents GET to no longer require a PatNum. When doing this, we could add an optional DateCreated parameter. With both those filters, you could use documents GET to retrieve documents created on or after a specified date, for a specific patient. Or, only using DateCreated, you could get all documents created on or after a specified date, for all patients. After that, you would use documents POST DownloadSftp to get the documents by DocNum.
mandmdiet wrote:
Mon Dec 04, 2023 12:35 pm
3. Are there any file size limits for this API?
File size limits do not apply to documents POST DownloadSftp endpoint.

Thanks!

mandmdiet
Posts: 116
Joined: Tue Aug 17, 2021 9:37 am

Re: Getting several documents for a patient at a time

Post by mandmdiet » Mon Dec 04, 2023 2:31 pm

I am totally fine with looping through a list of documents from the GET API and pulling them one at a time, what I was concerned about is if the API traffic would be unacceptable to Open Dental. So, if you guys are OK with us looping through customers, grabbing their document meta data and then using that to grab all of their documents one at a time, and doing this for each patient for which we need these documents and for all practices we're connected to, then that is how we will handle this functionality for our application.

Post Reply